메뉴
Amazon Relational Database Service
사용 설명서 (API Version 2014-10-31)

Amazon RDS 리소스에 태그 지정

Amazon RDS 태그를 사용하여 Amazon RDS 리소스에 메타데이터를 추가할 수 있습니다. 또한 IAM 정책과 함께 이러한 태그를 사용하여 Amazon RDS에 대한 액세스를 관리하고 Amazon RDS 리소스에 적용 가능한 작업을 제어할 수 있습니다. 마지막으로 비슷하게 태그가 지정된 리소스에 대한 비용을 그룹화하여 이러한 태그로 비용을 추적할 수 있습니다.

모든 Amazon RDS 리소스에 태그 지정 가능

  • DB 인스턴스

  • DB 클러스터

  • 읽기 전용 복제본

  • DB 스냅샷

  • DB 클러스터 스냅샷

  • 예약 DB 인스턴스

  • 이벤트 구독

  • DB 옵션 그룹

  • DB 파라미터 그룹

  • DB 클러스터 파라미터 그룹

  • DB 보안 그룹

  • DB 서브넷 그룹

IAM 정책으로 태그가 지정된 리소스 액세스 관리에 대한 자세한 내용은 Amazon RDS에 대한 인증 및 액세스 제어 단원을 참조하십시오.

Amazon RDS 리소스 태그 개요

Amazon RDS 태그는 사용자가 정의하고 Amazon RDS 리소스와 연결하는 이름-값 페어입니다. 이 이름을 키라고 합니다. 키 값을 제공하는 것은 선택 사항입니다. 태그를 사용하여 Amazon RDS 리소스에 임의의 정보를 배정할 수 있습니다. 범주 정의 등에 태그 키를 사용할 수 있으며 태그 값은 해당 범주의 항목일 수 있습니다. 예를 들어, 태그 키를 “project”로 정의하고 태그 값을 “Salix”로 정의하여 Amazon RDS 리소스가 Salix project에 배정됨을 나타냅니다. environment=test나 environment =production 등의 키를 사용하여 태그로 Amazon RDS 리소스를 테스트나 프로덕션에 사용되는 것으로 지정할 수도 있습니다. Amazon RDS 리소스와 연결된 메타데이터를 더 쉽게 추적할 수 있게 일관성 있는 태그 키 세트를 사용하는 것이 좋습니다.

태그를 사용하여 비용 구조를 반영하도록 AWS 대금을 구성하십시오. 이렇게 하려면 가입하여 태그 키 값이 포함된 AWS 계정을 가져옵니다. 그런 다음 같은 태그 키 값을 가진 리소스에 따라 결제 정보를 구성하여 리소스 비용의 합을 볼 수 있습니다. 예를 들어, 특정 애플리케이션 이름으로 여러 리소스에 태그를 지정한 다음 결제 정보를 구성하여 여러 서비스에 걸친 해당 애플리케이션의 총 비용을 볼 수 있습니다. 자세한 내용은 About AWS Billing and Cost ManagementCost Allocation and Tagging을 참조하십시오.

각 Amazon RDS 리소스에는 해당 Amazon RDS 리소스에 배정되는 모든 태그를 포함하는 태그 세트가 있습니다. 태그 세트는 최대 10개의 태그를 포함하거나 비어 있을 수 있습니다. Amazon RDS 리소스의 기존 태그와 동일한 키를 갖는 태그를 리소스에 추가하면 새 값이 이전 값을 덮어씁니다.

AWS에서는 태그에 의미론적 의미를 적용하지 않습니다. 태그는 엄격히 문자열로 해석됩니다. Amazon RDS에서는 사용자가 리소스를 만들 때 사용하는 설정에 따라 DB 인스턴스 또는 기타 Amazon RDS 리소스에서 태그를 설정할 수 있습니다. 예를 들어 Amazon RDS에서 DB 인스턴스가 프로덕션용인지, 아니면 테스트용인지를 나타내는 태그를 추가할 수 있습니다.

  • 태그 키는 태그의 필수 이름입니다. 문자열 값은 길이가 1~128자(유니코드 문자)이며 "aws:" 또는 "rds:"로 시작할 수 없습니다. 문자열에는 유니코드 문자, 숫자, 공백, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$") 세트만 포함할 수 있습니다.

  • 태그 값은 태그의 선택적 문자열 값입니다. 문자열 값은 길이가 1~256자(유니코드 문자)이며 "aws:"로 시작할 수 없습니다. 문자열에는 유니코드 문자, 숫자, 공백, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$") 세트만 포함할 수 있습니다.

    값은 태그 세트에서 고유할 필요는 없으며 null일 수 있습니다. 예를 들어, project/Trinity 및 cost-center/Trinity의 태그 세트에 키-값 페어가 있을 수 있습니다.

