

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Listar las versiones de los paquetes
<a name="list-packages-versions"></a>

Use el `list-package-versions` comando in AWS CodeArtifact para obtener una lista de todas las versiones del nombre de un paquete en un repositorio.

```
aws codeartifact list-package-versions --package kind-of \ 
--domain my_domain --domain-owner 111122223333 \
--repository my_repository --format npm
```

Código de salida de ejemplo:

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

Puede añadir el parámetro `--status` a la llamada `list-package-versions` para filtrar los resultados en función del estado de la versión del paquete. Para obtener más información sobre el estado de la versión del paquete, consulte [El estado de la versión del paquete](packages-overview.md#package-version-status). 

 Puede paginar la respuesta `list-package-versions` utilizando los parámetros `--max-results` y `--next-token`. Para `--max-results`, especifique un número entero comprendido entre 1 y 1000 para especificar el número de resultados devueltos en una sola página. El valor predeterminado es 50. Para volver a las páginas siguientes, ejecute `list-package-versions` de nuevo y pase el valor `nextToken` recibido en el resultado del comando anterior a `--next-token`. Cuando no se utiliza la opción `--next-token`, siempre se devuelve la primera página de resultados. 

 El comando `list-package-versions` no muestra las versiones de los paquetes en los repositorios ascendentes. Sin embargo, se muestran las referencias a las versiones de paquetes de un repositorio principal que se copiaron en su repositorio durante una solicitud de versión de paquete. Para obtener más información, consulte [Trabajar con repositorios ascendentes en CodeArtifact](repos-upstream.md). 

## Enumerar las versiones del paquete npm
<a name="list-packages-versions-npm"></a>

Para enumerar todas las versiones de un paquete npm, defina el valor de la opción `--format` en `npm`.

```
aws codeartifact list-package-versions --package my_package --domain my_domain \ 
 --domain-owner 111122223333 --repository my_repo --format npm
```

Para enumerar las versiones del paquete npm en un espacio de nombres específico (*alcance* npm), use la opción `--namespace`. El valor de la opción `--namespace` no debe incluir el `@` inicial. Para buscar el espacio de nombres`@types`, defina el valor en. *types*

```
aws codeartifact list-package-versions --package my_package --domain my_domain \
 --domain-owner 111122223333 --repository my_repo --format npm \
 --namespace types
```

## Enumerar las versiones de los paquetes de Maven
<a name="list-packages-versions-maven"></a>

Para enumerar todas las versiones de un paquete de Maven, establezca el valor de la opción `--format` en `maven`. También debe especificar el ID del grupo Maven en la opción `--namespace`.

```
aws codeartifact list-package-versions --package my_package --domain my_domain \
 --domain-owner 111122223333 --repository my_repo --format maven \
 --namespace org.apache.commons
```

## Ordenar versiones
<a name="list-package-versions-sorting"></a>

 `list-package-versions` puede generar versiones ordenadas en orden descendente según la hora de publicación (las versiones publicadas más recientemente aparecen primero). Utilice el parámetro `--sort-by` con un valor de `PUBLISHED_TIME`, de la siguiente manera.

```
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
```

 Código de salida de ejemplo: 

```
{

  "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...."
}
```

## Versión de visualización predeterminada
<a name="list-package-versions-default-version"></a>

 El valor devuelto para `defaultDisplayVersion` depende del formato del paquete: 
+  Para los paquetes genéricos, Maven y PyPI, es la versión del paquete publicada más recientemente. 
+  En el caso de los paquetes npm, es la versión a la que hace referencia la etiqueta `latest`. Si la etiqueta `latest` no está configurada, es la versión del paquete publicada más recientemente. 

## Formatear salida
<a name="list-package-versions-format-output"></a>

 Puede usar los parámetros que están disponibles para todos los AWS CLI comandos para que la `list-package-versions` respuesta sea compacta y más legible. Utilice el parámetro `--query` para especificar el formato de cada versión del paquete devuelto. Utilice el parámetro `--output` para dar formato a la respuesta como texto sin formato. 

```
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]'
```

Código de salida de ejemplo:

```
0.1.1
0.1.2
0.1.0
3.0.0
```

 Para obtener más información, consulte [‬Control de la salida de comandos de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html)‬ en la *Guía del usuario de AWS Command Line Interface *. 