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 nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas 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 privilegiadas mais altas |
---|---|---|
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 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. |
Corpo da solicitação
No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados.
Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter um melhor desempenho, não inclua valores existentes que não foram alterados.
As propriedades a seguir nesses tipos de permissão podem ser modificadas.
Tipo de permissão | Propriedade | Tipo | Descrição |
---|
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|
Comentários
Modificações de permissão sem suporte incluem o seguinte:
- Links de compartilhamento organizacional
- Pessoas links de compartilhamento
Resposta
Se bem sucedido, este método retorna um código de resposta 200 OK
e um objeto permission atualizado no corpo da resposta.
Exemplo
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
Se for bem-sucedido, esse método retornará um recurso Permission no corpo da resposta que representa o estado atualizado da permissão.
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.