Copiar um DriveItem

Artigo
04/08/2023

Cria uma cópia de forma assíncrona de um driveItem (incluindo os filhos), em um novo item pai ou com um novo nome.

Permissões

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Files.ReadWrite, Files.ReadWrite.All
Aplicativo	Files.ReadWrite.All, Sites.ReadWrite.All

Solicitação HTTP

POST /drives/{driveId}/items/{itemId}/copy
POST /groups/{groupId}/drive/items/{itemId}/copy
POST /me/drive/items/{item-id}/copy
POST /sites/{siteId}/drive/items/{itemId}/copy
POST /users/{userId}/drive/items/{itemId}/copy

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Nome	Valor	Descrição
parentReference	ItemReference	Opcional. Referência ao item pai em que a cópia será criada.
name	string	Opcional. O novo nome para a cópia. Se isso não for fornecido, será usado o mesmo nome que o original.

Observação:parentReference deve incluir os parâmetros driveId e id para a pasta de destino.

Exemplo

Este exemplo copia um arquivo identificado por {item-id} em uma pasta identificada por um valor driveId e id. A nova cópia do arquivo será nomeada contoso plan (copy).txt.

POST /me/drive/items/{item-id}/copy
Content-Type: application/json

{
  "parentReference": {
    "driveId": "6F7D00BF-FC4D-4E62-9769-6AEA81F3A21B",
    "id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F"
  },
  "name": "contoso plan (copy).txt"
}

Resposta

Retorna detalhes sobre como monitorar o progresso da cópia após aceitar a solicitação.

HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

O valor do cabeçalho Location fornece uma URL para um serviço que irá retornar o estado atual da operação de cópia. Você pode usar essas informações para determinar quando a cópia terminou.

Comentários

Em muitos casos, a ação de copiar é executada de forma assíncrona. A resposta da API só indicará que a operação de cópia foi aceita ou rejeitada, por exemplo, porque o nome de arquivo de destino já está sendo utilizado.

Compartilhar via