Obtener todas las cuentas de robot

Referencia del punto final de la API para recuperar todas las cuentas de robot de una organización de Test Cloud por ID de organización.

Devuelve la lista de todas las cuentas de robot de una organización según el ID de organización.

Punto final de API

GET {accessURL}/{organizationName}/identity_/api/RobotAccount

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
Test Cloud	https://cloud.uipath.com/
Test Cloud Sector Público	https://govcloud.uipath.us/
Test Cloud Dedicado	https://{customURL}.dedicated.uipath.com/

Ámbitos

Necesita los siguientes ámbitos:

• PM.RobotAccount
• PM.RobotAccount.Read

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 de uno de los métodos descritos aquí.

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
partitionGlobalId (obligatorio)	Cadena	El ID de la organización de la que quieres recuperar las cuentas UiPath Robot.

Parámetros de consulta

Parámetros de consulta	Tipo de datos	Descripción
searchTerm (opcional)	Cadena	La clave que desea buscar en las cuentas del UiPath Robot.
top (opcional)	Int32	Mostrar las primeras N cuentas de UiPath Robot.
skip (opcional)	Int32	Omite las cuentas de N robot superiores.
sortBy (opcional)	Int32	Especifique la propiedad DTO utilizada para ordenar las entradas de auditoría. Por ejemplo, name, creationTime o id.
sortOrder (opcional)	Int32	Especifica el orden de clasificación. Por ejemplo, ascendente (asc) o descendente (desc).

Respuesta

200 OK

Devuelve las cuentas de UiPath Robot consultadas.

Solicitud de ejemplo

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

• Su {baseURL} es: https://cloud.uipath.com/{organizationName}/identity_
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• El {partitionGlobalId} es: 3fa85f64-5717-4562-b3fc-2c963f66afa6
• Puedes establecer los siguientes parámetros de consulta:
  • searchTerm = bot
  • top = 2, para mostrar las dos primeras entradas
  • skip = 2, para omitir las dos primeras entradas
  • sortBy = name, para ordenar las entradas por nombre
  • sortOrder = asc, para ordenar las entradas de más antigua a más reciente

La llamada debe parecerse al siguiente ejemplo (cURL):

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/identity_/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6?searchTerm=attended&top=2&skip=2&sortBy=name&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

El cuerpo de respuesta de una entrada de auditoría exitosa es así:

{
    "totalCount": 3,
    "results": [
        {
            "id": "55-ab",
            "name": "Bot5",
            "displayName": "Bot5",
            "creationTime": "2021-10-19T18:05:17.3465735",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group2",
                "group3"
            ]
        },
        {
            "id": "66-cd",
            "name": "Bot6",
            "displayName": "Bot6",
            "creationTime": "2021-10-19T18:06:00.3088553",
            "lastLoginTime": null,
            "groupIds": [
                "group1",
                "group3"
            ]
        },
        {
            "id": "77-ef",
            "name": "Bot7",
            "displayName": "Bot7",
            "creationTime": "2021-10-19T18:05:31.4736281",
            "lastLoginTime": null,
            "groupIds": [
                "group2"
            ]
        }
    ]
}