Update allowedValue

Espace de noms: microsoft.graph

Important

Les API sous la /beta version de Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur de version .

Met à jour les propriétés d’un objet allowedValue.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) CustomSecAttributeDefinition.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application CustomSecAttributeDefinition.ReadWrite.All

Le rôle d’annuaire Administrateur de définition d’attribut doit également être attribué à l’utilisateur. Par défaut, l’administrateur général et les autres rôles d’administrateur ne sont pas autorisés à lire, définir ou attribuer des attributs de sécurité personnalisés.

Requête HTTP

PATCH /directory/customSecurityAttributeDefinitions/{customSecurityAttributeDefinitionId}/allowedValues/{allowedValueId}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés qui doivent être mises à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Propriété Type Description
isActive Boolean Indique si la valeur prédéfinue est active ou désactivée. Si elle est définie sur , cette valeur prédéfinie ne peut pas être affectée à d’autres objets false d’annuaire pris en charge. Facultatif.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.

Exemples

Exemple : Désactiver une valeur prédéfinë

L’exemple suivant désactive une valeur prédéfinée pour une définition d’attribut de sécurité personnalisée.

  • Jeu d’attributs : Engineering
  • Attribut : Project
  • Valeur prédéfinë : Alpine

Demande

PATCH https://graph.microsoft.com/beta/directory/customSecurityAttributeDefinitions/Engineering_Project/allowedValues/Alpine
Content-Type: application/json
Content-length: 80

{
    "isActive": "false"
}

Réponse

HTTP/1.1 204 No Content