Criar attributeSet
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 novo objeto attributeSet .
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) | CustomSecAttributeDefinition.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Application | CustomSecAttributeDefinition.ReadWrite.All | Indisponível. |
Importante
Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. O Administrador de Definição de Atributos é a única função com privilégios suportada para esta operação.
Por predefinição, o Administrador Global e outras funções de administrador não têm permissões para ler, definir ou atribuir atributos de segurança personalizados.
Solicitação HTTP
POST /directory/attributeSets
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 attributeSet .
A tabela seguinte mostra as propriedades que pode configurar quando cria um attributeSet.
Propriedade | Tipo | Descrição |
---|---|---|
description | Cadeia de caracteres | Descrição do conjunto de atributos. Pode ter até 128 carateres e incluir carateres Unicode. Pode ser alterado mais tarde. Opcional. |
id | Cadeia de caracteres | Identificador do conjunto de atributos que é exclusivo num inquilino. Pode ter até 32 carateres de comprimento e incluir carateres Unicode. Não é possível conter espaços ou carateres especiais. Não pode ser alterado mais tarde. Sensível às maiúsculas e minúsculas. Obrigatório. |
maxAttributesPerSet | Int32 | Número máximo de atributos de segurança personalizados que podem ser definidos neste conjunto de atributos. O valor padrão é null . Se não for especificado, o administrador pode adicionar até ao máximo de 500 atributos ativos por inquilino. Pode ser alterado mais tarde. Opcional. |
Resposta
Se for bem-sucedido, este método devolve um 201 Created
código de resposta e um objeto attributeSet no corpo da resposta.
Exemplos
Solicitação
O exemplo seguinte adiciona um novo conjunto de atributos com o nome Engineering
.
POST https://graph.microsoft.com/beta/directory/attributeSets
Content-Type: application/json
{
"id":"Engineering",
"description":"Attributes for engineering team",
"maxAttributesPerSet":25
}
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#directory/attributeSets/$entity",
"description": "Attributes for engineering team",
"id": "Engineering",
"maxAttributesPerSet": 25
}