기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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 청구 및 비용 관리 사용 설명서*의 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하십시오.
각 Amazon DocumentDB 리소스에는 해당 리소스에 할당된 모든 태그가 포함된 태그 세트가 있습니다. 태그 세트는 최대 10개의 태그를 포함하거나 비어 있을 수 있습니다. 리소스의 기존 태그와 동일한 키를 가진 Amazon DocumentDB 리소스에 태그를 추가하면 새 값이 이전 값을 덮어씁니다.
AWS는 태그에 의미론적 의미를 적용하지 않으며 태그는 엄격히 문자열로 해석됩니다. Amazon DocumentDB는 리소스를 생성할 때 사용하는 설정에 따라 인스턴스 또는 다른 Amazon DocumentDB 리소스에 태그를 설정할 수 있습니다. 예를 들어, Amazon DocumentDB는 인스턴스가 생산용 또는 테스트용임을 나타내는 태그를 추가할 수 있습니다.
스냅샷에 태그를 추가할 수 있지만 이 그룹화는 청구서에 반영되지 않습니다.
AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 리소스에 태그를 추가, 나열 및 삭제할 수 있습니다. AWS CLI를 사용할 때는 작업하려는 리소스에 대한 Amazon 리소스 이름(ARN)을 제공해야 합니다. Amazon DocumentDB ARN에 대한 자세한 내용은 [Amazon DocumentDB Amazon 리소스 이름(ARN) 이해](documentdb-arns.md) 섹션을 참조하십시오.
## 태그 제약 조건
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](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 추가할 클러스터 이름을 선택합니다.
1. **태그** 섹션으로 스크롤을 내린 다음 **편집**을 선택합니다.
1. 이 리소스에 추가할 각 태그에 대해 다음을 수행합니다.
1. 새 태그를 추가하려면 **키** 상자의 태그 이름에 입력합니다. 태그 값을 변경하려면 **키** 열에서 태그 이름을 찾습니다.
1. 태그에 새 값 또는 업데이트된 값을 제공하려면 **값** 상자에 태그에 대한 값을 입력합니다.
1. 태그를 더 추가하려는 경우 **추가**를 선택합니다. 추가하지 않고 완료하려면 **저장**을 선택합니다.
------
#### [ Using the AWS CLI ]
리소스에 태그를 추가하는 프로세스는 태그를 추가하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 세 개의 태그를 추가합니다. 두 번째 태그인 `key2`에는 값이 없습니다.
이러한 파라미터와 함께 AWS CLI 작업 `add-tags-to-resource`를 사용합니다.
**파라미터**
+ **--resource-name** - 태그를 추가할 Amazon DocumentDB 리소스의 ARN입니다.
+ **--tags** - 이 리소스에 추가할 태그(키-값 페어)를 `Key=key-name,Value=tag-value` 형식으로 나열합니다.
**Example**
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](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 나열할 클러스터 이름을 선택합니다.
1. 이 리소스의 태그 목록을 보려면 아래로 스크롤하여 **태그** 섹션으로 이동합니다.
------
#### [ Using the AWS CLI ]
리소스에서 태그를 나열하는 프로세스는 태그를 나열하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에 태그를 나열합니다.
이러한 파라미터와 함께 AWS CLI 작업 `list-tags-for-resource`를 사용합니다.
**파라미터**
+ **--resource-name** - 필수입니다. 태그를 나열할 Amazon DocumentDB 리소스의 ARN입니다.
**Example**
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](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 태그를 제거할 클러스터 이름을 선택합니다.
1. **태그** 섹션으로 스크롤을 내린 다음 **편집**을 선택합니다.
1. 이 리소스에서 모든 태그를 제거하려면 **모두 제거**를 선택합니다. 그렇지 않으면, 이 리소스에서 제거할 각 태그에 대해 다음을 수행합니다.
1. **키** 열에서 태그 이름을 찾습니다.
1. 태그 키와 동일한 행에서 **제거**를 선택합니다.
1. 완료하였으면 **저장**을 선택합니다.
------
#### [ Using the AWS CLI ]
리소스에서 태그를 제거하는 프로세스는 태그를 제거하는 리소스에 관계없이 비슷합니다. 이 예에서는 클러스터에서 태그를 제거합니다.
이러한 파라미터와 함께 AWS CLI 작업 `remove-tags-from-resource`를 사용합니다.
+ **--resource-name** - 필수입니다. 태그를 제거할 Amazon DocumentDB 리소스의 ARN입니다.
+ **--tag-keys** - 필수입니다. 이 리소스에서 제거할 태그 키의 목록입니다.
**Example**
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` 작업을 사용합니다.
------