Amazon DocumentDB 리소스 태깅

Amazon DocumentDB(MongoDB 호환) 태그를 사용하여 Amazon DocumentDB 리소스에 메타데이터를 추가할 수 있습니다. 이러한 태그는 AWS Identity and Access Management(IAM) 정책과 함께 사용하여 Amazon DocumentDB 리소스에 대한 액세스를 관리하고 리소스에 적용할 수 있는 작업을 제어할 수 있습니다. 또한 비슷하게 태그가 지정된 리소스에 대한 비용을 그룹화하여 이러한 태그로 비용을 추적할 수 있습니다.

다음 Amazon DocumentDB 리소스에 태그를 지정할 수 있습니다.

• 클러스터

• 인스턴스

• 스냅샷

• 클러스터 스냅샷

• 파라미터 그룹

• 클러스터 파라미터 그룹

• 보안 그룹

• 서브넷 그룹 수

Amazon DocumentDB 리소스 태그 개요

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

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

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

AWS는 태그에 의미론적 의미를 적용하지 않으며 태그는 엄격히 문자열로 해석됩니다. Amazon DocumentDB는 리소스를 생성할 때 사용하는 설정에 따라 인스턴스 또는 다른 Amazon DocumentDB 리소스에 태그를 설정할 수 있습니다. 예를 들어, Amazon DocumentDB는 인스턴스가 생산용 또는 테스트용임을 나타내는 태그를 추가할 수 있습니다.

스냅샷에 태그를 추가할 수 있지만 이 그룹화는 청구서에 반영되지 않습니다.

AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에 태그를 추가, 나열 및 삭제할 수 있습니다. AWS CLI를 사용할 때는 작업하려는 리소스에 대한 ARN(Amazon 리소스 이름)을 제공해야 합니다. Amazon DocumentDB ARN에 대한 자세한 내용은 Amazon DocumentDB Amazon 리소스 이름(ARN) 이해 단원을 참조하십시오.

태그 제약

Amazon DocumentDB 태그에는 다음 제약 조건이 적용됩니다.

• 리소스당 최대 태그 수 - 10개

• 최대 키 길이 - 유니코드 128자

• 최대 값 길이 - 유니코드 256자

