パッケージバージョンを一覧表示する

フォーカスモード

パッケージバージョンを一覧表示する - CodeArtifact

npm パッケージバージョンを一覧表示する Maven パッケージバージョンを一覧表示するバージョンを並べ替えるデフォルトの表示バージョン出力形式

in AWS CodeArtifact list-package-versions コマンドを使用して、リポジトリ内のパッケージ名のすべてのバージョンのリストを取得します。


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

サンプル出力:


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

--statusパラメータをlist-package-versionsコールに追加して、パッケージバージョンのステータスに基づいて結果をフィルタリングすることができます。パッケージバージョンのステータスの詳細については、「パッケージバージョンのステータス」を参照してください。

list-package-versionsおよび--max-resultsパラメータを使用し、--next-tokenからの応答をページ分割できます。--max-resultsの場合、1 ～ 1000 の整数を指定して、単一ページに返される結果の数を指定できます。デフォルトは 50 に設定されています。後続ページを返すには、list-package-versionsをもう一度実行し、前のコマンド出力で受信したnextTokenの値を--next-tokenにパスします。--next-tokenオプションが使用されないと、常に結果の最初のページが返されます。

list-package-versionsコマンドはアップストリームリポジトリのパッケージバージョンを一覧表示しません。ただし、パッケージバージョンのリクエスト中に、リポジトリにコピーされたアップストリームリポジトリ内のパッケージバージョンへの参照が一覧表示されます。詳細については、「CodeArtifact でアップストリームリポジトリを操作する」を参照してください。

npm パッケージバージョンを一覧表示する

npm パッケージのすべてのパッケージバージョンを一覧表示するには、--format オプションの値を npm に設定します。


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

特定の名前空間 (npm scope) の npm パッケージバージョンを一覧表示するには、--namespace オプションを使用します。--namespaceオプションの値には@の先頭を含めないでください。ネームスペース@typesを検索するには、値を [タイプ] に設定します。


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

Maven パッケージバージョンを一覧表示する

Maven パッケージのすべてのパッケージバージョンを一覧表示するには、--format オプションの値を maven に設定します。また、--namespaceオプションで Maven グループ ID を指定する必要があります。


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

バージョンを並べ替える

list-package-versionsは、公開時間に基づいて降順にソートされたバージョンを出力できます (最近公開されたバージョンが最初に一覧表示されます)。次のように、PUBLISHED_TIMEの値の--sort-byパラメータを指定します。


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

サンプル出力:


{

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

デフォルトの表示バージョン

パッケージ形式によって defaultDisplayVersion の戻り値が異なります。

ジェネリック、Maven、PyPI パッケージの場合、これは最近公開されたパッケージバージョンです。
npm パッケージの場合、これはlatestタグによって参照されるバージョンです。そのlatestタグが設定されていない場合は、最近公開されたパッケージバージョンとなります。

出力形式

すべての AWS CLI コマンドで使用できるパラメータを使用して、list-package-versionsレスポンスをコンパクトで読みやすくすることができます。--queryパラメータを使用して、返される各パッケージバージョンの形式を指定します。--output パラメータを使用して、レスポンスをプレーンテキストとしてフォーマットします。


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

サンプル出力: