Compartilhar via


Atualizar propriedades de DriveItem

Namespace: microsoft.graph

Atualize os metadados de um driveItem por ID ou caminho.

Também é possível usar a atualização para mover um item para outro pai ao atualizar a propriedade parentReference do item.

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

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

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.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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

Observação

O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

Solicitação HTTP

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

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.
if-match Cadeia de caracteres. Se este cabeçalho de pedido estiver incluído e a eTag (ou cTag) fornecida não corresponder à eTag atual na pasta, é devolvida uma 412 Precondition Failed resposta.

Corpo da solicitação

No corpo da solicitação, forneça os valores para as propriedades que devem ser atualizadas.

As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade. Para um melhor desempenho, a sua aplicação não deve incluir propriedades que não foram alteradas.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e o recurso DriveItem atualizado no corpo da resposta.

Exemplo

Este exemplo renomeia o recurso DriveItem como "new-file-name.docx".

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{item-id}
Content-type: application/json

{
  "name": "new-file-name.docx"
}

Resposta

Se tiver êxito, esse método retornará um recurso driveItemno corpo da resposta.

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

{
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "name": "new-file-name.docx",
  "file": { }
}

Respostas de erros

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