翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# パッケージバージョンを一覧表示する
<a name="list-packages-versions"></a>

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`コールに追加して、パッケージバージョンのステータスに基づいて結果をフィルタリングすることができます。パッケージバージョンのステータスの詳細については、「[パッケージバージョンのステータス](packages-overview.md#package-version-status)」を参照してください。

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

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

## npm パッケージバージョンを一覧表示する
<a name="list-packages-versions-npm"></a>

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 パッケージバージョンを一覧表示する
<a name="list-packages-versions-maven"></a>

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

## バージョンを並べ替える
<a name="list-package-versions-sorting"></a>

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

## デフォルトの表示バージョン
<a name="list-package-versions-default-version"></a>

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

## 出力形式
<a name="list-package-versions-format-output"></a>

 すべての 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]'
```

サンプル出力:

```
0.1.1
0.1.2
0.1.0
3.0.0
```

 詳細については、*[AWS Command Line Interface ユーザーガイド]* の [[ AWS CLIからのコマンド出力のコントロール]](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html) を参照してください。