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 usuário, que adiciona essa permissão a um fileStorageContainerType. Somente proprietários existentes (usuários com a owner função na coleção de permissões do tipo de contêiner), Administradores do SharePoint Embedded ou Administradores Globais podem adicionar permissões.

As seguintes restrições se aplicam:

  • É permitido um máximo de três permissões por tipo de contêiner. Adicionar uma quarta permissão retorna um 400 Bad Request erro.
  • As permissões duplicadas são tratadas como idempotentes. Se o usuário especificado já tiver uma permissão no tipo de contêiner, o serviço não fará alterações e retornará o recurso de permissão existente no corpo da resposta com um 201 Created status, mesmo que nenhuma nova permissão seja criada.
  • Atualmente, apenas a owner função tem suporte.

Observação

  • Os usuários convidados não podem ser destinatários de permissões de tipo de contêiner.
  • Usuários convidados não podem realizar esta operação.

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ão com privilégios mínimos Permissões com privilégios mais elevados
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 da solicitação, forneça uma representação JSON do objeto de permissão .

Você pode especificar as propriedades a seguir ao criar uma permissão.

Propriedade Tipo Descrição
grantedToV2 sharePointIdentitySet A identidade do usuário ao qual conceder a permissão. Há suporte apenas para a propriedade user com a ID do usuário; Não há suporte para identidades de grupo e de aplicativo. Obrigatório.
funções Coleção de cadeias de caracteres As funções concedidas ao usuário. No momento, apenas owner é suportado. Obrigatório.

Resposta

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

Se a solicitação exceder o limite de três permissões por tipo de contêiner, esse método retornará um 400 Bad Request código de resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação para adicionar uma permissão de proprietário a um tipo de contêiner.

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"
    }
  }
}