Zuweisen von Lizenzen zu einer Organisation

Als Hostadministrator können Sie einen Endpunkt verwenden, um einer Organisation Lizenzen basierend auf der Organisations-ID zuzuweisen.

Wichtig:

Um Organisationen und Mandanten Lizenzen zuzuweisen, müssen Sie sich mit den Host-Anmeldeinformationen authentifizieren.

API-Endpunkt

PUT https://{yourDomain}/lrm/api/host/{hostAccountID}/organization/{organizationId}/license

Anforderungsheader

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

Hinweis:

To obtain the {access_token}, make sure to authenticate through the ROPC method described here.

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
hostAccountID (erforderlich)	String	Die ID des Hostkontos, das die Lizenzen zuweist. Verwenden Sie immer den Standardwert: feb0dd79-85b6-483b-b297-0e49a1aa5b7d
organizationId (erforderlich)	String	Die ID der Organisation, der Sie Lizenzen zuweisen möchten.

Anforderungstext

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

{
    "productQuantities":
        [
          { "code": "string", "quantity": 0 }
        ]
}

Hinweis:

• To see the available license codes you may use in the request body, check out License codes.
• Sie können so viele Lizenzen zuweisen, wie die Organisation erworben hat.

Antworten

200 OK

Gibt die zugeordneten Lizenzen zurück.

404

Die Hostlizenz ist nicht vorhanden, oder das Feature-Flag für lokale Flows ist deaktiviert.

409

Die Lizenzzuweisung ist nicht gestattet, da sie die Menge der Hostlizenzen überschreitet.

Beispielanforderung

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

• Ihre {baseURL} ist: https://tom-jones-server.com
• Ihre {access_token} ist: 1234 (aus Gründen der Länge).
• Ihre {hostAccountId} ist: j0ne5
• Die {organizationId} , die eine Lizenzzuweisung benötigt, ist: y-y-y-delilah
• Sie möchten der Organisation Produktlizenzen wie folgt zuweisen:
  • 2 Unattended Robots (the license code is UNATT)
  • 1 AI Center Pro license (the license code is AIG)
  • 3 Testing licenses (the license code is TAUNATT)

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

curl --location --request POST 'https://tom-jones-server.com/lrm/api/host/j0ne5/organization/y-y-y-delilah/license' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productQuantities":
        [
          { "code": "UNATT", "quantity": 2 },
          { "code": "AIG", "quantity": 1 },
          { "code": "TAUNATT", "quantity": 3 }
        ]
}'

Hier ist der Antworttext für eine erfolgreiche Lizenzzuweisung:

{
  "accountId": "y-y-y-delilah",
  "bundleCode": "string",
  "endDate": 0,
  "gracePeriod": 0,
  "licenseCode": "string",
  "licenseStatus": "string",
  "products": [
    {
      "code": "string",
      "quantity": 0,
      "type": "string",
      "features": [
        {
          "code": "string",
          "type": "string",
          "value": "string"
        }
      ]
    }
  ],
  "templates": [
    {
      "productCode": "string",
      "products": [
        {
          "code": "string",
          "type": "string"
        }
      ]
    }
  ],
  "startDate": 0,
  "subscriptionCode": "string",
  "subscriptionPlan": "string",
  "payload": "string",
  "type": "string",
  "parentLicenseCode": "string"
}