태그 기반 쿼리 작성 및 그룹 생성

다음 절차는 태그 기반 쿼리를 작성하고 이를 사용하여 리소스 그룹을 만드는 방법을 보여줍니다.

Console

1. AWS Resource Groups 콘솔에 로그인합니다.

2. 탐색 창에서 보안 그룹 생성을 선택합니다.

3. 쿼리 기반의 그룹 생성 페이지의 그룹 유형에서 태그 기반 그룹 유형을 선택합니다.

4. 그룹화 기준에서 리소스 그룹에 포함할 리소스 유형을 선택합니다. 한 쿼리에 최대 20개 리소스 유형을 가질 수 있습니다. 이 연습에서는 AWS::EC2::Instance 및 AWS::S3::Bucket을 선택합니다.

5. 여전히 그룹화 기준에 있는 상태에서 태그에 태그 키 또는 태그 키/값 쌍을 지정하여 일치하는 리소스가 지정된 값으로 태그가 지정된 리소스만 포함하도록 제한합니다. 태그 지정을 마쳤으면 추가를 선택하거나 Enter를 누릅니다. 이 예에서는 Stage라는 태그 키를 가진 리소스를 필터링합니다. 태그 값은 선택 사항이지만 쿼리 결과를 더욱 좁힐 수 있습니다. 태그 값 사이에 OR 연산자를 추가하여 태그 키에 여러 값을 추가할 수 있습니다. 태그를 추가하려면 추가를 선택합니다. 쿼리는 태그에 AND 연산자를 추가하여 지정한 리소스 유형 및 지정된 모든 태그와 일치하는 리소스가 쿼리를 통해 반환됩니다.

6. 여전히 그룹화 기준에 있는 상태에서 그룹 리소스 미리 보기를 선택하면 해당 계정에서, 지정된 태그 키와 일치하는 EC2 인스턴스 및 S3 버킷 목록이 반환됩니다.

7. 원하는 결과를 얻었으면 이 쿼리를 기반으로 그룹을 만듭니다.

   1. 그룹 세부 정보에서그룹 이름에 리소스 그룹의 이름을 입력합니다.

      리소스 그룹 이름은 문자, 숫자, 하이픈, 점, 밑줄을 포함할 수 있으며 최대 128자입니다. AWS 또는 aws로 시작하는 이름을 사용할 수 없습니다. 이러한 이름은 예약되어 있습니다. 리소스 그룹 이름은 해당 계정의 현재 리전에서 고유해야 합니다.

   2. (선택 사항) 그룹 설명에 그룹에 대한 설명을 입력합니다.

   3. (선택 사항) 그룹 태그에 그룹의 구성원 리소스가 아니라 해당 리소스 그룹에만 적용되는 태그 키와 값 페어를 추가합니다.

      그룹 태그는 이 그룹을 더 큰 그룹의 구성원으로 만들려고 할 때 유용합니다. 그룹을 만들려면 태그 키를 1개 이상 지정해야 하므로 더 큰 그룹에 포함시키려는 그룹에 Group tags(그룹 태그)의 태그 키를 1개 이상 추가해야 합니다.

8. 모두 마쳤으면 그룹 생성을 선택합니다.

AWS CLI & AWS SDKs

태그 기반 그룹은 유형 TAG_FILTERS_1_0의 쿼리에 기반합니다.

1. AWS CLI 세션에서 다음을 입력한 다음 Enter 키를 눌러 그룹 이름, 설명, 리소스 유형, 태그 키 및 태그 값의 값을 자신의 값으로 바꿉니다. 설명은 문자, 숫자, 하이픈, 밑줄, 구두점 및 공간을 포함할 수 있으며 최대 512자입니다. 한 쿼리에 최대 20개 리소스 유형을 가질 수 있습니다. 리소스 그룹 이름은 문자, 숫자, 하이픈, 점, 밑줄을 포함할 수 있으며 최대 128자입니다. AWS 또는 aws로 시작하는 이름을 사용할 수 없습니다. 이러한 이름은 예약되어 있습니다. 리소스 그룹 이름은 해당 계정에서 고유해야 합니다.

   ResourceTypeFilters에 하나 이상의 값이 필요합니다. 모든 리소스 유형을 지정하려면 AWS::AllSupported를 ResourceTypeFilters 값으로 사용합니다.

   $ aws resource-groups create-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 create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   다음 명령은 지원되는 모든 리소스 유형을 포함하는 예제입니다.

   $ aws resource-groups create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

2. 명령을 실행하면 다음이 반환됩니다.

   • 생성한 그룹에 대한 설명

   • 그룹을 만들 때 사용한 리소스 쿼리

   • 그룹과 연결된 태그