Créer un nouveau groupe local

Crée un groupe local dans l'ID d'organisation indiqué et y ajoute les utilisateurs indiqués.

Point de terminaison de l’API

POST https://{yourDomain}/identity/api/Group

Étendues

Nécessite les étendues suivantes :

• PM.Group
• PM.Group.Write

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Remarque : pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Corps de la requête

Le corps de la demande contient l'ID de l'organisation à laquelle ajouter le groupe et, éventuellement, les utilisateurs que vous souhaitez ajouter en tant que membres du nouveau groupe.

{
  "partitionGlobalId": "string",
  "id": "string",
  "name": "string",
  "directoryUserMemberIDs": [
    "string", "string"
  ]
}

Réponses

201 Réussi

Le groupe personnalisé est créé dans l'organisation indiquée et obtient un ID.

Exemple de requête

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

• Your {baseURL} is: https://{yourDomain}/identity
• Votre {access_token} est : 1234 (pour des considérations de longueur).
• Le {partitionGlobalId} est : 3fa85f64-5717-4562-b3fc-2c963f66afa6
• Vous souhaitez nommer le groupe : "Gryffindors"

• Vous souhaitez ajouter les utilisateurs Ron, Harry et Hermione au groupe. Ces utilisateurs ont les ID utilisateur suivants :

  • Identifiant utilisateur Ron : ron-0103
  • Identifiant utilisateur Harry : har-3107
  • Identifiant utilisateur Hermione : her-1909

L’appel doit ressembler à l’exemple suivant (cURL) :

curl --location --request POST 'https://{yourDomain}/identity/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId":"3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name":"Gryffindors",
    "id": "gryff-01",
    "directoryUserMemberIDs":
    ["ron-0103", "har-3107", "her-1909"]
}'

Voici la réponse pour un appel réussi :

{
    "id": "gryff-01",
    "name": "Gryffindors",
    "displayName": "Gryffindors",
    "type": 1,
    "creationTime": "2021-10-19T15:37:49.1853184",
    "lastModificationTime": null,
    "members": [
        {
            "objectType": "DirectoryUser",
            "firstName": "Hermione",
            "lastName": "Granger",
            "jobTitle": "student",
            "companyName": "Hogwarts",
            "city": "London",
            "department": "magic",
            "displayName": "Hermione Granger",
            "source": "local",
            "identifier": "her-1909",
            "name": "Hermione",
            "email": "[e-mail]"
        },
        {
            "objectType": "DirectoryUser",
            "firstName": "Harry",
            "lastName": "Potter",
            "jobTitle": ""student"",
            "companyName": "Hogwarts",
            "city": "London",
            "department": "magic",
            "displayName": "Harry Potter",
            "source": "local",
            "identifier": "har-3107",
            "name": "Harry",
            "email": "[e-mail]"
        },
        {
            "objectType": "DirectoryUser",
            "firstName": "Ron",
            "lastName": "Weasley",
            "jobTitle": "student",
            "companyName": "Hogwarts",
            "city": "London",
            "department": "magic",
            "displayName": "Ron Weasley",
            "source": "local",
            "identifier": "ron-0103",
            "name": "Ron",
            "email": "[e-mail]"
        }
    ]
}