Allocate Licenses to a Group with Quota

As an organization admin, use this endpoint to allocate licenses to a group and optionally configure quotas to limit license consumption. Requires an external application with the scope PM.License.Write.

API 端点

PUT <https://https://cloud.uipath.com/{organizationName}/lease_/api/account/{accountId}/user-license/group/{groupId}/with-quota>

请求标头

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

路径参数

路径参数	数据类型	描述
accountId (必填)	Guid	租户所在组织的 ID。
groupId (必填)	字符串	要向其分配许可证的组的 ID。 您可以通过以下步骤检索此 ID。

请求正文

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

备注：

• userBundleCodes: Array of license codes to allocate (refer to user license codes).
• quotas (optional): Quota configurations. Each userBundleCode in quotas must exist in the userBundleCodes array.
• Quota limit must be at least 1 and cannot be lower than current usage.
• If quotas are empty, licenses are allocated without limits.

响应

200 OK

Returns the allocated group licenses with configured quotas and current usage.

404

Organization or group does not exist.

请求示例

The request should resemble the following example (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
        }
    ]
}'

以下是成功分配许可证的响应正文：

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