Obtener resumen de licencia de la organización

PuntoFinal GET para recuperar el resumen de licencias en el nivel de organización, que cubre los totales, las asignaciones y el uso para los robots, las licencias de usuario y los consumibles.

Recupera el resumen de licencias para tu organización, incluidos los robots con licencia y asignados, las licencias de usuario con licencia y utilizadas, y los consumibles con licencia, asignados y utilizados. Requiere una aplicación externa con el ámbito PM.License.Read.

Descubre cómo crear una aplicación externa.

Punto final de API

GET {accessURL}/{organizationName}/license_/api/account/{accountId}/license-summary

Sustituye {accessURL} en todas las rutas de los puntos finales por la URL base de tu plataforma en la nube:

Cloud Platform	URL de acceso
Automation Cloud	https://cloud.uipath.com/
Sector público de Automation Cloud	https://govcloud.uipath.us/
Automation Cloud dedicado	https://{customURL}.dedicated.uipath.com/

Solicitar encabezados.

--header 'Authorization: Bearer {access_token}'

Nota:

Para obtener el {access_token}, asegúrate de autenticarte a través del método de credenciales de contraseña del propietario del recurso (ROPC) descrito en la página Métodos de autenticación.

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
accountId (obligatorio)	GUID	El ID de la organización para la cual recuperar el resumen de licencia.

Respuesta

200 OK

Devuelve el resumen de licencias para la organización, dividido en tres arrays:

• robots — para cada tipo de robot, la cantidad total con licencia (total) y la cantidad total asignada (allocated). Consulta Robots para los códigos disponibles.
• userLicenses — para cada licencia de usuario, la cantidad total de licencia (total) y la cantidad total utilizada (used). Consulta Licencias de usuario para los códigos disponibles.
• consumables — para cada unidad consumible, la cantidad total con licencia (total), la cantidad total asignada (allocated), la cantidad total utilizada (used) y el período de validez (startDate, endDate) como marcas de tiempo Unix en segundos. Consulta Consumibles para los códigos disponibles.

404

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

Solicitud de ejemplo

La solicitud debe parecerse al siguiente ejemplo (cURL):

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/license_/api/account/1234/license-summary' \
--header 'Authorization: Bearer {access_token}'

El cuerpo de respuesta de una recuperación de resumen de licencia es así:

{
    "robots": [
        {
            "code": "APPTESTR",
            "total": 5,
            "allocated": 2
        },
        {
            "code": "NONPR",
            "total": 0,
            "allocated": 0
        },
        {
            "code": "TAUNATT",
            "total": 5,
            "allocated": 2
        },
        {
            "code": "UNATT",
            "total": 5,
            "allocated": 2
        },
        {
            "code": "UNATT-HOSTING",
            "total": 0,
            "allocated": 0
        }
    ],
    "userLicenses": [
        {
            "code": "PMBU",
            "total": 5,
            "used": 0
        },
        {
            "code": "PMD",
            "total": 10,
            "used": 3
        },
        {
            "code": "IDU",
            "total": 55,
            "used": 1
        },
        {
            "code": "TSTNU",
            "total": 5,
            "used": 2
        },
        {
            "code": "AXPNU",
            "total": 100,
            "used": 10
        },
        {
            "code": "ACNU",
            "total": 2,
            "used": 0
        },
        {
            "code": "RPADEVPROCU",
            "total": 15,
            "used": 0
        },
        {
            "code": "RPADEVPRONU",
            "total": 15000,
            "used": 10
        },
        {
            "code": "CBNU",
            "total": 5,
            "used": 0
        },
        {
            "code": "ATTUNU",
            "total": 5,
            "used": 1
        },
        {
            "code": "PRONU",
            "total": 200,
            "used": 12
        },
        {
            "code": "CTZDEVNU",
            "total": 5,
            "used": 0
        },
        {
            "code": "BASICNU",
            "total": 10,
            "used": 7
        },
        {
            "code": "AKIT",
            "total": 100,
            "used": 0
        },
        {
            "code": "PLUSNU",
            "total": 2,
            "used": 5
        }
    ],
    "consumables": [
        {
            "code": "AGU",
            "total": 995658,
            "allocated": 130,
            "used": 1,
            "startDate": 1707177600,
            "endDate": 2230847999
        },
        {
            "code": "APPU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "FCCU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "HEAL",
            "total": 303330,
            "allocated": 1500,
            "used": 0,
            "startDate": 1762128000,
            "endDate": 1920844799
        },
        {
            "code": "HEALTEST",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "LU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "MRSU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "PLTU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "RU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "SPR",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        },
        {
            "code": "TEU",
            "total": 0,
            "allocated": 0,
            "used": 0,
            "startDate": null,
            "endDate": null
        }
    ]
}