Compartilhar via


driveItem: copiar

Namespace: microsoft.graph

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

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
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

Parâmetros de consulta opcionais

Esse método dá suporte ao @microsoft.graph.conflictBehavior parâmetro de consulta para personalizar o comportamento quando ocorre um conflito.

Valor Descrição
fail O comportamento padrão é relatar a falha.
replace Substitua o item existente no site de destino.
rename Renomeie o item.

Nota: O conflictBehavior não tem suporte para o OneDrive Consumer.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

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.

Resposta

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

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.

Solicitação

POST https://graph.microsoft.com/v1.0/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

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 tiver sido concluída.

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, devido ao nome do arquivo de destino já estar em uso.