automation-suite
2021.10
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
UiPath logo, featuring letters U and I in white
Fora do período de suporte
Guia da API do Automation Suite
Last updated 11 de nov de 2024

[Visualizar] Obter todas as contas de robôs

Retorna a lista de todas as contas de Robots de uma organização, com base na ID da organização

Ponto de Extremidade da API

GET https://{yourDomain}/identity_/api/Setting

Escopos

Requer os seguintes escopos:

  • PM.RobotAccount
  • PM.RobotAccount.Read

Cabeçalhos de solicitação.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Observação: para obter o {access_token}, certifique-se de se autenticar por meio de um dos métodos descritos aqui.

Parâmetros do caminho

Parâmetro do caminho

Tipo de dados

Description

partitionGlobalId

(obrigatório)

String

A ID da organização da qual você deseja recuperar as contas de Robots.

Parâmetros de Consulta

Parâmetro de consulta

Tipo de dados

Description

searchTerm

(opcional)

String

A chave que você deseja usar para procurar as contas de Robots.

top

(opcional)

Int32

Exibe as N principais contas de Robots.

skip

(opcional)

Int32

Pular as principais contas do N robô.

sortBy

(opcional)

Int32

Especifica a propriedade DTO usada para classificar as entradas de auditoria.

Por exemplo, name, creationTime, id, etc.

sortOrder

(opcional)

Int32

Especifica a ordem de classificação.

Por exemplo, crescente (asc) ou decrescente (desc).

Resposta

200 OK

Retorna as contas de Robots consultadas.

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de API.

  • Seu {baseURL} é: https://{yourDomain}/{organizationName}/{tenantName}/
  • Seu {access_token} é: 1234 (para considerações de comprimento).
  • O {partitionGlobalId} é: magic-7
  • Você define os seguintes parâmetros de consulta:

    • searchTerm = bot
    • top = 2, para exibir as duas principais entradas
    • skip = 2, para pular as duas primeiras entradas
    • sortBy = name, para classificar as entradas por seu nome
    • sortOrder = asc, para classificar as entradas da entrada mais antiga para a mais recente

A chamada deve ter a seguinte aparência (cURL):

curl --location --request GET 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7?searchTerm=attended&top=2&skip=2&sortBy=name&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'curl --location --request GET 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7?searchTerm=attended&top=2&skip=2&sortBy=name&sortOrder=asc' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

Aqui está o corpo da resposta de uma recuperação bem-sucedida de entradas de auditoria:

{
    "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"
            ]
        }
    ]
}{
    "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"
            ]
        }
    ]
}

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.