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
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.