• 키 및 값에 유효한 문자 - UTF-8 문자 세트의 대문자와 소문자, 숫자, 공백 및 _ . : / = + -와 @ 문자(Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$")

• 태그 키와 값은 대/소문자를 구분합니다.

• 태그 키 또는 값에 aws: 접두사는 사용할 수 없습니다. 이 접두사는 AWS 전용입니다.

Amazon DocumentDB 리소스의 태그 추가 및 업데이트

AWS Management Console 또는 AWS CLI를 사용하여 리소스에 최대 10개의 태그를 추가할 수 있습니다.

Using the AWS Management Console

리소스에 태그를 추가하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 추가합니다.

콘솔을 사용하여 클러스터에 태그를 추가하거나 업데이트하려면 다음을 수행합니다.

1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/docdb에서 Amazon DocumentDB 콘솔을 엽니다.

2. 탐색 창에서 클러스터를 선택합니다.

3. 태그를 추가할 클러스터 이름을 선택합니다.

4. 태그 섹션으로 스크롤을 내린 다음 편집을 선택합니다.

5. 이 리소스에 추가할 각 태그에 대해 다음을 수행합니다.

   1. 새 태그를 추가하려면 키 상자의 태그 이름에 입력합니다. 태그 값을 변경하려면 키 열에서 태그 이름을 찾습니다.

   2. 태그에 새 값 또는 업데이트된 값을 제공하려면 값 상자에 태그에 대한 값을 입력합니다.

   3. 태그를 더 추가하려는 경우 추가를 선택합니다. 추가하지 않고 완료하려면 저장을 선택합니다.

Using the AWS CLI

리소스에 태그를 추가하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 세 개의 태그를 추가합니다. 두 번째 태그인 key2에는 값이 없습니다.

이러한 파라미터와 함께 AWS CLI 작업 add-tags-to-resource를 사용합니다.

파라미터

• --resource-name—태그를 추가할 Amazon DocumentDB 리소스의 ARN입니다.

• --tags—이 리소스에 추가할 태그(키-값 쌍)를 Key=key-name,Value=tag-value 형식으로 나열합니다.

Linux, macOS 또는 Unix의 경우:

aws docdb add-tags-to-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

Windows의 경우:

aws docdb add-tags-to-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tags Key=key1,Value=value1 Key=key2 Key=key3,Value=value3

add-tags-to-resource 작업은 출력을 생성하지 않습니다. 작업 결과를 보려면 list-tags-for-resource 작업을 사용합니다.

Amazon DocumentDB 리소스에 태그 나열

AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에 대한 태그 목록을 가져올 수 있습니다.

Using the AWS Management Console

리소스에서 태그를 나열하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 나열합니다.

콘솔을 사용하여 클러스터에서 태그를 나열하려면

1. https://console.aws.amazon.com/docdb에서 Amazon DocumentDB 콘솔을 엽니다.

2. 탐색 창에서 클러스터를 선택합니다.

3. 태그를 나열할 클러스터 이름을 선택합니다.

4. 이 리소스의 태그 목록을 보려면 아래로 스크롤하여 태그 섹션으로 이동합니다.

Using the AWS CLI

리소스에서 태그를 나열하는 프로세스는 태그를 나열하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 나열합니다.

이러한 파라미터와 함께 AWS CLI 작업 list-tags-for-resource를 사용합니다.

파라미터

• --resource-name — 필수입니다. 태그를 나열할 Amazon DocumentDB 리소스의 ARN입니다.

Linux, macOS 또는 Unix의 경우:

aws docdb list-tags-for-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

Windows의 경우:

aws docdb list-tags-for-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster

이 작업의 출력은 다음과 같습니다(JSON 형식).

{
    "TagList": [
        {
            "Key": "key1",
            "Value": "value1"
        },
        {
            "Key": "key2",
            "Value": ""
        },
        {
            "Key": "key3",
            "Value": "value3"
        }
    ]
}

Amazon DocumentDB 리소스에서 태그 제거

AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에서 태그를 제거할 수 있습니다.

Using the AWS Management Console

리소스에서 태그를 제거하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에서 태그를 제거합니다.

콘솔을 사용하여 클러스터에서 태그를 제거하려면

1. https://console.aws.amazon.com/docdb에서 Amazon DocumentDB 콘솔을 엽니다.

2. 탐색 창에서 클러스터를 선택합니다.

3. 태그를 제거할 클러스터 이름을 선택합니다.

4. 태그 섹션으로 스크롤을 내린 다음 편집을 선택합니다.

5. 이 리소스에서 모든 태그를 제거하려면 모두 제거를 선택합니다. 그렇지 않으면, 이 리소스에서 제거할 각 태그에 대해 다음을 수행합니다.

   1. 키 열에서 태그 이름을 찾습니다.

   2. 태그 키와 동일한 행에서 제거를 선택합니다.

   3. 완료한 경우 저장을 선택합니다.

Using the AWS CLI

리소스에서 태그를 제거하는 프로세스는 태그를 제거하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에서 태그를 제거합니다.

이러한 파라미터와 함께 AWS CLI 작업 remove-tags-from-resource를 사용합니다.

• --resource-name — 필수입니다. 태그를 제거할 Amazon DocumentDB 리소스의 ARN입니다.

• --tag-keys — 필수입니다. 이 리소스에서 제거할 태그 키의 목록입니다.

Linux, macOS 또는 Unix의 경우:

aws docdb remove-tags-from-resource \
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

Windows의 경우:

aws docdb remove-tags-from-resource ^
    --resource-name arn:aws:rds:us-east-1:1234567890:cluster:sample-cluster \
    --tag-keys key1 key3

removed-tags-from-resource 작업은 출력을 생성하지 않습니다. 작업 결과를 보려면 list-tags-for-resource 작업을 사용합니다.