Atualizar propriedades de DriveItem

  • Artigo

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.

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

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 opcionais

Nome Tipo Descrição
if-match String Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à eTag atual da pasta, uma resposta 412 Precondition Failed será exibida.

Corpo da solicitação

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

Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter melhor desempenho, seu aplicativo não deve incluir propriedades que não tenham sido 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 /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.