mailFolder: movemailFolder: move

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Mueve un objeto mailfolder y su contenido a otro objeto mailfolder.Move a mailfolder and its contents to another mailfolder.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Mail.ReadWriteMail.ReadWrite
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) Mail.ReadWriteMail.ReadWrite
AplicaciónApplication Mail.ReadWriteMail.ReadWrite

Solicitud HTTPHTTP request

POST /me/mailFolders/{id}/move
POST /users/{id | userPrincipalName}/mailFolders/{id}/move

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Bearer {token}.Bearer {token}. Obligatorio.Required.
Content-TypeContent-Type application/json.application/json. Obligatorio.Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.In the request body, provide a JSON object with the following parameters.

ParámetroParameter TipoType DescripciónDescription
destinationIddestinationId StringString El identificador de la carpeta o un nombre de carpeta conocido.The folder ID, or a well-known folder name. Para obtener una lista de los nombres de carpeta conocidos compatibles, vea Tipo de recurso mailFolder.For a list of supported well-known folder names, see mailFolder resource type.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve 200 OK un código de respuesta y un recurso mailFolder en el cuerpo de la respuesta.If successful, this method returns 200 OK response code and a mailFolder resource in the response body.

EjemploExample

Aquí tiene un ejemplo de cómo llamar a esta API.Here is an example of how to call this API.

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/me/mailFolders/{id}/move
Content-type: application/json
Content-length: 44

{
  "destinationId": "destinationId-value"
}
RespuestaResponse

Aquí tiene un ejemplo de la respuesta.Here is an example of the response.

Nota: se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.Note: The response object shown here might be shortened for readability. Se devolverán todas las propiedades de una llamada real.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 179

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value",
  "childFolderCount": 99,
  "unreadItemCount": 99,
  "totalItemCount": 99,
  "id": "id-value"
}