

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

# 在 中更新群組 AWS Resource Groups
<a name="updating-resource-groups"></a>

若要更新資源群組中的標籤型資源群組，您可以編輯群組基礎的查詢和標籤。您只能透過套用查詢或標籤的變更，從群組中新增和移除資源。您無法選取要新增至群組或從群組中移除的特定資源。從群組新增或移除特定資源的最佳方法是編輯資源的標籤。然後，驗證您的資源群組標籤查詢是否包含或省略標籤，具體取決於您是否想要群組中的資源。

若要更新 CloudFormation 堆疊型資源群組，您可以選擇不同的堆疊。您也可以從要成為群組一部分的堆疊中新增或移除資源類型。若要變更堆疊中可用的資源，請更新用來建立堆疊的 CloudFormation 範本，然後在其中更新堆疊 CloudFormation。如需如何更新 CloudFormation 堆疊的詳細資訊，請參閱《 使用者指南》中的[CloudFormation 堆疊更新](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html)。 *CloudFormation *

在 中 AWS CLI，您會在兩個命令中更新群組。
+ `update-group`，您會執行此命令來更新群組說明。
+ `update-group-query`，您會執行此命令來更新資源查詢和標籤，標籤會決定群組成員的資源。

在 主控台中，您無法將 CloudFormation 堆疊型群組變更為標籤型查詢群組，反之亦然。不過，您可以使用 資源群組 API 來執行此操作，包括在 中 AWS CLI。

# 更新標籤型查詢群組
<a name="updating-tag-based-resource-groups"></a>

下列程序說明如何更新標籤型查詢群組。

------
#### [ Console ]

變更群組所依據的查詢中的資源類型或標籤，來更新以標籤為基礎的群組。您也可以新增或變更群組的描述。

1. 登入 [AWS Resource Groups 主控台](https://console.aws.amazon.com/resource-groups)。

1. 在導覽窗格**[的已儲存資源群組](https://console.aws.amazon.com/resource-groups/groups)**下，選擇群組的名稱，然後選擇**編輯**。
**注意**  
您只能更新您擁有的資源群組。**擁有者**欄顯示每個資源群組的帳戶擁有權。您登入帳戶擁有者以外的任何群組都會建立 AWS License Manager。如需詳細資訊，請參閱《 *License Manager 使用者指南*》中的在 中[託管資源群組 AWS License Manager](https://docs.aws.amazon.com//license-manager/latest/userguide/host-resource-groups.html)。

1. 在**編輯群組**頁面的**分組條件**下，新增或移除資源類型。您在查詢中最多可以有 20 個資源類型。若要移除資源類型，選擇資源類型標籤上的 **X**。選擇 **View group resources (檢視群組資源)** 以查看該變更如何影響您的資源群組成員。在此逐步解說中，我們會將資源類型 **AWS::RDS::DBInstance** 新增至查詢。

1. 仍在**分組條件**下，視需要編輯標籤。在這個範例中，我們對擁有 **Stage (階段)** 標籤索引鍵的資源進行篩選並新增 **Test (測試)** 的標籤值。標籤值是選用的，但可以進一步縮小查詢的結果。若要移除標籤，請選擇標籤的標記上的 **X**。

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

1. （選用） 在**群組標籤**中，您可以新增或移除標籤。群組標籤是有關資源群組的中繼資料。他們不會影響成員資源。若要變更資源群組查詢傳回的資源，請編輯**分組條件**下的標籤。

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

1. 選擇**預覽群組資源**，以擷取您帳戶中符合指定標籤索引鍵之 EC2 執行個體、S3 儲存貯體和 Amazon RDS 資料庫執行個體的更新清單。如果您沒有在預期的清單中看到資源，請確定系統使用您在 **Grouping criteria (群組條件)** 中指定之標籤為資源加上標籤。

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

------
#### [ AWS CLI & AWS SDKs ]

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

1. 如果您不想要變更群組的說明，請略過此步驟並移至下一個步驟。在 AWS CLI 工作階段中，輸入以下內容，然後按 **Enter**，將群組名稱和描述的值取代為您自己的值。

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

   下列是範例命令。

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

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

1. 若要更新群組的查詢和標籤，請輸入下列命令。將群組名稱、資源類型、標籤索引鍵和標籤值的值取代為您自己的值。然後，pres **Enter**。您在查詢中最多可以有 20 個資源類型。

   ```
   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"],\"TagFilters\":[{\"Key\":\"Key1\",\"Values\":[\"Value1\",\"Value2\"]},{\"Key\":\"Key2\",\"Values\":[\"Value1\",\"Value2\"]}]}"}'
   ```

   下列是範例命令。

   ```
   $ aws resource-groups update-group-query \
       --group-name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\",\"AWS::RDS::DBInstance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'
   ```

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

------

# 更新 CloudFormation 堆疊型群組
<a name="updating-stack-based-resource-groups"></a>

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

------
#### [ Console ]

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

1. 登入 [AWS Resource Groups 主控台](https://console.aws.amazon.com/resource-groups)。

1. 在導覽窗格**[的已儲存資源群組](https://console.aws.amazon.com/resource-groups/groups)**下，選擇群組的名稱，然後選擇**編輯**。

1. 
**注意**  
您只能更新您擁有的資源群組。**擁有者**欄顯示每個資源群組的帳戶擁有權。您登入帳戶擁有者以外的任何群組都會建立 AWS License Manager。如需詳細資訊，請參閱《 *License Manager 使用者指南*》中的在 中[託管資源群組 AWS License Manager](https://docs.aws.amazon.com//license-manager/latest/userguide/host-resource-groups.html)。

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

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

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

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

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

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

1. 完成時，請選擇 **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."
   ```

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

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

   *stack\$1identifier* 是堆疊 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\"]}"}'
   ```

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

------