檢視和更新套件版本詳細資料和相依性

您可以在中檢視有關套件版本的資訊，包括相依性 CodeArtifact。您也可以更新套件版本的狀態。如需有關套件版本狀態的詳細資訊，請參閱Package 版本狀態。

查看軟件包版本詳情

使用命describe-package-version令檢視有關套件版本的詳細資料。Package 版本詳細資訊會在套件發佈至時從封裝中擷取 CodeArtifact。不同軟件包中的詳細信息各不相同，取決於它們的格式以及他們的作者向他們添加了多少信息。

describe-package-version命令輸出中的大多數資訊取決於套件格式。例如，從檔案describe-package-version擷取 npm 套package.json件的資訊。修訂版由建立 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範圍webpack中命名4.41.5的 npm 包的版本的詳細信息。

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 標籤傳遞引用的任何其他 POM 的信息。parent這表示的輸出describe-package-version會忽略依賴parent參考來包含此中繼資料的 Maven 套件版本的中繼資料 (例如授權資訊)。

檢視套件版本相依性

使用list-package-version-dependencies指令取得套件版本相依性的清單。下列命令會列出my_repo儲存庫中my_domain網域my-package中名為 version 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"
}

如需「相依類型」欄位支援的值範圍，請參閱 API 中的PackageDependency資料類型。CodeArtifact

檢視套件版本讀我檔

某些套件格式 (例如 npm) 會包含README檔案。使用get-package-version-readme取得套README件版本的檔案。下列命令會傳回my_repo儲存庫中my_domain網域中名為 my-package version 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"
}