使用查詢選項尋找變更類型 - AMS 進階使用者指南

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用查詢選項尋找變更類型

此範例示範如何使用 AMS 主控台來尋找您要提交之 RFC 的適當變更類型。

您可以使用 主控台或 API/CLI 來尋找變更類型 ID (CT) 或版本。有兩種方法：搜尋或選擇分類。對於這兩種選擇類型，您可以選擇最常使用、最近使用或按字母順序排序搜尋。

YouTube 影片：如何使用 AWS Managed Services CLI 建立 RFC，以及在哪裡可以找到 CT 結構描述？

在 AMS 主控台的 RFCs -> 建立 RFC 頁面上：

  • 選取依變更類型瀏覽 （預設值） 時：

    • 使用快速建立區域從 AMS 最熱門CTs 中選取。按一下標籤，隨即開啟執行 RFC 頁面，並自動為您填入主旨選項。視需要完成其餘選項，然後按一下執行以提交 RFC。

    • 或者，向下捲動至所有變更類型區域，並開始在選項方塊中輸入 CT 名稱，您不需要具有確切或完整的變更類型名稱。您也可以輸入相關字詞，依變更類型 ID、分類或執行模式 （自動或手動） 搜尋 CT。

      選取預設卡檢視後，相符的 CT 卡會在您輸入時顯示，選取卡片並按一下建立 RFC。選取資料表檢視後，選擇相關的 CT，然後按一下建立 RFC。這兩種方法都會開啟執行 RFC 頁面。

  • 或者，若要探索變更類型選擇，請按一下頁面頂端的依類別選擇，以開啟一系列的下拉式選項方塊。

  • 選擇類別、子類別、項目和操作。該變更類型的資訊方塊會顯示頁面底部的面板。

  • 當您準備好時，請按 Enter，並顯示相符的變更類型清單。

  • 從清單中選擇變更類型。該變更類型的資訊方塊會出現在頁面底部。

  • 在您擁有正確的變更類型之後，請選擇建立 RFC。

注意

必須安裝 AMS CLI，這些命令才能運作。若要安裝 AMS API 或 CLI，請前往 AMS 主控台開發人員資源頁面。如需 AMS CM API 或 AMS SKMS API 的參考資料，請參閱《 使用者指南》中的 AMS 資訊資源一節。您可能需要新增身分驗證--profile選項，例如 aws amsskms ams-cli-command --profile SAML。您可能還需要新增 --region選項，因為所有 AMS 命令都用盡 us-east-1；例如 aws amscm ams-cli-command --region=us-east-1。

注意

AMS API/CLI (amscm 和 amsskms) 端點位於 AWS N. Virginia 區域 us-east-1。根據身分驗證的設定方式，以及您的帳戶和資源所在的 AWS 區域，您可能需要在發出命令--region us-east-1時新增 。如果這是您的身分驗證方法--profile saml，您可能還需要新增 。

若要使用 AMS CM API 搜尋變更類型 （請參閱 ListChangeTypeClassificationSummaries) 或 CLI：

您可以使用篩選條件或查詢來搜尋。ListChangeTypeClassificationSummaries 操作具有 Category、Item、 Subcategory和 的篩選條件選項Operation，但值必須完全符合現有的值。若要在使用 CLI 時獲得更靈活的結果，您可以使用 --query選項。

使用 AMS CM API/CLI 變更類型篩選
屬性 有效值 有效/預設條件 備註

ChangeTypeId

代表 ChangeTypeId 的任何字串 （例如：ct-abc123xyz7890)

等於

如需變更類型 IDs，請參閱變更類型參考。

如需變更類型 IDs，請參閱尋找變更類型或 CSIO。

類別

任何自由格式文字

包含

不支援每個個別欄位中的規則運算式。不區分大小寫的搜尋

Subcategory

項目

作業

  1. 以下是列出變更類型分類的一些範例：

    下列命令會列出所有變更類型類別。

    aws amscm list-change-type-categories

    下列命令會列出屬於指定類別的子類別。

    aws amscm list-change-type-subcategories --category CATEGORY

    下列命令會列出屬於指定類別和子類別的項目。

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. 以下是使用 CLI 查詢搜尋變更類型的一些範例：

    下列命令會搜尋項目名稱中包含 "S3" 的 CT 分類摘要，並以資料表形式建立類別、子類別、項目、操作和變更類型 ID 的輸出。

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. 然後，您可以使用變更類型 ID 來取得 CT 結構描述並檢查參數。下列命令會將結構描述輸出至名為 CreateS3Params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    如需有關使用 CLI 查詢的資訊，請參閱如何使用 --query Option 篩選輸出和查詢語言參考 JMESPath Specification。

  4. 在您擁有變更類型 ID 之後，建議您驗證變更類型的版本，以確保它是最新版本。使用此命令來尋找指定變更類型的版本：

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    若要尋找AutomationStatus特定變更類型的 ，請執行此命令：

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    若要尋找ExpectedExecutionDurationInMinutes特定變更類型的 ，請執行此命令：

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"