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

# 列出程序包名称
<a name="list-packages"></a>

使用中的`list-packages`命令 CodeArtifact 获取存储库中所有软件包名称的列表。此命令仅返回程序包名称，不返回版本。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo
```

示例输出：

```
{
    "nextToken": "eyJidWNrZXRJZCI6I...",
    "packages": [
        {
            "package": "acorn",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "acorn-dynamic-import",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ajv",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ajv-keywords",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "anymatch",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        },
        {
            "package": "ast",
            "namespace": "webassemblyjs",
            "format": "npm",
            "originConfiguration": {
                "restrictions": {
                    "publish": "BLOCK",
                    "upstream": "ALLOW"
            }
        }
    ]
}
```

## 列出 npm 程序包名称
<a name="list-packages-npm"></a>

要仅列出 npm 程序包的名称，请将 `--format` 选项的值设置为 `npm`。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm
```

要列出命名空间 (npm *scope*) 中的 npm 程序包，请使用 `--namespace` 和 `--format` 选项。

**重要**  
`--namespace` 选项的值不得包括前导 `@`。要搜索命名空间`@types`，请将值设置为*types*。

**注意**  
按命名空间前缀来筛选 `--namespace` 选项。作用域从传递给 `--namespace` 选项的值开始的任何 npm 包都将在 `list-packages` 响应中返回。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm --namespace types
```

示例输出：

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "3d-bin-packing",
            "namespace": "types",
            "format": "npm"

        },
        {
            "package": "a-big-triangle",
            "namespace": "types",
            "format": "npm"

        },
        {
            "package": "a11y-dialog",
            "namespace": "types",
            "format": "npm"

        }
    ]
}
```

## 列出 Maven 程序包名称
<a name="list-packages-maven"></a>

若要仅列出 Maven 程序包的名称，请将 `--format` 选项的值设置为 `maven`。您还必须在 `--namespace` 选项中指定 Maven 组 ID。

**注意**  
按命名空间前缀来筛选 `--namespace` 选项。作用域从传递给 `--namespace` 选项的值开始的任何 npm 包都将在 `list-packages` 响应中返回。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format maven --namespace org.apache.commons
```

示例输出：

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "commons-lang3",
            "namespace": "org.apache.commons",
            "format": "maven"

        },
        {
            "package": "commons-collections4",
            "namespace": "org.apache.commons",
            "format": "maven"

        },
        {
            "package": "commons-compress",
            "namespace": "org.apache.commons",
            "format": "maven"

        }
    ]
}
```

## 列出 Python 程序包名称
<a name="list-packages-python"></a>

要仅列出 Python 程序包的名称，请将 `--format` 选项的值设置为 `pypi`。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format pypi
```

## 按程序包名称前缀筛选
<a name="list-packages-package-prefix"></a>

 要返回以指定字符串开头的程序包，可以使用 `--package-prefix` 选项。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo  \
    --format npm --package-prefix pat
```

示例输出：

```
{
    "nextToken": "eyJidWNrZXRJZ...",
    "packages": [
        {
            "package": "path",
            "format": "npm"

        },
        {
            "package": "pat-test",
            "format": "npm"

        },
        {
            "package": "patch-math3",
            "format": "npm"

        }
    ]
}
```

## 支持的搜索选项组合
<a name="list-packages-option-combinations"></a>

您可以按照任意组合来使用 `--format`、`--namespace` 和 `--package-prefix` 选项，但不能单独使用 `--namespace`。搜索作用域从 `@types` 开始的所有 npm 程序包需要指定 `--format` 选项。单独使用 `--namespace` 会引发错误。

 `list-packages` 不支持使用这三个选项中的任何一个，并将返回存储库中的所有格式的所有程序包。

## 格式输出
<a name="list-packages-format-output"></a>

 您可以使用所有 AWS CLI 命令都可用的参数来使`list-packages`响应更紧凑且更具可读性。使用 `--query` 参数来指定每个返回的程序包版本的格式。使用 `--output` 参数将响应格式化为纯文本。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --output text --query 'packages[*].[package]'
```

示例输出：

```
accepts
array-flatten
body-parser
bytes
content-disposition
content-type
cookie
cookie-signature
```

 有关更多信息，请参阅 *AWS Command Line Interface 用户指南*中的[从 AWS CLI控制命令输出](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html)。

## 默认值和其他选项
<a name="list-packages-defaults-options"></a>

 默认情况下，`list-packages` 返回的最大结果数为 100。您可以使用 `--max-results` 选项来更改此结果限制。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo --max-results 20
```

`--max-results` 允许的最大值为 1,000。要允许列出包含 1,000 个以上程序包的存储库中的程序包，`list-packages` 支持在响应中使用 `nextToken` 字段进行分页。如果存储库中的程序包数量超过 `--max-results` 的值，则可以将 `nextToken` 的值传递给另一个 `list-packages` 调用，来获得下一页的结果。

```
aws codeartifact list-packages --domain my_domain --domain-owner 111122223333 --repository my_repo \
  --next-token rO0ABXNyAEdjb...
```