UiPath Documentation
automation-cloud
latest
false
Guía de la API de UiPath Automation Cloud

Obtener miembros del grupo local

Punto final de la API que devuelve una lista paginada de miembros pertenecientes a un grupo local específico, filtrada por organización e ID de grupo.

Devuelve una lista paginada de miembros que pertenecen a un grupo local específico, en función de la organización, el ID de grupo y los parámetros de paginación opcionales.

Punto final de API​

GET {accessURL}/{organizationName}/identity_/api/Group/{partitionGlobalId}/{groupId}/Members

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

Cloud PlatformURL de acceso
Automation Cloudhttps://cloud.uipath.com/
Sector público de Automation Cloudhttps://govcloud.uipath.us/
Automation Cloud dedicadohttps://{customURL}.dedicated.uipath.com/

Ámbitos​

Necesita los siguientes ámbitos:

  • PM.Group
  • PM.Group.Read

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

Parámetros de ruta​

Parámetros de rutaTipo de datosDescripción
partitionGlobalId (obligatorio)CadenaEl ID de la organización que contiene el grupo deseado.
groupId (obligatorio)CadenaEl ID del grupo cuyos miembros desea recuperar.

Parámetros de consulta​

Parámetros de consultaTipo de datosDescripción
topEnteroEl número de registros que se devolverán. El valor predeterminado es 10. El rango es de 0 a 1000.
skipEnteroEl número de registros que se omitirán. El valor predeterminado es 0.

Respuesta​

200 OK​

Se devuelve una lista paginada de miembros del grupo, junto con el recuento total.

404 No encontrado​

No se encontró el grupo especificado en la organización dada.

Solicitud de ejemplo​

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

  • Tu {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
  • El {groupId} es: 2512

La llamada debe parecerse al siguiente ejemplo (cURL):

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/identity_/api/Group/3fa85f64-5717-4562-b3fc-2c963f66afa6/2512/Members?top=10&skip=0' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
curl --location --request GET 'https://cloud.uipath.com/{organizationName}/identity_/api/Group/3fa85f64-5717-4562-b3fc-2c963f66afa6/2512/Members?top=10&skip=0' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

Aquí está el body de respuesta de una llamada correcta:

{
    "totalCount": 2,
    "results": [
        {
            "id": "1787ef38-5933-4f2c-a67a-9c22cdb8e6a2",
            "type": 0
        },
        {
            "id": "a4c2e8b1-7d3f-4a91-b5e2-6f8d9c0e1a3b",
            "type": 0
        }
    ]
}
{
    "totalCount": 2,
    "results": [
        {
            "id": "1787ef38-5933-4f2c-a67a-9c22cdb8e6a2",
            "type": 0
        },
        {
            "id": "a4c2e8b1-7d3f-4a91-b5e2-6f8d9c0e1a3b",
            "type": 0
        }
    ]
}

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado