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

# 建立 CloudFormation 堆疊型群組
<a name="gettingstarted-query-stack-based"></a>

下列程序說明如何建置堆疊型查詢，並使用它來建立資源群組。

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

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

1. 在導覽窗格中，選擇**[建立資源群組](https://console.aws.amazon.com/resource-groups/groups/new)**。

1. 在**建立查詢型群組**的**群組類型**下，選擇 **CloudFormation 堆疊型**群組類型。

1. 選擇您想要成為您的群組基礎的堆疊。一個資源群組只能根據一個堆疊。若要篩選堆疊的清單，請從輸入堆疊的名稱開始。只有具有支援狀態的堆疊會顯示在清單中。

1. 選擇堆疊中您想要包含在群組中的資源類型。針對此逐步解說，保留預設值，**All supported resource types (所有支援的資源類型)**。如需支援及可在群組中的資源類型的詳細資訊，請參閱[您可以搭配 AWS Resource Groups 和 標籤編輯器使用的資源類型](supported-resources.md)。

1. 選擇**檢視群組資源**，以傳回 CloudFormation 堆疊中符合您所選資源類型的資源清單。

1. 取得您想要的結果後，請根據此查詢建立群組。

   1. 在**群組詳細資訊**下，針對**群組名稱**，輸入資源群組的名稱。

      資源群組名稱最多可有 128 個字元，包括字母、數字、連字號、句點和底線。名稱開頭不可是 `AWS` 或 `aws`。這些是預留字。資源群組名稱在您帳戶中的目前區域中必須是唯一的。

   1. (選用) 在 **Group description (群組描述)** 中，輸入群組的描述。

   1. (選用) 在 **Group tags (群組標籤)** 中，新增只適用於資源群組 (而非群組中的成員資源) 的標籤索引鍵和值組。

      如果您計劃讓此群組成為更大群組的成員，則群組標籤很有用。因為建立群組需要指定至少一個標籤索引鍵，請確保在 **Group tags (群組標籤)** 中將至少一個標籤索引鍵新增至您計劃要巢狀組合成更大群組的群組。

1. 完成後，請選擇**建立群組**。

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

 CloudFormation 堆疊型群組是以類型 的查詢為基礎`CLOUDFORMATION_STACK_1_0`。

1. 執行下列命令，將群組名稱、描述、堆疊識別符和資源類型的值取代為您自己的值。描述最多可有 512 個字元，包括字母、數字、連字號、底線、標點符號和空格。

   如果您未指定資源類型，資源群組會在堆疊中包含所有支援的資源類型。您在查詢中最多可以有 20 個資源類型。資源群組名稱最多可有 128 個字元，包括字母、數字、連字號、句點和底線。名稱開頭不可是 `AWS` 或 `aws`。這些是預留字。資源群組名稱在您的帳戶中必須是唯一的。

   *stack\$1identifier* 是堆疊 ARN，如範例命令中所示。

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

   下列是範例命令。

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

1. 以下是回應命令而傳回的。
   + 您已建立之群組的完整說明。
   + 您用來建立群組的資源查詢。

------