向组分配许可证

作为组织管理员，请使用此端点根据组 ID 将许可证分配给组。

API 端点

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

请求标头

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

注意：如要获取 {access_token}，请确保通过此处描述的 ROPC 方法进行身份验证。

路径参数

路径参数	数据类型	描述
accountId (必填)	字符串	租户所在组织的 ID。
groupId (必填)	字符串	要向其分配许可证的组的 ID。

请求正文

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

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

备注：

• 要查看可在请求正文中使用的许可证代码，请查看用户许可证代码。
• 您可以分配与组织购买的许可证一样多的许可证。

响应

200 OK

返回已分配的组许可证。

404

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

409

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

请求示例

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

• 您的 {baseURL} 为：https://music-server.com
• 您的 {access_token} 为：1234（出于长度考虑）。
• 需要分配许可证的租户 {accountId} 为： song-one
• {groupId} 为：group-01。
• 您希望将用户许可证分配给上述组，如下所示：
  • Citizen Developer - Named user（许可证代码为 RPADEVPRONU）
  • Insights Designer（许可证代码为 IDU）
  • Citizen Developer - Multiuser（许可证代码为 CTZDEVCU）

调用应如下所示 (cURL)：

curl --location --request POST 'https://music-server.com/lease_/api/account/song-one/service-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"
  ]
}