Carregar ou substituir o conteúdo de um driveItem

Namespace: microsoft.graph

Forneça o conteúdo de um novo ficheiro ou atualize o conteúdo de um ficheiro existente numa única chamada à API. Este método só suporta ficheiros com um tamanho máximo de 250 MB.

Para carregar ficheiros grandes, veja Carregar ficheiros grandes com uma sessão de carregamento.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

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 ficheiro

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

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 "O conteúdo do ficheiro vai para aqui" para um ficheiro na unidade do utilizador com sessão iniciada em PastaA com o nome 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.

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = The contents of the file goes here.;

await client.api('/me/drive/items/{item-id}/content')
	.put(stream);

Import-Module Microsoft.Graph.Files

$params = The contents of the file goes here.


Set-MgDriveItemContent -DriveId $driveId -DriveItemId $driveItemId -BodyParameter $params

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.