UiPath Documentation
uipath-cli
latest
false
Guia do usuário da UiPath CLI
Importante :
Este conteúdo foi traduzido com auxílio de tradução automática. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

conexões uip aops

Sintaxe e opções para "uip aops Connection" e "uip aops repo", que sincronizam conexões do Controle de Origem e inspecionam os repositórios descobertos por meio delas.

uip aops connection gerencia conexões SourceControl — o link por tenant para um provedor Git (GitHub ou Azure DevOps) que o StudioAdmin usa para descobrir repositórios, projetos de automação e soluções. uip aops repo inspeciona as ramificações de um único repositório e os arquivos de projeto de automação depois que você tem um identificador de repositório de connection repos. Consulte a visão geraluip aops para conceitos compartilhados e a divisão serviço SC/CICD.

Observação:

A criação da conexão é realizada por meio da interface gráfica do StudioAdmin — essa CLI consome apenas conexões já provisionadas por identificador. Use connection list para descobrir identificadores e, em seguida,connection sync --wait para atualizar um.

Resumo​

uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--azure-projects-ids <csv>] [--organization-identifier <name>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]

uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]
uip aops connection list
uip aops connection state [--connection <id>]
uip aops connection sync [connection-id] [--wait] [--timeout <ms>] [--poll-interval <ms>]
uip aops connection delete <connection-id> -y
uip aops connection repos <connection-id> [--azure-projects-ids <csv>] [--organization-identifier <name>]
uip aops connection repos-bulk --ids <csv>
uip aops connection projects <connection-id> [--repository-ids <csv>] [--target-framework <name>] [--project-type <type>] [--azure-projects-ids <csv>] [--organization-identifier <name>] [--sort-by <field>] [--sort-order <asc|desc>] [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection solutions <connection-id> [--offset <n>] [--limit <n>] [--search <term>]
uip aops connection azure-projects <connection-id> [--organization-identifier <name>]

uip aops repo branches <repo-id>
uip aops repo project-files <repo-id> [--reference <ref>]

lista de conexões uip aops​

Lista cada conexão Controle de origem visível para o usuário atual.

Formato dos dados (--output json)​

{
  "Code": "ConnectionList",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "name": "GitHub - main org", "type": "GitHub" }
  ]
}
{
  "Code": "ConnectionList",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "name": "GitHub - main org", "type": "GitHub" }
  ]
}

Use o identifier retornado com todos os outros comandos connection, repo e project.

estado da conexão uipath aops​

Busca o estado de sincronização atual para conexões.

Opções​

LongValorDescription
--connection <id>StringFiltre para um único identificador de conexão. Filtro do lado do cliente — a API retorna o estado de cada conexão e a CLI filtra localmente.

Formato dos dados (--output json)​

{
  "Code": "ConnectionState",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false }
  ]
}
{
  "Code": "ConnectionState",
  "Data": [
    { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false }
  ]
}

syncState é,,Success Fail Brokenou.

sincronização de conexão uip aops​

Dispare uma sincronização para uma conexão ou para todas as conexões na organização se [connection-id] for omitido.

Argumentos​

NameRequiredFinalidade
[connection-id]nãoIdentificador de conexão de connection list. Omita para sincronizar todas as conexões na organização.

Opções​

LongValorDescription
--waitBandeiraPesquise o endpoint de estado até que a sincronização atinja um estado terminal em vez de retornar imediatamente.
--timeout <ms>Número inteiroTempo máximo de espera quando --wait está definido. Padrão 300000 (5 minutos).
--poll-interval <ms>Número inteiroIntervalo entre pesquisas de estado. 2000Padrão.

O ponto de extremidade do gatilho retorna 202 imediatamente; sem --wait, o controle retorna assim que a sincronização for colocada na fila (Code: "ConnectionSyncStarted"). Com --wait, um estado terminal sem sucesso (por exemplo Broken) é relatado como uma falha, não sucesso.

Exemplo​

uip aops connection sync f1e2d3c4-0000-0000-0000-000000000001 --wait
uip aops connection sync f1e2d3c4-0000-0000-0000-000000000001 --wait

Formato dos dados (--output json)​

{ "Code": "ConnectionSynced", "Data": { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false } }
{ "Code": "ConnectionSynced", "Data": { "identifier": "f1e2d3c4-0000-0000-0000-000000000001", "syncState": "Success", "syncingInProgress": false } }

A sincronização de cada conexão (sem connection-id) retorna uma matriz em Data em vez de um objeto.

exclusão da conexão uip aops​

Excluir uma conexão Controle de origem por identificador. Permanente — os projetos e soluções descobertos por meio dessa conexão não são mais acessíveis.

Argumentos​

NameRequiredFinalidade
<connection-id>simIdentificador de conexão de connection list.

Opções​

LongDescription
-y, --yesObrigatório. Confirma esta operação irreversível — a CLI nunca solicita.

Formato dos dados (--output json)​

