pacotes de solução uip

Sintaxe e opções para "pacotes de soluções uip", que lista, baixa e exclui pacotes de soluções publicados.

uip solution packages gerencia pacotes de soluções publicados — os artefatos .zip produzidos por uip solution pack e carregados por uip solution publish.

Subcomando	Finalidade
list	Listar pacotes publicados (nome, versão, data de publicação).
download	Baixe um pacote publicado .zip para o disco.
delete	Exclua uma versão específica de um pacote publicado.

Todos os três subcomandos são autenticados. Execute uip login primeiro. list, download e delete cada um padrão para o feed do tenant; passe --personal-workspace ou --feed <name-or-key> (apenas para listar/excluir) para segmentar um diferente.

Observação:

O suporte a feeds de pastas no UiPath CLI estará disponível em uma versão futura. Para obter mais informações sobre feeds de pastas, consulte Feed de solução na documentação de Gerenciamento de soluções.

Resumo

uip solution packages list [--limit <n>] [--offset <n>] [--sort-by <column>] [--sort-order <Ascending|Descending>] [--name <pattern>] [--personal-workspace | --feed <name-or-key>]
uip solution packages download <packageName> [packageVersion] [--package-version <version>] [-d <destination>]
uip solution packages delete <packageName> <packageVersion> --yes [--personal-workspace | --feed <name-or-key>]

Cada subcomando honra as opções globais e retorna os códigos de saída padrão.

---

lista de pacotes de solução uip

Lista os pacotes da solução publicados em um feed. Output contém os campos que você precisa passar para uip solution deploy run: packageName e packageVersion.

Opções

Long	Valor	Padrão	Description
-l, --limit <number>	Número	50	Número de pacotes a serem retornados.
--offset <number>	Número	0	Número de pacotes a ignorar.
--sort-by <column>	text	publishDate	Coluna usada para classificar.
--sort-order <direction>	Ascending | Descending	Descending	Classificar direção.
--name <pattern>	text	—	Correspondência de substring no lado do servidor no nome do pacote.
--personal-workspace	Bandeira	desativada	Listar pacotes apenas no feed do Espaço de Trabalho Pessoal do usuário atual. mutuamente exclusivo com --feed.
--feed <name-or-key>	text	—	Liste apenas pacotes neste feed (nome ou chave de pasta, de solution feeds list). Mutualmente exclusivo com --personal-workspace.
--login-validity <minutes>	minutos	10	Mínimo de minutos antes da expiração do token para disparar uma atualização.

Exemplos

# Most-recent publish in the tenant feed
uip solution packages list --limit 1

# Packages matching a name in a specific feed
uip solution packages list --feed Finance --name my-package

# Pick the latest version of a known package
uip solution packages list --output-filter "Data[?packageName=='my-package'] | [0].packageVersion" --output plain

Formato dos dados (--output json)

{
  "Code": "SolutionPackagesList",
  "Data": [
    {
      "packageName": "MyPackage",
      "packageVersion": "1.0.0",
      "publishDate": "2026-04-15T10:30:00Z"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 10, "Offset": 0, "Total": 1 }
}

---

Download dos pacotes de solução uip

Baixe um pacote publicado .zip a partir de um feed. O pacote deve ser Ready ou Active.

Argumentos

• <package-name> (necessário) — Nome do pacote da solução. Use packages list para encontrar nomes disponíveis.
• [package-version] (opcional) — Versão a ser baixada. Também pode ser fornecido com --package-version; Fornecer valores diferentes para ambos é um erro. Mais recente será usado se omitido.

Opções

Long	Valor	Padrão	Description
--package-version <version>	text	Mais recente	Alternativa ao argumento posicional.
-d, --destination <path>	Path	diretório atual	Caminho .zip do arquivo ou diretório local. Uma barra à direita, ., ou um diretório existente é tratado como um diretório e o nome de arquivo padrão <name>.<version>.zip é acrescentado; caso contrário, o caminho será usado como o arquivo de saída exato.
--login-validity <minutes>	minutos	10	Mínimo de minutos antes da expiração do token para disparar uma atualização.

Exemplos

# Default filename in the current directory
uip solution packages download my-solution 1.0.0

# Latest version, specific output file
uip solution packages download my-solution -d ./out/my-solution.zip

# Promote a package across tenants: download from staging, publish to dev
uip login tenant set staging
uip solution packages download my-solution 1.0.0 -d ./out/my-solution_1.0.0.zip
uip login tenant set dev
uip solution publish ./out/my-solution_1.0.0.zip

Formato dos dados (--output json)

{
  "Code": "SolutionPackagesDownload",
  "Data": {
    "Status": "Package downloaded",
    "PackageName": "my-solution",
    "PackageVersion": "1.0.0",
    "State": "Ready",
    "OutputPath": "./my-solution.1.0.0.zip",
    "FileName": "./my-solution.1.0.0.zip",
    "Size": 254318
  }
}

Modos de falha

• O pacote não está no estado Ready/Active . Um pacote Pending falha com instruções para aguardar e tentar novamente; qualquer outro estado não pronto aponta para a publicação do pacote novamente.
• Versões conflitantes. É rejeitado passar o posicional [package-version] e --package-version com valores diferentes.

---

exclusão de pacotes da solução uip

Exclua uma versão específica de um pacote publicado a partir de um feed. Esta é uma operação permanente — não há exclusão reversível.

Argumentos

• <packageName> (exigido) — O nome do pacote, conforme retornado por packages list.
• <packageVersion> necessário) — A versão exata a excluir (por exemplo, 1.0.0).

Opções

Long	Valor	Padrão	Description
-y, --yes	Bandeira	—	Obrigatório. Confirma esta operação irreversível — a CLI nunca solicita.
--personal-workspace	Bandeira	desativada	Exclua a versão do pacote do feed do Espaço de Trabalho Pessoal do usuário atual. mutuamente exclusivo com --feed.
--feed <name-or-key>	text	—	Exclua a versão do pacote deste feed (nome ou chave da pasta). mutuamente exclusivo com --personal-workspace.
--login-validity <minutes>	minutos	10	Mínimo de minutos antes da expiração do token para disparar uma atualização.

Exemplos

uip solution packages delete my-package 1.0.0 --yes

# Delete all versions older than a given major
uip solution packages list --limit 100 \
  --output-filter "Data[?packageName=='my-package' && starts_with(packageVersion, '0.')]" \
  --output json \
  | jq -r '.[] | .packageVersion' \
  | xargs -I{} uip solution packages delete my-package {} --yes

Formato dos dados (--output json)

{
  "Code": "SolutionPackagesDelete",
  "Data": {
    "PackageName": "my-package",
    "PackageVersion": "1.0.0"
  }
}

Modos de falha

• Não há -y, --yes. O comando recusa sem confirmar — isso não é uma solicitação, é um requisito rígido.
• Pacote ou versão não encontrados. Exibe como uma falha padrão com instruções para verificar o nome e a versão em relação a packages list (com escopo no mesmo --personal-workspace/--feed, se usado).
• Permissões insuficientes. O usuário autenticado deve ter permissão para excluir pacotes no feed de destino.

---

Comandos relacionados

• uip solution pack — produz os arquivos .zip que terminam em um feed.
• uip solution publish — carrega um .zip compactado para um feed (consulte o tratamento de conflitos de versões).
• uip solution feeds list — encontre o nome de um feed ou a chave para --feed.
• uip solution deploy run — implantar um pacote publicado no Orchestrator.

Veja também

• Autenticação.
• uip solution visão geral.