permissão: revokeGrants

Namespace: microsoft.graph

Revogue o acesso a um listItem ou driveItem concedido por meio de um link de compartilhamento removendo as entradas driveRecipient especificadas do link.

Os destinatários que já resgataram o link e os destinatários que receberam apenas um convite perdem o acesso. A revogação de uma concessão remove o destinatário apenas desse link de compartilhamento; Ele não remove nenhum acesso que o destinatário tenha por meio de um link de compartilhamento diferente, uma concessão direta ou associação a um grupo que tenha acesso.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Solicitação HTTP

POST /drives/{drive-id}/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /me/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants
POST /sites/{site-id}/lists/{list-id}/items/{listItem-id}/driveItem/permissions/{perm-id}/revokeGrants
POST /users/{user-id}/drive/items/{item-id}/permissions/{perm-id}/revokeGrants

Cabeçalhos de solicitação

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.

Resposta

Se for bem-sucedida, essa ação retornará um 200 OK código de resposta e uma permissão no corpo da resposta que representa o estado atualizado do link de compartilhamento.

A propriedade grantedToIdentitiesV2 da permissão retornada lista os destinatários no link depois que as concessões especificadas são revogadas.

Essa ação se aplica somente ao compartilhamento de links. Não pode ser usado para revogar uma concessão direta de um item; em vez disso, use a permissão Excluir . Fornecer o identificador de uma permissão que não é um link de compartilhamento retorna um 400 Bad Request código de resposta.

O link de compartilhamento deve ter como escopo usuários específicos. Links cujo escopo é anonymous ou organization não acompanham beneficiários individuais. Como esses links não têm concessões individuais a serem revogadas, a solicitação retorna um código de 400 Bad Request resposta.

Para obter mais informações sobre como os erros são retornados, consulte Tipos de recursos e respostas de erro do Microsoft Graph.

Exemplos

Solicitação

O exemplo a seguir mostra como revogar o acesso de um único usuário em um link de compartilhamento.

POST https://graph.microsoft.com/v1.0/me/drive/items/016GVDAP3RCQS5VBQHORFIVU2ZMOSBL25U/permissions/2687a7e0-1b4d-4656-ae32-a4ea393321e1/revokeGrants
Content-Type: application/json

{
  "grantees": [
    {
      "email": "ryan@contoso.com"
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
  "id": "2687a7e0-1b4d-4656-ae32-a4ea393321e1",
  "roles": ["write"],
  "grantedToIdentitiesV2": [
    {
      "user": {
        "id": "e6842c7e-33a1-4207-8b5a-2710922ac2b2",
        "displayName": "Megan Bowen"
      },
      "siteUser": {
        "id": "12",
        "displayName": "Megan Bowen",
        "loginName": "Megan Bowen"
      }
    }
  ],
  "link": {
    "type": "edit",
    "scope": "users",
    "webUrl": "https://contoso-my.sharepoint.com/personal/ellen_contoso_com/..."
  }
}