

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

# 패키지 버전 세부 정보 및 종속성 보기 및 업데이트
<a name="describe-package-version"></a>

CodeArtifact에서는 종속성을 포함한 패키지 버전 관련 정보를 확인할 수 있습니다. 패키지 버전의 상태를 업데이트할 수도 있습니다. 패키지 버전 상태에 대한 자세한 내용은 [패키지 버전 상태](packages-overview.md#package-version-status) 섹션을 참조하세요.

## 패키지 버전 세부 정보 보기
<a name="view-package-details"></a>

 `describe-package-version` 명령을 사용하여 패키지 버전 관련 세부 정보를 봅니다. 패키지 버전 세부 정보는 CodeArtifact에 게시될 때 패키지에서 추출됩니다. 각 패키지의 세부 정보는 패키지 형식과 작성자가 패키지에 추가한 정보의 양에 따라 달라집니다.

 `describe-package-version` 명령 출력에 포함되는 대부분의 정보는 패키지 형식에 따라 달라집니다. 예를 들어 `describe-package-version`은 `package.json` 파일에서 npm 패키지의 정보를 추출합니다. 개정은 CodeArtifact에서 생성합니다. 자세한 내용은 [패키지 버전 개정 지정](copy-package.md#specify-package-version-revision) 단원을 참조하십시오.

 이름이 같은 두 패키지 버전은 서로 다른 네임스페이스에 있다면 동일한 리포지토리에 존재할 수 있습니다. 선택 사항인 `--namespace` 파라미터를 사용하여 네임스페이스를 지정하세요. 자세한 내용은 [npm 패키지 버전 세부 정보 보기](#describe-package-version-npm) 또는 [Maven 패키지 버전 세부 정보 보기](#describe-package-version-maven)을 참조하세요.

 다음 예제는 `my_repo` 리포지토리에 있는 `pyhamcrest`라는 Python 패키지의 `1.9.0` 버전 관련 세부 정보를 반환합니다.

```
aws codeartifact describe-package-version --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
--format pypi --package {{pyhamcrest}} --package-version {{1.9.0}}
```

 출력은 다음과 같을 수 있습니다.

```
{
  "format": "{{pypi}}",
  "package": "{{PyHamcrest}}",
  "displayName": "{{PyHamcrest}}",
  "version": "{{1.9.0}}",
  "summary": "{{Hamcrest framework for matcher objects}}",
  "homePage": "{{https://github.com/hamcrest/PyHamcrest}}",
  "publishedTime": {{1566002944.273}},
  "licenses": [
    {
      "id": "{{license-id}}",
      "name": "{{license-name}}"
    }
  ],
  "revision": "{{REVISION-SAMPLE-55C752BEE9B772FC}}"
}
```

**참고**  
CodeArtifact는 패키지 작성자가 제공한 메타데이터에서 패키지 홈 페이지 또는 패키지 라이선스 정보와 같은 패키지 버전 세부 정보를 가져옵니다. 이 정보 중 하나라도 DynamoDB 항목 크기 제한인 400KB를 초과하는 경우 CodeArtifact는 이러한 데이터를 처리할 수 없으며 콘솔 또는 `describe-package-version`의 응답에서 이 정보를 볼 수 없습니다. 예를 들어 [https://pypi.org/project/rapyd-sdk/](https://pypi.org/project/rapyd-sdk/) 같은 Python 패키지에는 매우 큰 라이선스 필드가 있으므로 CodeArtifact에서 이 정보를 처리하지 않습니다.

## npm 패키지 버전 세부 정보 보기
<a name="describe-package-version-npm"></a>

npm 패키지 버전의 세부 정보를 보려면 `--format` 옵션 값을 **npm**으로 설정하세요. 원한다면 `--namespace` 옵션에 패키지 버전 네임스페이스(npm *범위*)를 포함해도 됩니다. `--namespace` 옵션 값에는 앞에 `@`이 올 수 없습니다. `@types` 네임스페이스를 검색하려면 값을 {{유형}}으로 설정하세요.

다음 예제에서는 `@types` 범위에 있는 `webpack`이라는 npm 패키지의 `4.41.5` 버전 관련 세부 정보를 반환합니다.

```
aws codeartifact describe-package-version --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
--format npm --package {{webpack}} --namespace {{types}} --package-version {{4.41.5}}
```

 출력은 다음과 같을 수 있습니다.

```
{
  "format": "{{npm}}",
  "namespace": "{{types}}",
  "package": "{{webpack}}",
  "displayName": "{{webpack}}",
  "version": "{{4.41.5}}",
  "summary": "{{Packs CommonJs/AMD modules for the browser. Allows ... further output omitted for brevity}}",
  "homePage": "https://github.com/webpack/webpack",
  "sourceCodeRepository": "https://github.com/webpack/webpack.git",
  "publishedTime": 1577481261.09,
  "licenses": [
    {
      "id": "{{license-id}}",
      "name": "{{license-name}}"
    }
  ],
  "revision": "{{REVISION-SAMPLE-55C752BEE9B772FC}}",
  "status": "Published",
  "origin": {
            "domainEntryPoint": {
                "externalConnectionName": "public:npmjs"
            },
            "originType": "EXTERNAL"
  }
}
```

## Maven 패키지 버전 세부 정보 보기
<a name="describe-package-version-maven"></a>

Maven 패키지 버전 세부 정보를 보려면 `--format` 옵션의 값을 `maven`으로 설정하고 `--namespace` 옵션에 패키지 버전 네임스페이스를 포함하세요.

 다음 예제는 `org.apache.commons` 네임스페이스와 `my_repo` 리포지토리에 있는 `commons-rng-client-api`라는 Maven 패키지의 `1.2` 버전 관련 세부 정보를 반환합니다.

```
aws codeartifact describe-package-version --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
--format maven --namespace {{org.apache.commons}} --package {{commons-rng-client-api}} --package-version {{1.2}}
```

 출력은 다음과 같을 수 있습니다.

```
{
  "format": "{{maven}}",
  "namespace": "{{org.apache.commons}}",
  "package": "{{commons-rng-client-api}}",
  "displayName": "{{Apache Commons RNG Client API}}",
  "version": "{{1.2}}",
  "summary": "{{API for client code that uses random numbers generators.}}",
  "publishedTime": {{1567920624.849}},
  "licenses": [],
  "revision": "{{REVISION-SAMPLE-55C752BEE9B772FC}}"
}
```

**참고**  
CodeArtifact는 상위 POM 파일에서 패키지 버전 세부 정보를 추출하지 않습니다. 지정된 패키지 버전의 메타데이터에는 정확한 패키지 버전에 대한 정보만 POM에 포함되며, 상위 POM이나 POM `parent` 태그를 사용하여 전이적으로 참조하는 다른 POM에 대한 정보는 포함되지 않습니다. 즉, `parent` 참조를 사용하여 이 메타데이터를 포함하는 Maven 패키지 버전의 경우 `describe-package-version`의 출력에서 메타데이터(예: 라이선스 정보)가 생략됩니다.

## 패키지 버전 종속성 보기
<a name="view-package-dependencies"></a>

 `list-package-version-dependencies` 명령을 사용하여 패키지 버전의 종속성 목록을 가져옵니다. 다음 명령은 `my_domain` 도메인의 `my_repo` 리포지토리에 있는 `my-package`라는 npm 패키지 버전 `4.41.5`의 종속성을 나열합니다.

```
aws codeartifact list-package-version-dependencies --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
--format {{npm}} --package {{my-package}} --package-version {{4.41.5}}
```

 출력은 다음과 같을 수 있습니다.

```
{
  "dependencies": [
    {
      "namespace": "{{webassemblyjs}}",
      "package": "{{ast}}",
      "dependencyType": "{{regular}}",
      "versionRequirement": "{{1.8.5}}"
    },
    {
      "namespace": "{{webassemblyjs}}",
      "package": "{{helper-module-context}}",
      "dependencyType": "{{regular}}",
      "versionRequirement": "{{1.8.5}}"
    },
    {
      "namespace": "{{webassemblyjs}}",
      "package": "{{wasm-edit}}",
      "dependencyType": "{{regular}}",
      "versionRequirement": "{{1.8.5}}"
    }
  ],
  "versionRevision": "{{REVISION-SAMPLE-55C752BEE9B772FC}}"
}
```

dependencyType 필드에 지원되는 값의 범위는 *CodeArtifact API*의 [PackageDependency](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageDependency.html) 데이터 유형을 참조하세요.

## 패키지 버전 readme 파일 보기
<a name="view-package-readme"></a>

 npm과 같은 일부 패키지 형식에는 `README` 파일이 포함되어 있습니다. `get-package-version-readme`를 사용하여 패키지 버전의 `README` 파일을 가져옵니다. 다음 명령은 `my_domain` 도메인의 `my_repo` 리포지토리에 있는 `my-package`라는 npm 패키지 버전 `4.41.5`의 `README` 파일을 반환합니다.

**참고**  
CodeArtifact는 일반 또는 Maven 패키지의 readme 파일을 표시하는 기능을 지원하지 않습니다.

```
aws codeartifact get-package-version-readme --domain {{my_domain}} --domain-owner {{111122223333}} --repository {{my_repo}} \
--format {{npm}} --package {{my-package}} --package-version {{4.41.5}}
```

 출력은 다음과 같을 수 있습니다.

```
{  
  "format": "{{npm}}",
  "package": "{{my-package}}",
  "version": "{{4.41.5}}"
  "readme": "{{<div align=\"center\">\n   <a href=\https://github.com/webpack/webpack\"> ... more content ... \n}}",
  "versionRevision": "{{REVISION-SAMPLE-55C752BEE9B772FC}}"
}
```