{ "Code": "ConnectionDeleted", "Data": { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001" } }
{ "Code": "ConnectionDeleted", "Data": { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001" } }

repositórios de conexão do uip aops​

Lista os repositórios visíveis por meio de uma única conexão.

Argumentos​

NameRequiredFinalidade
<connection-id>simIdentificador de conexão de connection list.

Opções​

LongValorDescription
--azure-projects-ids <csv>separados por vírgulaLimite a identificadores de projeto específicos do Azure DevOps. Apenas conexões do Azure.
--organization-identifier <name>StringEscopo para uma organização do Azure DevOps. Apenas conexões do Azure, para conexões entre organizações.

Formato dos dados (--output json)​

{ "Code": "ConnectionRepos", "Data": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }
{ "Code": "ConnectionRepos", "Data": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }

conexão uipath aops repos- Bulk​

Busca repositórios para várias conexões em uma única viagem de ida e volta.

Opções​

LongValorRequiredDescription
--ids <csv>separados por vírgulasimIdentificadores de conexão de connection list.

Formato dos dados (--output json)​

{
  "Code": "ConnectionReposBulk",
  "Data": [
    { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001", "Repositories": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }
  ]
}
{
  "Code": "ConnectionReposBulk",
  "Data": [
    { "ConnectionId": "f1e2d3c4-0000-0000-0000-000000000001", "Repositories": [ { "identifier": "abcd1234-0000-0000-0000-000000000001", "name": "automation-hub" } ] }
  ]
}

Uma linha por conexão — ConnectionId é mantido como um valor simples (não uma chave normalizada) para que sobreviva à formatação de saída e retorne para connection repos <id>.

projetos de conexão uip aops​

Liste os projetos de automação descobertos por meio de uma conexão.

Argumentos​

NameRequiredFinalidade
<connection-id>simIdentificador de conexão de connection list.

Opções​

LongValorDescription
--repository-ids <csv>separados por vírgulaLimite a identificadores de repositório específicos de connection repos.
--target-framework <name>StringFiltro no lado do servidor na estrutura de destino do projeto.
--project-type <type>StringFiltro do lado do servidor no tipo de projeto (por exemplo Process, Library, Agent).
--azure-projects-ids <csv>separados por vírgulaApenas conexões do Azure.
--organization-identifier <name>StringApenas conexões do Azure.
--sort-by <field>StringCampo pelo qual classificar (por exemplo name, lastModifiedDate).
--sort-order <asc|desc>ENUMDireção de classificação. Combinar com --sort-by.
--offset <n>Número inteiroNúmero a ignorar. Deve ser um múltiplo de --limit. Padrão 0.
--limit <n>Número inteiroMáximo a ser retornado. 10Padrão.
--search <term>StringFiltro de substring do lado do servidor no nome do projeto.

Exemplos​

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001 \
  --repository-ids abcd1234-0000-0000-0000-000000000001 --sort-by name --sort-order asc
uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001

uip aops connection projects f1e2d3c4-0000-0000-0000-000000000001 \
  --repository-ids abcd1234-0000-0000-0000-000000000001 --sort-by name --sort-order asc

Formato dos dados (--output json)​

{
  "Code": "ConnectionProjects",
  "Data": [
    { "ProjectId": "9999dddd-0000-0000-0000-000000000001", "Name": "Invoice Processing", "Description": "Daily invoice ingest", "Type": "Process", "Repository": "automation-hub" }
  ]
}
{
  "Code": "ConnectionProjects",
  "Data": [
    { "ProjectId": "9999dddd-0000-0000-0000-000000000001", "Name": "Invoice Processing", "Description": "Daily invoice ingest", "Type": "Process", "Repository": "automation-hub" }
  ]
}

soluções de conexão uip aops​

Lista as soluções do Studio descobertas por meio de uma conexão.

Argumentos​

NameRequiredFinalidade
<connection-id>simIdentificador de conexão de connection list.

Opções​

LongValorDescription
--offset <n>Número inteiroNúmero a ignorar. Deve ser um múltiplo de --limit. Padrão 0.
--limit <n>Número inteiroMáximo a ser retornado. 20Padrão.
--search <term>StringFiltro de substring do lado do servidor no nome da solução.

Formato dos dados (--output json)​

{ "Code": "ConnectionSolutions", "Data": { "result": [] } }
{ "Code": "ConnectionSolutions", "Data": { "result": [] } }

conexão uipath aoops azure-projects​

Liste projetos do Azure DevOps acessíveis por meio de uma conexão do Azure. As conexões do GitHub sempre retornam uma lista vazia.

Argumentos​

NameRequiredFinalidade
<connection-id>simIdentificador de conexão do Azure de connection list.

Opções​

LongValorDescription
--organization-identifier <name>StringEscopo para uma organização do Azure DevOps, para conexões que abrangem várias.

Formato dos dados (--output json)​

{ "Code": "ConnectionAzureProjects", "Data": [] }
{ "Code": "ConnectionAzureProjects", "Data": [] }

repositório uip aops​

Inspecione um repositório já exibido por meio de connection repos <connection-id>.

ramificações do repositório do uip aops​

Lista as ramificações de um repositório.

Argumentos​
NameRequiredFinalidade
<repo-id>simIdentificador do repositório de connection repos <connection-id>.
Formato dos dados (--output json)​
{ "Code": "RepoBranches", "Data": [ { "Name": "main", "Main": true }, { "Name": "release", "Main": false } ] }
{ "Code": "RepoBranches", "Data": [ { "Name": "main", "Main": true }, { "Name": "release", "Main": false } ] }

Use a ramificação Name como --reference em repo project-files, project content, etc.

arquivos de projeto do repositório uip aops​

Liste os arquivos do projeto de automação (project.json raiz) no repositório em uma referência específica.

Argumentos​
NameRequiredFinalidade
<repo-id>simIdentificador do repositório de connection repos <connection-id>.
Opções​
LongValorDescription
--reference <ref>ramificação/tag/SHAO padrão é o HEAD da ramificação padrão.
Formato dos dados (--output json)​
{ "Code": "RepoProjectFiles", "Data": [] }
{ "Code": "RepoProjectFiles", "Data": [] }
  • uip aops — visão geral e conceitos.
  • projects — inspecione um projeto ou solução depois de descoberto aqui.
  • pipelines — defina e execute pipelines de CI/CD em um projeto descoberto.

Veja também​

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades