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

# 패키지 버전 나열
<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"
            }
      }        
  ]
}
```

`list-package-versions` 호출에 `--status` 파라미터를 추가하면 패키지 버전 상태를 기준으로 결과를 필터링할 수 있습니다. 패키지 버전 상태에 대한 자세한 내용은 [패키지 버전 상태](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 *범위*)에 있는 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`는 게시 시간을 기준으로 내림차순으로 정렬된 버전을 출력할 수 있습니다(가장 최근에 게시된 버전이 먼저 나열됨). 다음과 같이 값이 `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)를 참조하세요.