Attribuer des licences à un utilisateur

Attribuez des licences à un utilisateur d'une organisation Automation Suite à l'aide de l'API de gestion des licences, y compris les en-têtes requis et les champs du corps de la demande.

En tant qu'administrateur de l'organisation, utilisez ce point de terminaison pour attribuer des licences à un utilisateur, en fonction de l'ID utilisateur.

Point de terminaison de l’API

PUT https://{yourDomain}/lease_/api/account/{accountId}/user-license

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 la méthode ROPC décrite dans l' authentification ROPC.

Paramètres de chemin d'accès

Paramètre	Type de données	Description
accountId	Chaîne de caractères (string)	Requis. L'ID de l'organisation dans laquelle réside votre utilisateur.

Corps de la requête

Le corps de la requête contient le tableau des codes de licence de divers produits et leur quantité correspondante.

{
  "userIds": ["string"],
  "userBundleCodes": ["string"],
  "useExternalLicense": true
}

Remarque :

• Pour voir les codes de bundle d'utilisateur disponibles que vous pouvez utiliser dans le corps de la demande, consultez Codes de licence utilisateur.
• Vous pouvez allouer autant de licences que l'organisation en a achetées.
• Chaque utilisateur consomme une unité de licence.

Réponses

200 OK

Renvoie les licences de groupe allouées.

404

Aucune licence de compte n'est attribuée pour l'organisation indiquée.

409

L'attribution de licence n'est pas autorisée, car elle dépasse les quantités de licences du compte.

Exemple de requête

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

• Votre {baseURL} est : https://{yourDomain}//{organizationName}.
• Votre {access_token} est : 1234 (pour des considérations de longueur).
• Le {accountId} du locataire qui a besoin d'une allocation de licence est : song-one
• Trois utilisateurs ont besoin de licences :
  • Utilisateur 1 avec userId=singer-77
  • Utilisateur 2 avec userId=singer-88
  • Utilisateur 3 avec userId=singer-111
• Vous souhaitez allouer les licences utilisateur suivantes :
  • RPA Developer - Named user (the license code is RPADEVNU)
  • Attended – Utilisateur nommé (le code de licence est ATTUNU)
  • Tester - Named user (the license code is TSTNU)

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

curl --location --request POST 'https://https://{yourDomain}/{organizationName}/lease_/api/account/1234/user-license' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
        "userIds": ["singer-77", "singer-88", "singer-111"]
    "userBundleCodes": ["RPADEVNU", "ATTUNU", "TSTNU"], 
    "useExternalLicense": true
}

Voici le corps de la réponse pour une allocation de licence réussie :

[
  {
    "userId": "string",
    "organizationId": "string",
    "useExternalLicense": true,
    "userBundleCodes": [
      "string"
    ]
  }
]