Liste des versions du package

Utilisez la list-package-versions commande in AWS CodeArtifact pour obtenir la liste de toutes les versions d'un nom de package dans un référentiel.

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

Exemple de sortie :

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

Vous pouvez ajouter le --status paramètre à l'list-package-versionsappel pour filtrer les résultats en fonction de l'état de la version du package. Pour plus d'informations sur l'état de la version du package, consultezÉtat de la version du package.

Vous pouvez paginer la réponse à l'list-package-versionsaide des --next-token paramètres --max-results et. Pour--max-results, spécifiez un entier compris entre 1 et 1 000 pour spécifier le nombre de résultats renvoyés sur une seule page. Sa valeur par défaut est 50. Pour renvoyer les pages suivantes, exécutez list-package-versions à nouveau et transmettez la nextToken valeur reçue dans la sortie de commande précédente à--next-token. Lorsque l'--next-tokenoption n'est pas utilisée, la première page de résultats est toujours renvoyée.

La list-package-versions commande ne répertorie pas les versions des packages dans les référentiels en amont. Toutefois, les références aux versions de package d'un référentiel en amont qui ont été copiées dans votre référentiel lors d'une demande de version de package sont répertoriées. Pour plus d’informations, consultez Utilisation de référentiels en amont dans CodeArtifact.

Répertorier les versions du package npm

Pour répertorier toutes les versions de package d'un package npm, définissez la valeur de l'--formatoption sur. npm

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

Pour répertorier les versions du package npm dans un espace de noms spécifique (npm scope), utilisez l'option. --namespace La valeur de l'--namespaceoption ne doit pas inclure le début@. Pour rechercher l'espace de noms@types, définissez la valeur sur types.

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

Répertorier les versions du package Maven

Pour répertorier toutes les versions d'un package Maven, définissez la valeur de l'--formatoption sur. maven Vous devez également spécifier l'ID du groupe Maven dans l'--namespaceoption.

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

Trier les versions

list-package-versionspeut générer des versions triées par ordre décroissant en fonction de l'heure de publication (les versions les plus récentes sont répertoriées en premier). Utilisez le --sort-by paramètre avec une valeur dePUBLISHED_TIME, comme suit.

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

Exemple de sortie :

{

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

Version d'affichage par défaut

La valeur renvoyée pour defaultDisplayVersion dépend du format du package :

• Pour les packages génériques, Maven et PyPI, il s'agit de la version de package la plus récente publiée.

• Pour les packages npm, il s'agit de la version référencée par le latest tag. Si la latest balise n'est pas définie, il s'agit de la dernière version du package publiée.

Format de sortie

Vous pouvez utiliser les paramètres disponibles pour toutes les AWS CLI commandes afin de rendre la list-package-versions réponse compacte et plus lisible. Utilisez le --query paramètre pour spécifier le format de chaque version de package renvoyée. Utilisez le --output paramètre pour formater la réponse sous forme de texte brut.

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

Exemple de sortie :

0.1.1
0.1.2
0.1.0
3.0.0

Pour plus d'informations, consultez la section Contrôle de la sortie des commandes AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.