本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 列出程序包版本
<a name="list-packages-versions"></a>

使用中的`list-package-versions`命令 AWS CodeArtifact 获取存储库中软件包名称的所有版本的列表。

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

 您可以使用 `--max-results` 和 `--next-token` 参数对来自 `list-package-versions` 的响应进行分页。对于 `--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`，请将值设置为{{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)。