本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 列出套件版本
<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 套件版本 (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` 可以輸出根據發佈時間以遞減順序排序的版本 （最新發佈的版本會先列出）。使用 值為 的 `--sort-by` 參數`PUBLISHED_TIME`，如下所示。

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