Asignar licencias a un usuario

Como administrador de organización, utiliza este punto de conexión para asignar licencias a un usuario en función del ID de usuario.

Punto final de API

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

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 organización en el que reside el usuario.

Solicitar cuerpo

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

{
  "userIds": ["string"],
  "userBundleCodes": ["string"],
  "useExternalLicense": true
}{
  "userIds": ["string"],
  "userBundleCodes": ["string"],
  "useExternalLicense": true
}

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.
Cada usuario consume una unidad de licencia.

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
Tiene tres usuarios que necesitan licencias:
- Usuario 1 con userId=singer-77
- Uusario 2 con userId=singer-88
- Usuario 3 con userId=singer-111
Quiere asignar las siguientes licencias de usuario:
- Desarrollador de RPA: usuario designado (el código de licencia es RPADEVNU)
- Atendido: usuario designado (el código de la licencia es ATTUNU)
- Tester: usuario designado (el código de la licencia es TSTNU)

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/user-license' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
        "userIds": ["singer-77", "singer-88", "singer-111"]
    "userBundleCodes": ["RPADEVNU", "ATTUNU", "TSTNU"], 
    "useExternalLicense": true
}curl --location --request POST 'https://music-server.com/lease_/api/account/song_one/user-license' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
        "userIds": ["singer-77", "singer-88", "singer-111"]
    "userBundleCodes": ["RPADEVNU", "ATTUNU", "TSTNU"], 
    "useExternalLicense": true
}

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

[
  {
    "userId": "string",
    "organizationId": "string",
    "useExternalLicense": true,
    "userBundleCodes": [
      "string"
    ]
  }
][
  {
    "userId": "string",
    "organizationId": "string",
    "useExternalLicense": true,
    "userBundleCodes": [
      "string"
    ]
  }
]