查看和更新程序包版本详细信息和依赖项 - CodeArtifact
查看程序包版本详细信息查看 npm 程序包版本详细信息查看 Maven 程序包版本详细信息查看程序包版本依赖项查看程序包版本自述文件

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

查看和更新程序包版本详细信息和依赖项

您可以在中查看有关软件包版本的信息，包括依赖关系 CodeArtifact。您也可以更新程序包版本的状态。有关程序包版本状态的更多信息，请参阅程序包版本状态。

查看程序包版本详细信息

使用 describe-package-version 命令来查看有关程序包版本的详细信息。Package 版本详细信息是在软件包发布到时从包中提取的 CodeArtifact。不同程序包中的详细信息各不相同，且取决于程序包的格式以及作者向其中添加了多少信息。

describe-package-version 命令输出中的大多数信息都取决于程序包的格式。例如，describe-package-version 从其 package.json 文件中提取 npm 程序包的信息。修订版由创建 CodeArtifact。有关更多信息，请参阅 指定程序包版本修订。

如果两个同名的程序包版本位于不同的命名空间中，则它们可以位于同一个存储库中。使用可选的 --namespace 参数来指定命名空间。有关更多信息，请参阅查看 npm 程序包版本详细信息 或查看 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/ 的许可证字段非常大，因此这些信息不会被处理。 CodeArtifact

查看 npm 程序包版本详细信息

要查看有关 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 程序包版本详细信息

要查看有关 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或使用POMparent标签传递POM引用的任何其他包版本的信息。这意味着，describe-package-version 的输出会省略依赖于 parent 引用来包含此元数据的 Maven 程序包版本的元数据（例如许可证信息）。

查看程序包版本依赖项

使用 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 字段支持值的范围，请参阅中的PackageDependency数据类型CodeArtifact API。

查看程序包版本自述文件

某些程序包格式（例如 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"
}