更新 AWS CloudFormation 堆疊型群組 - AWS Resource Groups

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

更新 AWS CloudFormation 堆疊型群組

下列程序說明如何更新 CloudFormation 堆疊型群組。

Console

您無法在 中將 AWS CloudFormation 堆疊型群組變更為標籤型群組 AWS Management Console。不過，您可以變更群組所在的堆疊，或變更您要包含在群組中的堆疊資源類型。您也可以新增或變更群組的描述。

  1. 登入 AWS Resource Groups 主控台。

  2. 在導覽窗格的已儲存資源群組下，選擇群組的名稱，然後選擇編輯。

  3. 注意

    您只能更新您擁有的資源群組。擁有者欄顯示每個資源群組的帳戶擁有權。任何具有帳戶擁有者的群組，除了您登入的帳戶擁有者之外，都會在其中建立 AWS License Manager。如需詳細資訊，請參閱《 License Manager 使用者指南》中的主機資源群組 AWS License Manager。

  4. 在編輯群組頁面的分組條件下，若要變更群組所在的堆疊，請從下拉式清單中選擇堆疊。一個資源群組只能根據一個堆疊。若要篩選堆疊的清單，請從輸入堆疊的名稱開始。只有具有支援狀態的堆疊會顯示在清單中。如需支援的狀態的清單，請參閱本指南中的在 中建立查詢型群組 AWS Resource Groups。

  5. 新增或移除資源類型。只有堆疊中可用的資源類型才會顯示在下拉式清單。預設值是 All supported resource types (所有支援的資源類型)。您在查詢中最多可以有 20 個資源類型。若要移除資源類型，選擇資源類型標籤上的 X。如需支援及可在群組中的資源類型的詳細資訊，請參閱您可以搭配 AWS Resource Groups 和 標籤編輯器使用的資源類型。

  6. 選擇預覽群組資源，擷取 AWS CloudFormation 堆疊中符合您所選資源類型的資源清單。

  7. 在 Additional information (其他資訊) 區域，您可以編輯群組描述。您不能在群組建立後編輯群組的名稱。

  8. 在 Group tags (群組標籤) 中，新增或移除標籤。群組標籤是有關資源群組的中繼資料。他們不會影響成員資源。若要變更資源群組查詢傳回的資源，在 Grouping criteria (群組條件) 編輯標籤。

    如果您計劃讓此群組成為更大群組的成員，則群組標籤很有用。至少需要指定標籤金鑰才能建立群組。因此，請務必在群組標籤中至少新增一個標籤索引鍵到您計劃巢狀到較大群組的群組。

  9. 完成時，請選擇 Save changes (儲存變更)。

AWS CLI & AWS SDKs

在 中 AWS CLI，您可以使用兩個不同的命令來更新群組的查詢，並更新資源群組的描述。您無法編輯現有群組的名稱。在 中 AWS CLI，您可以將標籤型群組變更為 CloudFormation 堆疊型群組，反之亦然。

  1. 如果您不想要變更群組的說明，請略過此步驟並移至下一個步驟。執行下列命令，將群組名稱和描述的值取代為您自己的值。

    $ aws resource-groups update-group \
    --group-name "resource-group-name" \
    --description "description_text"

    下列是範例命令。

    $ aws resource-groups update-group \
    --group-name "My-CFN-stack-group" \
    --description "EC2 instances, S3 buckets, and RDS DBs that we are using for the test stage."

    此命令會傳回完整更新的群組說明。

  2. 若要更新群組的查詢和標籤，請執行下列命令。將群組名稱、堆疊識別符和資源類型的值取代為您自己的值。若要新增資源類型，請在命令中提供完整的資源類型清單，而不僅僅您要新增的資源類型。您在查詢中最多可以有 20 個資源類型。

    stack_identifier 是堆疊 ARN，如範例命令中所示。

    $ aws resource-groups update-group-query \
    --group-name resource-group-name \
    --description "description" \
    --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

    下列是範例命令。

    $ aws resource-groups update-group-query \
    --group-name "my-resource-group" \
    --description "Updated CloudFormation stack-based group" \
    --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:810000000000:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

    此命令會傳回更新的查詢做為結果。