기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 패키지 이름 나열
<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`는 단독으로 사용할 수 없습니다. 범위가 `@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...
```