

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

# 查看和更新程序包版本详细信息和依赖项
<a name="describe-package-version"></a>

您可以在中查看有关软件包版本的信息，包括依赖关系 CodeArtifact。您也可以更新程序包版本的状态。有关程序包版本状态的更多信息，请参阅[程序包版本状态](packages-overview.md#package-version-status)。

## 查看程序包版本详细信息
<a name="view-package-details"></a>

 使用 `describe-package-version` 命令来查看有关程序包版本的详细信息。Package 版本详细信息是在软件包发布到时从包中提取的 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 从软件包作者提供的元数据中获取软件包版本详细信息，例如软件包主页或软件包许可证信息。如果其中任何信息超过 400 KB（即 DynamoDB 项目大小限制） CodeArtifact ，则将无法处理此类数据，并且您可能无法在控制台或的响应中看到这些信息。`describe-package-version`例如，像 p [https://pyi 这样的 python 软件包。 org/project/rapyd-sdk/](https://pypi.org/project/rapyd-sdk/) 的许可证字段非常大，因此这些信息不会被处理。 CodeArtifact

## 查看 npm 程序包版本详细信息
<a name="describe-package-version-npm"></a>

要查看有关 npm 程序包版本的详细信息，请将 `--format` 选项的值设置为 **npm**。（可选）在 `--namespace` 选项中包括程序包版本命名空间 (npm *scope*)。`--namespace` 选项的值不得包括前导 `@`。要搜索命名空间`@types`，请将值设置为{{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 的信息。这意味着，`describe-package-version` 的输出会省略依赖于 `parent` 引用来包含此元数据的 Maven 程序包版本的元数据（例如许可证信息）。

## 查看程序包版本依赖项
<a name="view-package-dependencies"></a>

 使用 `list-package-version-dependencies` 命令来获取程序包版本依赖项的列表。以下命令列出 `my_domain` 域的 `my_repo` 存储库中名为 `my-package`、版本为 `4.41.5` 的 npm 程序包的依赖项。

```
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 字段支持的值范围，请参阅 API 中的[PackageDependency](https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageDependency.html)数据类型。CodeArtifact *

## 查看程序包版本自述文件
<a name="view-package-readme"></a>

 某些程序包格式（例如 npm）包括一个 `README` 文件。使用 `get-package-version-readme` 来获取程序包版本的 `README` 文件。以下命令返回 `my_domain` 域的 `my_repo` 存储库中名为 `my-package`、版本为 `4.41.5` 的 npm 程序包的 `README` 文件。

**注意**  
CodeArtifact 不支持显示来自通用包或 Maven 包的自述文件。

```
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}}"
}
```