UiPath Documentation
automation-suite
2.2510
true
Guía de la API de Automation Suite
Importante :
Este contenido se ha localizado parcialmente a partir de un sistema de traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

Asignar licencias a un usuario

Asigna licencias a un usuario en una organización de Automation Suite utilizando la API de gestión de licencias, incluidos los encabezados obligatorios y los campos del cuerpo de la solicitud.

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​

PUT 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úrate de autenticarte a través del método ROPC descrito en Autenticación ROPC.

Parámetros de ruta​

ParámetroTipo de datosDescripción
accountIdCadenaRequerido.
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.

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

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
  • 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:

La llamada debe parecerse al siguiente ejemplo (cURL):

curl --location --request POST 'https://https://{yourDomain}/{organizationName}/lease_/api/account/1234/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://https://{yourDomain}/{organizationName}/lease_/api/account/1234/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"
    ]
  }
]
  • Punto final de API​
  • Solicitar encabezados.​
  • Parámetros de ruta​
  • Solicitar cuerpo​
  • Respuesta​
  • 200 OK​
  • 404​
  • 409​
  • Solicitud de ejemplo​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado