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

您可以在中查看有关软件包版本的信息，包括依赖关系 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"
}

查看 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 或使用 POM parent 标签以传递方式引用的任何其他 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 字段支持的值范围，请参阅 API 中的PackageDependency数据类型。CodeArtifact

查看程序包版本自述文件

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