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

# 列出套件名稱
<a name="list-packages"></a>

使用 CodeArtifact 中的 `list-packages`命令，取得儲存庫中所有套件名稱的清單。此命令只會傳回套件名稱，而不會傳回版本。

```
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 套件 (npm *範圍*)，請使用 `--namespace`和 `--format`選項。

**重要**  
`--namespace` 選項的值不應包含前置 `@`。若要搜尋命名空間 `@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` 本身無法使用。搜尋範圍開頭為 的所有 npm 套件`@types`，需要指定 `--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...
```