Excluir um DriveItem

Artigo
04/08/2023

Excluir um DriveItem usando sua ID ou seu caminho. Observe que a exclusão de itens usando esse método moverá os itens para a Lixeira, ao invés de excluir permanentemente o 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

DELETE /drives/{drive-id}/items/{item-id}
DELETE /groups/{group-id}/drive/items/{item-id}
DELETE /me/drive/items/{item-id}
DELETE /sites/{siteId}/drive/items/{itemId}
DELETE /users/{userId}/drive/items/{itemId}

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 não corresponder à marca atual no item, uma resposta `412 Precondition Failed` é exibida e o item não será excluído.

Exemplo

Eis um exemplo de como chamar esta API.

DELETE /me/drive/items/{item-id}

Resposta

Se bem sucedida, esta chamada retorna uma resposta 204 No Content para indicar que o recurso foi excluído e que não havia nada a retornar.

HTTP/1.1 204 No Content

Respostas de erros

Confira mais informações sobre como os erros são retornados em Respostas de Erros.

Compartilhar via