向组分配许可证

作为组织管理员，请使用此端点向组分配许可证。 为此，您需要创建一个名为PM.License.Write作用域的外部应用程序。

了解如何创建外部应用程序。

API 端点

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

请求标头

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

备注：

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

路径参数

路径参数	数据类型	描述
accountId (必填)	字符串	租户所在组织的 ID。
groupId (必填)	字符串	要向其分配许可证的组的 ID。 You can retrieve this ID by following these steps.

请求正文

请求正文包含各种产品的许可证代码数组及其相应的数量。

{
    "userBundleCodes": ["string"]
}

备注：

• To see the available user bundle codes you may use in the request body, check out the user license codes.
• 您可以分配与组织购买的许可证一样多的许可证。

响应

200 OK

返回已分配的组许可证。

404

未为指定组织分配帐户许可证。

409

不允许分配许可证，因为它超出了帐户许可证数量。

请求示例

假设您收集了构建 API 调用所需的所有信息。

• 您的{baseURL}为： https://{yourDomain}/{organizationName} 。
• 您的 {access_token} 为：1234（出于长度考虑）。
• 需要分配许可证的租户 {accountId} 为： song-one
• {groupId} 为：group-01。
• 您需要按如下方式向组分配用户许可证：
  • Automation Developers - Named user (the license code is RPADEVPRONU)
  • Insights Designer (the license code is IDU)
  • Citizen Developer - Multiuser (the license code is CTZDEVCU)

调用应类似于以下示例 (cURL)：

curl --location --request POST 'https://https://{yourDomain}/{organizationName}/lease_/api/account/1234/user-license/group/group-01' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userBundleCodes": ["RPADEVPRONU", "IDU", "CTZDEVCU"],
    "useExternalLicense": false
}'

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

{
  "groupId": "string",
  "organizationId": "string",
  "useExternalLicense": false,
  "userBundleCodes": [
    "string"
  ]
}