Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.