AWS Management Console, 명령줄 인터페이스 또는 Amazon RDS API를 사용하여 Amazon RDS 리소스에서 태그를 추가, 나열 및 삭제할 수 있습니다. 명령줄 인터페이스나 Amazon RDS API를 사용할 때는 작업하려는 Amazon RDS 리소스에 대한 Amazon 리소스 이름(ARN)을 제공해야 합니다. ARN 생성에 대한 자세한 내용은 Amazon RDS의 ARN 구성 단원을 참조하십시오.

권한 부여 목적으로 태그가 캐시됩니다. 이 때문에 Amazon RDS 리소스의 태그에 대한 추가나 업데이트가 제공되는 데 몇 분 정도 걸릴 수 있습니다.

태그 복사

DB 인스턴스를 만들거나 복원할 경우 DB 인스턴스의 태그가 DB 인스턴스의 스냅샷으로 복사되도록 지정할 수 있습니다. 태그를 복사하면 DB 스냅샷의 메타데이터가 원본 DB 인스턴스의 메타데이터와 일치하고, DB 스냅샷의 액세스 정책 또한 원본 DB 인스턴스의 액세스 정책과 일치합니다. 태그는 기본적으로 복사되지 않습니다.

다음 작업 시 DB 스냅샷으로 태그를 복사하도록 지정할 수 있습니다.

  • DB 인스턴스 생성

  • DB 인스턴스 복원

  • 읽기 전용 복제본 생성.

  • DB 스냅샷 복사

참고

create-db-snapshot AWS CLI 명령의 --tag-key 파라미터에 값을 포함시킬 경우(또는 CreateDBSnapshot API 작업에 한 개 이상의 태그를 제공할 경우) RDS는 원본 DB 인스턴스의 태그를 새 DB 스냅샷으로 복사하지 않습니다. 이 기능은 원본 DB 인스턴스에 --copy-tags-to-snapshot(CopyTagsToSnapshot) 옵션이 활성화되어 있어도 적용됩니다. 이 방법을 사용할 경우 새로운 DB 인스턴스에 적용되지 않는 태그를 추가하지 않고 DB 스냅샷으로부터 DB 인스턴스의 사본을 만들 수 있습니다. AWS CLI create-db-snapshot 명령(또는 CreateDBSnapshot Amazon RDS API 작업)을 사용하여 DB 스냅샷을 생성했을 경우 이 항목의 뒷부분에서 설명한 대로 태그를 추가할 수 있습니다.

AWS Management Console

Amazon RDS 리소스에 태그를 지정하는 프로세스는 모든 리소스에서 비슷합니다. 다음 절차에서는 Amazon RDS DB 인스턴스에 태그를 지정하는 방법을 보여줍니다.

DB 인스턴스에 태그를 추가하려면

  1. AWS Management Console에 로그인한 다음 https://console.aws.amazon.com/rds/에서 Amazon RDS 콘솔을 엽니다.

  2. 탐색 창에서 [Instances]를 선택합니다.

    참고

    [DB Instances] 창에서 DB 인스턴스 목록을 필터링하려면 [Viewing] 상자 옆의 상자에 텍스트 문자열을 입력합니다. 해당 문자열을 포함하는 DB 인스턴스만 표시됩니다.

  3. 태그를 지정하려는 DB 인스턴스를 선택합니다. 그러면 인라인 요약이 표시됩니다.

  4. 인라인 요약에서 세부 정보 아이콘을 선택하여 세부 정보 섹션을 엽니다.

     콘솔 세부 정보 아이콘
  5. 세부 정보 섹션에서 아래로 스크롤해 [Tags]를 선택하여 태그 섹션을 엽니다.

  6. [Add/Edit Tags]를 선택합니다. 태그 DB 인스턴스 창이 표시됩니다.

     콘솔 태그 DB 인스턴스 창
  7. [Add another Tag]를 선택합니다.

  8. 태그에 대한 키와 값을 입력한 다음, Save Tags를 선택합니다.

