As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Listar versões de pacotes
Use o `list-package-versions` comando in AWS CodeArtifact para obter uma lista de todas as versões de um nome de pacote em um repositório.
```
aws codeartifact list-package-versions --package kind-of \
--domain my_domain --domain-owner 111122223333 \
--repository my_repository --format npm
```
Exemplo de saída:
```
{
"defaultDisplayVersion": "1.0.1",
"format": "npm",
"package": "kind-of",
"versions": [
{
"version": "1.0.1",
"revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
},
{
"version": "1.0.0",
"revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
},
{
"version": "0.1.2",
"revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
},
{
"version": "0.1.1",
"revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
},
{
"version": "0.1.0",
"revision": "REVISION-SAMPLE-4-AF669139B772FC",
"status": "Published",
"origin": {
"domainEntryPoint": {
"externalConnectionName": "public:npmjs"
},
"originType": "EXTERNAL"
}
}
]
}
```
Você pode adicionar o parâmetro `--status` à chamada `list-package-versions` para filtrar os resultados com base no status da versão do pacote. Para obter mais informações sobre o status da versão do pacote, consulte [Satus da versão do pacote](packages-overview.md#package-version-status).
Você pode paginar a resposta de `list-package-versions` usando os parâmetros `--max-results` e `--next-token`. Para `--max-results`, especifique um número inteiro de 1 a 1000 para especificar o número de resultados retornados em uma única página. Ele assume 50 como padrão. Para retornar as páginas subsequentes, execute `list-package-versions` outra vez e passe o valor `nextToken` recebido na saída do comando anterior para `--next-token`. Quando a opção `--next-token` não é usada, a primeira página de resultados sempre é retornada.
O comando `list-package-versions` não lista versões do pacote em repositórios upstream. No entanto, as referências às versões do pacote em um repositório upstream que foram copiadas para o seu repositório durante uma solicitação de versão do pacote são listadas. Para obter mais informações, consulte [Trabalhando com repositórios upstream em CodeArtifact](repos-upstream.md).
## Listar versões do pacote npm
Para listar todas as versões de um pacote npm, defina o valor da opção `--format` como `npm`.
```
aws codeartifact list-package-versions --package my_package --domain my_domain \
--domain-owner 111122223333 --repository my_repo --format npm
```
Para listar versões do pacote npm em um namespace específico (*escopo* npm), use a opção `--namespace`. O valor da opção `--namespace` não deve incluir o `@` inicial. Para pesquisar o namespace`@types`, defina o valor como. *types*
```
aws codeartifact list-package-versions --package my_package --domain my_domain \
--domain-owner 111122223333 --repository my_repo --format npm \
--namespace types
```
## Listar as versões do pacote Maven
Para listar todas as versões de um pacote Maven, defina o valor da opção `--format` como `maven`. Você também deve especificar o ID do grupo Maven na opção `--namespace`.
```
aws codeartifact list-package-versions --package my_package --domain my_domain \
--domain-owner 111122223333 --repository my_repo --format maven \
--namespace org.apache.commons
```
## Classificar versões
O `list-package-versions` pode gerar versões classificadas em ordem decrescente com base no horário de publicação (as versões publicadas mais recentemente são listadas primeiro). Use o parâmetro `--sort-by` com um valor de `PUBLISHED_TIME`, como segue.
```
aws codeartifact list-package-versions --domain my_domain --domain-owner 111122223333 --repository my_repository \
--format npm --package webpack --max-results 5 --sort-by PUBLISHED_TIME
```
Exemplo de saída:
```
{
"defaultDisplayVersion": "4.41.2",
"format": "npm",
"package": "webpack",
"versions": [
{
"version": "5.0.0-beta.7",
"revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
"status": "Published"
},
{
"version": "5.0.0-beta.6",
"revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
"status": "Published"
},
{
"version": "5.0.0-beta.5",
"revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
"status": "Published"
},
{
"version": "5.0.0-beta.4",
"revision": "REVISION-SAMPLE-4-AF669139B772FC",
"status": "Published"
},
{
"version": "5.0.0-beta.3",
"revision": "REVISION-SAMPLE-5-C752BEE9B772FC",
"status": "Published"
}
],
"nextToken": "eyJsaXN0UGF...."
}
```
## Versão de exibição padrão
O valor de retorno para `defaultDisplayVersion` depende do formato do pacote:
+ Para pacotes genéricos, Maven e PyPI, é a versão mais recente do pacote publicada.
+ Para pacotes npm, é a versão referenciada pela tag `latest`. Se a tag `latest` não estiver definida, é a versão mais recente do pacote publicada.
## Formatar resultado
Você pode usar parâmetros que estão disponíveis para todos os AWS CLI comandos para tornar a `list-package-versions` resposta compacta e mais legível. Use o parâmetro `--query` para especificar o formato de cada versão de pacote retornada. Use o parâmetro `--output` para formatar a resposta como texto sem formatação.
```
aws codeartifact list-package-versions --package my-package-name --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format npm --output text --query 'versions[*].[version]'
```
Exemplo de saída:
```
0.1.1
0.1.2
0.1.0
3.0.0
```
Para obter mais informações, consulte [Controlar a saída do comando de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html) no *Guia do usuário do AWS Command Line Interface *.