Zuweisung von Lizenzen zu einem Benutzer

API-Endpunkt für die Zuweisung von Lizenzen zu einem Benutzer anhand der Benutzer-ID, was Administratorzugriff für die Organisation erfordert.

Als Organisationsadministrator können Sie mit diesem Endpunkt einem Benutzer auf der Grundlage der Benutzer-ID Lizenzen zuweisen.

API-Endpunkt

PUT {accessURL}/lease_/api/account/{accountId}/user-license

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

Cloud Platform	Zugriffs-URL
Automation Cloud	https://cloud.uipath.com/
Automation Cloud – Öffentlicher Sektor	https://govcloud.uipath.us/
Automatisierung – cloudgeeignet	https://{customURL}.dedicated.uipath.com/

Anforderungsheader

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

Hinweis:

Um das {access_token} zu erhalten, müssen Sie sich über die beschriebene ROPC-Methode authentifizieren.

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
accountId (erforderlich)	String	Die ID der Organisation, in der Ihr Benutzer registriert ist.

Anforderungstext

Der Anforderungstext enthält das Array der Lizenzcodes für verschiedene Produkte und die entsprechende Menge.

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

Hinweis:

• Eine Übersicht über die verfügbaren Benutzerpaketcodes, die Sie im Anforderungstext verwenden können, finden Sie unter Benutzerpaketcodes.
• Sie können so viele Lizenzen zuweisen, wie die Organisation erworben hat.
• Jeder Benutzer verbraucht eine Lizenzeinheit.

Antworten

200 OK

Gibt die zugewiesenen Gruppenlizenzen zurück.

404

Für die angegebene Organisation ist keine Kontolizenz zugewiesen.

409

Die Lizenzzuweisung ist nicht zulässig, da sie die Anzahl der Kontolizenzen überschreitet.

Beispielanforderung

Angenommen, Sie haben alle Informationen gesammelt, die zum Erstellen des API-Aufrufs erforderlich sind.

• Ihre {baseURL} ist: https://cloud.uipath.com//{organizationName}.
• Ihre {access_token} ist: 1234 (aus Gründen der Länge).
• Die {accountId} des Mandanten, der eine Lizenzzuweisung benötigt, ist: song-one
• Sie haben drei Benutzer, die Lizenzen benötigen:
  • Benutzer 1 mit userId=singer-77
  • Benutzer 2 mit userId=singer-88
  • Benutzer 3 mit userId=singer-111
• Sie möchten die folgenden Benutzerlizenzen zuweisen:
  • RPA-Entwickler – Named User ( Lizenzcode ist RPADEVNU)
  • Attended – Named user (der Lizenzcode ist ATTUNU)
  • Tester – Named User (der Lizenzcode ist TSTNU)

Der Aufruf sollte dem folgenden Beispiel ähneln (cURL):

curl --location --request POST 'https://https://cloud.uipath.com/{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
}

Hier ist der Antworttext für eine erfolgreiche Lizenzzuweisung:

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