Atualizar a permissão de compartilhamento

Namespace: microsoft.graph

Atualiza as propriedades de permissão de compartilhamento pela correção do recurso de permissão.

Somente a propriedade roles pode ser modificada dessa forma.

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

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

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.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
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}/permissions/{perm-id}
PATCH /groups/{group-id}/drive/items/{item-id}/permissions/{perm-id}
PATCH /me/drive/items/{item-id}/permissions/{perm-id}
PATCH /sites/{site-id}/drive/items/{item-id}/permissions/{perm-id}
PATCH /users/{user-id}/drive/items/{item-id}/permissions/{perm-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 esse cabeçalho de solicitação estiver incluído e a eTag (ou cTag) fornecida não corresponder à marca atual no item, uma 412 Precondition Failed resposta será retornada e o item não será excluído.

Corpo da solicitação

No corpo da solicitação, forneça os valores dos campos relevantes a serem atualizados.

As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.

A tabela a seguir lista as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
funções Coleção de cadeias de caracteres O tipo de permissão. Os valores possíveis são read, write e owner.

Não há suporte para os seguintes tipos de modificações de permissão:

  • Links de compartilhamento organizacional
  • People sharing links

Resposta

Se bem sucedido, este método retorna um código de resposta 200 OK e um objeto permission atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação que altera a função na permissão de compartilhamento para somente leitura.

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/permissions/{perm-id}
Content-type: application/json

{
  "roles": [ "read" ]
}

Resposta

O exemplo a seguir mostra a resposta.

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

{
  "@deprecated.GrantedTo": "GrantedTo has been deprecated. Refer to GrantedToV2",
  "grantedTo": {
    "user": {
      "displayName": "Robin Danielsen",
      "id": "efee1b77-fb3b-4f65-99d6-274c11914d12"
    }
  },
  "grantedToV2": {
    "user": {
      "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
      "displayName": "Robin Danielsen"
    },
    "siteUser": {
      "id": "1",
      "displayName": "Robin Danielsen",
      "loginName": "Robin Danielsen"
    }
  },
  "id": "1",
  "roles": [ "read" ]
}

Respostas de erro

Leia o tópico Respostas de Erro para obter mais informações sobre como os erros são retornados.