Share via

Carregar ou substituir o conteúdo de um driveItem

  • Artigo

Namespace: microsoft.graph

Forneça o conteúdo de um novo arquivo ou atualize o conteúdo de um arquivo existente em uma única chamada de API. Esse método só dá suporte a arquivos de até 250 MB de tamanho.

Para carregar arquivos grandes, consulte Carregar arquivos grandes com uma sessão de upload.

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

Para substituir um item existente

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

Para carregar um novo arquivo

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drive/items/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

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 text/plain. Obrigatório.

Corpo da solicitação

O conteúdo do corpo da solicitação deve ser o fluxo binário do arquivo a ser carregado.

Resposta

Se for bem-sucedido, este método retornará um objeto driveItem no corpo da resposta para o arquivo recém-criado ou atualizado.

Exemplo (carregar um novo arquivo)

Este exemplo carrega a cadeia de caracteres "O conteúdo do arquivo vai aqui" para um arquivo na unidade do usuário conectado em FolderA chamado FileB.txt.

PUT https://graph.microsoft.com/v1.0/me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

Resposta

Se for bem-sucedido, esse método retornará um recurso driveItem no corpo da resposta para o arquivo recém-criado.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Exemplo (atualizando um arquivo existente)

Este exemplo substitui o conteúdo de um arquivo com uma ID conhecida.

PUT https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

Resposta

Se for bem-sucedido, esse método retornará um recurso driveItem no corpo da resposta para o arquivo recém-criado.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Respostas de erros

Confira Respostas de erro para saber mais detalhes sobre como os erros retornam.