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.

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.