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.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
---|---|---|
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 do pedido, forneça os valores para que os campos relevantes sejam atualizados.
As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade. Para alcançar o melhor desempenho, não inclua valores existentes que não foram alterados.
A tabela seguinte 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 . |
Os seguintes tipos de modificações de permissão não são suportados:
- Ligações de partilha organizacional
- Pessoas ligações de partilha
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 seguinte mostra um pedido que altera a função na permissão de partilha para só de 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.