Excluir uma permissão de compartilhamento de um arquivo ou pasta

  • Artigo

Remova o acesso a um DriveItem.

Somente as permissões de compartilhamento não herdadas podem ser excluídas. A propriedade inheritedFrom deve ser null.

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}/permissions/{perm-id}
DELETE /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /me/drive/items/{item-id}/permissions/{perm-id}
DELETE /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
DELETE /users/{user-id}/drive/items/{item-id}/permissions/{perm-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 não corresponder à marca atual no item, uma resposta 412 Precondition Failed é exibida e o item não será excluído.

Resposta

Se bem sucedido, este método retorna um código de resposta 204 No Content.

Exemplo

Este exemplo remove a permissão identificada como {perm-id} de {item-id} do item no OneDrive do usuário atual.

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

Resposta

HTTP/1.1 204 No Content

Comentários

  • Drives com driveType de personal (OneDrive Pessoal) não podem criar ou alterar as permissões no DriveItem raiz.