Weisen Sie Lizenzen einer Gruppe mit Kontingent zu

API-Endpunkt für das Zuweisen von Lizenzen zu einer Gruppe mit optionalen Verbrauchskontingenten in Test Cloud, was den Scope PM.License.Write erfordert.

Verwenden Sie als Organisationsadministrator diesen Endpunkt, um einer Gruppe Lizenzen zuzuweisen und optional Kontingente zu konfigurieren, um den Lizenzverbrauch zu begrenzen. Erfordert eine externe Anwendung mit dem Scope PM.License.Write.

API-Endpunkt

PUT {accessURL}/{organizationName}/lease_/api/account/{accountId}/user-license/group/{groupId}/with-quota

Ersetzen Sie {accessURL} in allen Endpunktpfaden durch die Basis-URL für Ihre Cloud-Plattform:

Cloud Platform	Zugriffs-URL
Test Cloud	https://cloud.uipath.com/
Test Cloud Public Sector	https://govcloud.uipath.us/
Test Cloud Dedicated.	https://{customURL}.dedicated.uipath.com/

Anforderungsheader

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

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
accountId (erforderlich)	GUID	Die ID der Organisation, in der sich Ihr Mandant befindet.
groupId (erforderlich)	String	Die ID der Gruppe, der Sie Lizenzen zuweisen möchten. Sie können diese ID abrufen, indem Sie die folgenden Schritte ausführen .

Anforderungstext

{
    "userBundleCodes": ["string"],
    "quotas": [
        {
            "userBundleCode": "string",
            "limit": 10
        }
    ]
}

Hinweis:

• userBundleCodes: Array der zuzuweisenden Lizenzcodes (Siehe Benutzerlizenzcodes).
• quotas (Optional): Kontingentkonfigurationen. Jedes userBundleCode in Kontingenten muss im userBundleCodes -Array vorhanden sein.
• Das Kontingent limit muss mindestens 1 sein und darf nicht niedriger als die aktuelle Nutzung sein.
• Wenn Kontingente leer sind, werden Lizenzen ohne Limit zugewiesen.

Antworten

200 OK

Gibt die zugeordneten Gruppenlizenzen mit konfigurierten Kontingenten und aktueller Nutzung zurück.

404

Organisation oder Gruppe ist nicht vorhanden.

Beispielanforderung

Die Anfrage sollte wie im folgenden Beispiel aussehen (cURL):

curl --location --request PUT 'https://https://cloud.uipath.com/{organizationName}/lease_/api/account/1234/user-license/group/group-01/with-quota' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userBundleCodes": ["RPADEVPRONU", "IDU"],
    "quotas": [
        {
            "userBundleCode": "RPADEVPRONU",
            "limit": 10
        }
    ]
}'

Hier ist der Antworttext für eine erfolgreiche Lizenzzuweisung:

{
  "groupRule": {
    "groupId": "group-01",
    "organizationId": "1234",
    "userBundleCodes": ["RPADEVPRONU", "IDU"]
  },
  "quotas": [
    {
      "userBundleCode": "RPADEVPRONU",
      "limit": 10,
      "currentUsage": 3
    }
  ]
}