Asignar licencias a un grupo

Referencia de la API para asignar licencias a un grupo utilizando el ámbito PM.License.Write en Automation Suite.

Como administrador de la organización, utiliza este punto final para asignar licencias a un grupo. Para ello, debes crear una aplicación externa, con el ámbito PM.License.Write.

Descubre cómo crear una aplicación externa.

Punto final de API

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

Solicitar encabezados.

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

Nota:

Para obtener el {access_token}, asegúrate de autenticarte a través del método ROPC descrito aquí.

Parámetros de ruta

Parámetro	Tipo de datos	Descripción
accountId	Cadena	Requerido. El ID de la organización en la que reside su tenant.
groupId	Cadena	Requerido. El ID del grupo al que desea asignar licencias. Puedes recuperar este ID siguiendo estos pasos.

Solicitar cuerpo

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

{
    "userBundleCodes": ["string"]
}

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.

• Su {baseURL} es: https://{yourDomain}/{organizationName}.
• 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 de la siguiente manera:
  • Automation Developers: Named User (el código de licencia es RPADEVPRONU)
  • Insights Designer (el código de licencia es IDU)
  • Citizen Developer - Multiuser (el código de licencia es CTZDEVCU)

La llamada debe parecerse al siguiente ejemplo (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
}'

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

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