group : validateProperties

  • Article

Espace de noms: microsoft.graph

Validez que le nom d’affichage d’un groupe Microsoft 365 ou surnom d’un courrier est conforme aux stratégies de noms. Les clients peuvent utiliser cette API pour déterminer si un nom d’affichage ou un surnom de messagerie est valide avant d’essayer de mettre à jour un groupe Microsoft 365. Pour valider les propriétés avant de créer un groupe, utilisez la fonction directoryobject :validateProperties .

Les validations de stratégie suivantes sont effectuées pour les propriétés de nom d’affichage et de surnom de messagerie :

  1. Valider la stratégie de nommage de préfixe et de suffixe
  2. Valider la stratégie personnalisée des mots interdits

Cette API retourne uniquement le premier échec de validation rencontré. Si les propriétés échouent à plusieurs validations, seul le premier échec de validation est retourné. Toutefois, vous pouvez valider à la fois le surnom du courrier et le nom d’affichage et recevoir une collection d’erreurs de validation si vous validez uniquement le préfixe et la stratégie de nommage de suffixe. Pour en savoir plus sur la configuration des stratégies de nommage, consultez Configurer la stratégie de nommage.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ✅ ✅ ✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Group.Read.All Group.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Group.Read.All Group.ReadWrite.All

Requête HTTP

POST /groups/{id}/validateProperties

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Content-Type application/json

Corps de la demande

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.

Paramètre Type Description
displayName Chaîne Nom complet du groupe à valider. La propriété n’est pas requise individuellement. Toutefois, au moins une propriété (displayName ou mailNickname) est requise.
mailNickname Chaîne Surnom de messagerie du groupe à valider. La propriété n’est pas requise individuellement. Toutefois, au moins une propriété (displayName ou mailNickname) est requise.
onBehalfOfUserId Guid ID de l’utilisateur à emprunter lors de l’appel de l’API. Les résultats de validation concernent les attributs et les rôles de l’onBehalfOfUserId .

Réponse

Si elle réussit et qu’il n’y a pas d’erreur de validation, la méthode retourne 204 No Content le code de réponse. Il ne retourne rien dans le corps de la réponse.

Si la requête n’est pas valide, la méthode retourne 400 Bad Request le code de réponse. Un message d’erreur contenant des détails sur la requête non valide est retourné dans le corps de la réponse.

En cas d’erreur de validation. La méthode retourne 422 Unprocessable Entity le code de réponse. Un message d’erreur et une collection de détails d’erreur sont retournés dans le corps de la réponse.

Exemples

Exemple 1 : Demande de validation réussie

Il s’agit d’un exemple de demande de validation réussie.

Demande

POST https://graph.microsoft.com/v1.0/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "Myprefix_test_mysuffix",
  "mailNickname": "Myprefix_test_mysuffix",
  "onBehalfOfUserId": "onBehalfOfUserId-value"
}

Réponse

HTTP/1.1 204 No Content

Exemple 2 : Requête avec erreurs de validation

Il s’agit d’un exemple de requête avec des erreurs de validation.

Demande

POST https://graph.microsoft.com/v1.0/groups/{id}/validateProperties
Content-type: application/json

{
  "displayName": "MyPrefix_test_mysuffix",
  "mailNickname": "MyPrefix_test_mysuffix"
}

Réponse

HTTP/1.1 422
Content-type: application/json

{
  "error": {
    "code": "Request_UnprocessableEntity",
    "message": "The values provided contain one or more validation errors.",
    "innerError": {
      "request-id": "id-value",
      "date": "date-value"
    },
    "details": [
      {
        "target": "mailNickname",
        "code": "PropertyConflict",
        "message": "Another object with the same value for property mailNickname already exists."
      }
    ]
  }
}