Asignar licencias a un grupo

Como administrador de la organización, usa este punto final para asignar licencias a un grupo según el ID del grupo.

Punto final de API

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

Solicitar encabezados.

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

Nota: para obtener el {access_token}, asegúrese de autenticarse mediante el método ROPC descrito aquí.

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
`accountId` (obligatorio)	Cadena	El ID de la organización en la que reside su tenant.
`groupId` (obligatorio)	Cadena	El ID del grupo al que desea asignar licencias.

Solicitar cuerpo

El cuerpo de la solicitud contiene la matriz de códigos de licencia para varios productos y su cantidad correspondiente.

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

Nota:

Para ver los códigos de paquete de usuario disponibles que puedes utilizar en el cuerpo de la solicitud, consulta los códigos de licencia de usuario.
Puede asignar tantas licencias como haya adquirido la organización.

Respuesta

200 OK

Devuelve las licencias de grupo asignadas.

404

No se asigna ninguna licencia de cuenta para la organización indicada.

409

La asignación de licencias no está permitida porque supera las cantidades de licencias de la cuenta.

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

Tu {baseURL} es: https://music-server.com
Tu {access_token} es: 1234 (para consideraciones de longitud)
El {accountId} del tenant que necesita asignación de licencia es: song-one
El {groupId} es: group-01.
Desea asignar licencias de usuario al grupo anterior de la siguiente manera:
- Automation Developers: usuario con nombre (el código de licencia es RPADEVPRONU)
- Insights Designer (el código de licencia es IDU)
- Citizen Developer: multiusuario (el código de licencia es CTZDEVCU)

La llamada debe ser similar a lo que mostramos a continuación (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
}'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
}'

Este es el cuerpo de respuesta para una asignación de licencia exitosa:

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