列出軟件包版本

使用中的list-package-versions指令可 AWS CodeArtifact 取得儲存庫中套件名稱所有版本的清單。

aws codeartifact list-package-versions --package kind-of \ 
--domain my_domain --domain-owner 111122223333 \
--repository my_repository --format npm

輸出範例：

{
  "defaultDisplayVersion": "1.0.1",
  "format": "npm",
  "package": "kind-of",
  "versions": [
      {
          "version": "1.0.1",
          "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
          "status": "Published",
          "origin": {
                "domainEntryPoint": {
                    "externalConnectionName": "public:npmjs"
                },
                "originType": "EXTERNAL"
            }
      },
      {
          "version": "1.0.0",
          "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
          "status": "Published",
          "origin": {
                "domainEntryPoint": {
                    "externalConnectionName": "public:npmjs"
                },
                "originType": "EXTERNAL"
            }
      },
      {
          "version": "0.1.2",
          "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
          "status": "Published",
          "origin": {
                "domainEntryPoint": {
                    "externalConnectionName": "public:npmjs"
                },
                "originType": "EXTERNAL"
            }
      },
      {
          "version": "0.1.1",
          "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"",
          "status": "Published",
          "origin": {
                "domainEntryPoint": {
                    "externalConnectionName": "public:npmjs"
                },
                "originType": "EXTERNAL"
            }
      },
      {
          "version": "0.1.0",
          "revision": "REVISION-SAMPLE-4-AF669139B772FC",
          "status": "Published",
          "origin": {
                "domainEntryPoint": {
                    "externalConnectionName": "public:npmjs"
                },
                "originType": "EXTERNAL"
            }
      }        
  ]
}

您可以將--status參數新增至list-package-versions呼叫，以根據套件版本狀態篩選結果。如需有關套件版本狀態的詳細資訊，請參閱Package 版本狀態。

您可以使用--max-results和--next-token參數list-package-versions來分頁回應。對於--max-results，請指定介於 1 到 1000 之間的整數，以指定單一頁面中傳回的結果數目。它的默認值是 50。若要傳回後續頁面，請list-package-versions再次執行，並將先前指令輸出中接收到的nextToken值傳遞給--next-token。如果不使用該--next-token選項，則始終返回結果的第一頁。

該list-package-versions命令不會列出上游存儲庫中的軟件包版本。但是，會列出在封裝版本請求期間複製到存放庫的上游存放庫中封裝版本的參照。如需詳細資訊，請參閱 使用中的上游存儲庫 CodeArtifact。

列出 npm 軟件包版本

若要列出 npm 套件的所有套件版本，請將--format選項的值設定為npm。

aws codeartifact list-package-versions --package my_package --domain my_domain \ 
 --domain-owner 111122223333 --repository my_repo --format npm

若要列出特定命名空間 (npm 範圍) 中的 npm 套件版本，請使用--namespace選項。--namespace選項的值不應包含行距@。若要搜尋命名空間@types，請將值設定為類型。

aws codeartifact list-package-versions --package my_package --domain my_domain \
 --domain-owner 111122223333 --repository my_repo --format npm \
 --namespace types

列出 Maven 軟件包版本

若要列出 Maven 套件的所有套件版本，請將--format選項的值設定為maven。您還必須在--namespace選項中指定 Maven 組 ID。

aws codeartifact list-package-versions --package my_package --domain my_domain \
 --domain-owner 111122223333 --repository my_repo --format maven \
 --namespace org.apache.commons

排序版本

list-package-versions可以根據發佈時間以遞減順序排序輸出版本 (最近發佈的版本會先列出)。使用具有值的--sort-by參數PUBLISHED_TIME，如下所示。

aws codeartifact list-package-versions --domain my_domain --domain-owner 111122223333 --repository my_repository  \
--format npm --package webpack --max-results 5 --sort-by PUBLISHED_TIME

輸出範例：

{

  "defaultDisplayVersion": "4.41.2",
  "format": "npm",
  "package": "webpack",
  "versions": [
      { 
        "version": "5.0.0-beta.7", 
        "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
        "status": "Published"
      },
      { 
        "version": "5.0.0-beta.6", 
        "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
        "status": "Published" 
      },
      { 
        "version": "5.0.0-beta.5", 
        "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
        "status": "Published"
      },
      { 
        "version": "5.0.0-beta.4", 
        "revision": "REVISION-SAMPLE-4-AF669139B772FC",
        "status": "Published"
      },
      { 
        "version": "5.0.0-beta.3", 
        "revision": "REVISION-SAMPLE-5-C752BEE9B772FC",
        "status": "Published"
      }
  ],
  "nextToken": "eyJsaXN0UGF...."
}

預設顯示版本

的傳回值取defaultDisplayVersion決於套件格式：

• 對於通用，Maven 和 PyPI 軟件包，它是最近發布的軟件包版本。

• 對於 npm 軟件包，它是由latest標籤引用的版本。如果未設定latest標籤，則會是最近發佈的套件版本。

格式輸出

您可以使用適用於所有 AWS CLI 指令的參數，使list-package-versions回應變得更緊湊且更具可讀性。使用--query參數可指定每個傳回套件版本的格式。使用--output參數將回應格式化為純文字。

aws codeartifact list-package-versions --package my-package-name --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format npm --output text --query 'versions[*].[version]'

輸出範例：

0.1.1
0.1.2
0.1.0
3.0.0

若要取得更多資訊，請參閱《AWS Command Line Interface 使用指南》AWS CLI中的〈控制指令輸出〉。