DB 인스턴스에서 태그를 삭제하려면

  1. AWS Management Console에 로그인한 다음 https://console.aws.amazon.com/rds/에서 Amazon RDS 콘솔을 엽니다.

  2. 탐색 창에서 Instances를 클릭합니다.

    참고

    [DB Instances] 창에서 DB 인스턴스 목록을 필터링하려면 [Viewing] 상자 옆의 상자에 텍스트 문자열을 입력합니다. 해당 문자열을 포함하는 DB 인스턴스만 표시됩니다.

  3. 태그를 제거하고자 하는 DB 인스턴스를 선택합니다. 그러면 인라인 요약이 표시됩니다.

  4. 인라인 요약에서 세부 정보 아이콘을 선택하여 세부 정보 섹션을 엽니다.

     콘솔 세부 정보 아이콘
  5. 세부 정보 섹션에서 아래로 스크롤해 [Tags]를 선택하여 태그 섹션을 엽니다.

  6. [Add/Edit Tags]를 선택합니다. 태그 DB 인스턴스 창이 표시됩니다.

     콘솔 태그 DB 인스턴스 창
  7. 삭제하고자 하는 태그 옆의 [Remove] 열에서 빨간색 "X"를 선택한 다음, [Save Tags]를 선택합니다.

CLI

AWS CLI를 사용하여 DB 인스턴스에 대한 태그를 추가, 나열 또는 제거할 수 있습니다.

  • Amazon RDS 리소스에 하나 이상의 태그를 추가하려면 AWS CLI 명령인 add-tags-to-resource를 사용합니다.

  • Amazon RDS 리소스의 태그를 나열하려면 AWS CLI 명령인 list-tags-for-resource를 사용합니다.

  • Amazon RDS 리소스에서 하나 이상의 태그를 삭제하려면 AWS CLI 명령인 remove-tags-from-resource를 사용합니다.

필수 ARN을 생성하는 방법에 대해 자세히 알아보려면 Amazon RDS의 ARN 구성 단원을 참조하십시오.

API

Amazon RDS API를 사용하여 DB 인스턴스에 대한 태그를 추가, 나열 또는 제거할 수 있습니다.

  • Amazon RDS 리소스에 태그를 추가하려면 AddTagsToResource 작업을 사용합니다.

  • Amazon RDS 리소스에 배정된 태그를 나열하려면 ListTagsForResource를 사용합니다.

  • Amazon RDS 리소스에서 태그를 제거하려면 RemoveTagsFromResource 작업을 사용합니다.

필수 ARN을 생성하는 방법에 대해 자세히 알아보려면 Amazon RDS의 ARN 구성 단원을 참조하십시오.

Amazon RDS API를 사용한 XML 작업 시 다음 스키마를 사용하십시오.

Copy
<Tagging> <TagSet> <Tag> <Key>Project</Key> <Value>Trinity</Value> </Tag> <Tag> <Key>User</Key> <Value>Jones</Value> </Tag> </TagSet> </Tagging>

다음 표에는 허용되는 XML 태그와 해당 특성의 목록이 나와 있습니다. Key 및 Value 값은 대/소문자를 구분합니다. 예를 들어, project=Trinity와 PROJECT=Trinity는 서로 다른 두 개의 태그입니다.

태그 지정 요소 설명
TagSet 태그 세트에는 Amazon RDS 리소스에 배정된 모든 태그가 포함됩니다. 리소스당 하나의 태그 세트만 있을 수 있습니다. Amazon RDS API를 통해서만 TagSet로 작업합니다.
Tag 태그는 사용자가 정의하는 키-값 페어입니다. 태그 세트에 1~50개의 태그가 있을 수 있습니다.

키는 태그의 필수 이름입니다. 문자열 값은 길이가 1~128자(유니코드 문자)이며 "rds:" 또는 "aws:"로 시작할 수 없습니다. 문자열에는 유니코드 문자, 숫자, 공백, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$") 세트만 포함할 수 있습니다.

키는 태그 집합에 대해 고유해야 합니다. 예를 들어, 태그 세트에 project/Trinity와 project/Xanadu처럼 키는 같지만 값은 다른 키-페어가 있을 수 없습니다.

값은 태그의 선택적 값입니다. 문자열 값은 길이가 1~256자(유니코드 문자)이며 "rds:" 또는 "aws:"로 시작할 수 없습니다. 문자열에는 유니코드 문자, 숫자, 공백, '_', '.', '/', '=', '+', '-' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$") 세트만 포함할 수 있습니다.

값은 태그 세트에서 고유할 필요는 없으며 null일 수 있습니다. 예를 들어, project/Trinity 및 cost-center/Trinity의 태그 세트에 키-값 페어가 있을 수 있습니다.

관련 주제