Compartilhar via

Criar permissão para um fileStorageContainerType

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Crie um objeto de permissão de utilizador, que adiciona esta permissão a um fileStorageContainerType. Apenas os proprietários existentes (utilizadores com a owner função na coleção de permissões do tipo de contentor), Administradores Incorporados do SharePoint ou Administradores Globais podem adicionar permissões.

Aplicam-se as seguintes restrições:

  • É permitido um máximo de 3 permissões por tipo de contentor. Adicionar uma quarta permissão devolve um 400 Bad Request erro.
  • As permissões duplicadas são tratadas como idempotentes. Se o utilizador especificado já tiver uma permissão no tipo de contentor, o serviço não efetua alterações e devolve o recurso de permissão existente no corpo da resposta com um 201 Created status, mesmo que não seja criada nenhuma nova permissão.
  • Atualmente, apenas a owner função é suportada.

Observação

  • Os utilizadores convidados não podem ser destinatários de permissões de tipo de contentor.
  • Os utilizadores convidados não podem efetuar esta operação.

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ão com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) FileStorageContainerType.Manage.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /storage/fileStorage/containerTypes/{fileStorageContainerTypeId}/permissions

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.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto de permissão .

Pode especificar as seguintes propriedades quando criar uma permissão.

Propriedade Tipo Descrição
grantedToV2 sharePointIdentitySet A identidade do utilizador a quem conceder permissão. Só é suportada a propriedade do utilizador com o ID do utilizador; as identidades do grupo e da aplicação não são suportadas. Obrigatório.
funções Coleção de cadeias de caracteres As funções concedidas ao utilizador. Atualmente, só owner é suportado. Obrigatório.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto de permissão no corpo da resposta.

Se o pedido exceder o limite de três permissões por tipo de contentor, este método devolve um 400 Bad Request código de resposta.

Exemplos

Solicitação

O exemplo seguinte mostra um pedido para adicionar uma permissão de proprietário a um tipo de contentor.

POST https://graph.microsoft.com/beta/storage/fileStorage/containerTypes/de988700-d700-020e-0a00-0831f3042f00/permissions
Content-Type: application/json

{
  "roles": ["owner"],
  "grantedToV2": {
    "user": {
      "id": "11111111-1111-1111-1111-111111111111"
    }
  }
}

Resposta

O exemplo a seguir mostra a resposta.

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.permission",
  "id": "b3duZXJfMTExMTExMTEtMTExMS0xMTExLTExMTEtMTExMTExMTExMTEx",
  "roles": ["owner"],
  "grantedToV2": {
    "user": {
      "id": "11111111-1111-1111-1111-111111111111"
    }
  }
}
  • Last updated on