Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso
Permisos con privilegios mínimos
Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)
CustomSecAttributeDefinition.ReadWrite.All
No disponible.
Delegado (cuenta personal de Microsoft)
No admitida.
No admitida.
Aplicación
CustomSecAttributeDefinition.ReadWrite.All
No disponible.
Importante
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido.
El administrador de definición de atributos es el único rol con privilegios admitido para esta operación.
De forma predeterminada, el administrador global y otros roles de administrador no tienen permisos para leer, definir ni asignar atributos de seguridad personalizados.
En el cuerpo de la solicitud, proporcione una representación JSON del objeto attributeSet .
En la tabla siguiente se muestran las propiedades que puede configurar al crear un attributeSet.
Propiedad
Tipo
Descripción
description
Cadena
Descripción del conjunto de atributos. Puede tener hasta 128 caracteres e incluir caracteres Unicode. Se puede cambiar más adelante. Opcional.
id
Cadena
Identificador del conjunto de atributos que es único dentro de un inquilino. Puede tener hasta 32 caracteres e incluir caracteres Unicode. No puede contener espacios ni caracteres especiales. No se puede cambiar más adelante. Distingue mayúsculas de minúsculas. Obligatorio.
maxAttributesPerSet
Int32
Número máximo de atributos de seguridad personalizados que se pueden definir en este conjunto de atributos. El valor predeterminado es null. Si no se especifica, el administrador puede agregar hasta el máximo de 500 atributos activos por inquilino. Se puede cambiar más adelante. Opcional.
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto attributeSet en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se agrega un nuevo conjunto de atributos denominado Engineering.
POST https://graph.microsoft.com/v1.0/directory/attributeSets
Content-Type: application/json
{
"id":"Engineering",
"description":"Attributes for engineering team",
"maxAttributesPerSet":25
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new AttributeSet
{
Id = "Engineering",
Description = "Attributes for engineering team",
MaxAttributesPerSet = 25,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Directory.AttributeSets.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewAttributeSet()
id := "Engineering"
requestBody.SetId(&id)
description := "Attributes for engineering team"
requestBody.SetDescription(&description)
maxAttributesPerSet := int32(25)
requestBody.SetMaxAttributesPerSet(&maxAttributesPerSet)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
attributeSets, err := graphClient.Directory().AttributeSets().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
AttributeSet attributeSet = new AttributeSet();
attributeSet.setId("Engineering");
attributeSet.setDescription("Attributes for engineering team");
attributeSet.setMaxAttributesPerSet(25);
AttributeSet result = graphClient.directory().attributeSets().post(attributeSet);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\AttributeSet;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new AttributeSet();
$requestBody->setId('Engineering');
$requestBody->setDescription('Attributes for engineering team');
$requestBody->setMaxAttributesPerSet(25);
$result = $graphServiceClient->directory()->attributeSets()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.attribute_set import AttributeSet
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AttributeSet(
id = "Engineering",
description = "Attributes for engineering team",
max_attributes_per_set = 25,
)
result = await graph_client.directory.attribute_sets.post(request_body)