기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# MemoryDB 리소스 태그 지정
클러스터 및 기타 MemoryDB 리소스 관리를 돕기 위해 태그 형식으로 각 리소스에 고유한 메타데이터를 할당할 수 있습니다. 태그를 사용하면 용도, 소유자 또는 환경을 기준으로 하는 등 AWS 리소스를 다양한 방식으로 분류할 수 있습니다. 이 기능은 동일 유형의 리소스가 많을 때 유용합니다. 지정한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 이 주제에서는 태그를 설명하고 태그를 생성하는 방법을 보여줍니다.
**주의**
민감한 데이터를 태그에 포함하지 않는 것이 가장 좋습니다.
## 태그 기본 사항
태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그를 사용하면 용도, 소유자 등을 기준으로 AWS 리소스를 다양한 방식으로 분류할 수 있습니다. 예를 들어, 계정의 MemoryDB 클러스터에 대해 각 클러스터의 소유자와 사용자 그룹을 추적하는 데 도움이 되는 태그 세트를 정의할 수 있습니다.
각 리소스 유형에 대한 요건을 충족하는 태그 키 세트를 고안하는 것이 좋습니다. 일관된 태그 키 세트를 사용하면 리소스를 보다 쉽게 관리할 수 있습니다. 추가하는 태그에 따라 리소스를 검색하고 필터링할 수 있습니다. 효과적인 리소스 태그 지정 전략을 구현하는 방법에 대한 자세한 정보는 [AWS 백서 태그 지정 모범 사례](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)를 참조하세요.
태그는 MemoryDB에는 의미가 없으며 엄격하게 문자열로 해석됩니다. 또한 태그는 리소스에 자동으로 배정되지 않습니다. 태그 키와 값을 편집할 수 있으며 언제든지 리소스에서 태그를 제거할 수 있습니다. 태그의 값을 `null`로 설정할 수 있습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.
AWS Management Console, AWS CLI, MemoryDB API를 사용하여 태그 관련 작업을 수행할 수 있습니다.
IAM을 사용하는 경우 AWS 계정에서 태그를 생성, 편집 또는 삭제할 수 있는 권한이 있는 사용자를 제어할 수 있습니다. 자세한 내용은 [리소스 수준 권한](iam.resourcelevelpermissions.md) 섹션을 참조하세요.
## 태그 지정이 가능한 리소스
계정에 이미 존재하는 대부분의 MemoryDB 리소스에 태그를 지정할 수 있습니다. 아래의 표에는 태그 지정을 지원하는 리소스가 나와 있습니다. AWS Management Console을 사용 중인 경우 [Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)를 사용하여 리소스에 태그를 적용할 수 있습니다. 일부 리소스 화면을 사용하면 리소스를 생성할 때 리소스에 대해 태그를 지정할 수 있습니다. 예를 들어 Name의 키가 있는 태그와 지정하는 값이 있습니다. 대부분의 경우, 콘솔은 리소스 생성 직후(리소스 생성 중이 아니라) 태그를 적용합니다. 콘솔은 **Name** 태그에 따라 리소스를 조직할 수 있지만 이 태그는 MemoryDB 서비스에 대한 의미가 없습니다.
또한 일부 리소스 생성 작업에서는 리소스 생성 시 리소스의 태그를 지정할 수 있습니다. 리소스 생성 도중 태그를 적용할 수 없는 경우, 리소스 생성 프로세스가 롤백됩니다. 이는 태그를 사용하여 리소스가 생성되거나 아예 리소스가 생성되지 않도록 하고 언제든 태그 지정되지 않은 리소스가 남지 않게 합니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다.
Amazon MemoryDB API, AWS CLI 또는 AWS SDK를 사용 중인 경우 관련 MemoryDB API 작업의 `Tags` 파라미터를 사용하여 태그를 적용할 수 있습니다. 스크립트는 다음과 같습니다.
+ `CreateCluster`
+ `CopySnapshot`
+ `CreateParameterGroup`
+ `CreateSubnetGroup`
+ `CreateSnapshot`
+ `CreateACL`
+ `CreateUser`
+ `CreateMultiRegionCluster`
다음 표는 태그를 지정할 수 있는 MemoryDB 리소스와 MemoryDB API, AWS CLI 또는 AWS SDK를 사용하여 생성 시 태그를 지정할 수 있는 리소스를 설명합니다.
**MemoryDB 리소스 태그 지정 지원**
| 리소스 | 태그 지원 | 생성 시 태그 지정 지원 |
| --- | --- | --- |
| parametergroup | 예 | 예 |
| subnetgroup | 예 | 예 |
| 클러스터 | 예 | 예 |
| snapshot | 예 | 예 |
| user | 예 | 예 |
| acl | 예 | 예 |
| multiregioncluster | 예 | 예 |
생성 시 태그를 지원하는 MemoryDB API 작업에 IAM 정책의 태그 기반 리소스 수준 권한을 적용하여 생성 시 리소스에 태그를 지정할 수 있는 사용자와 그룹을 세밀하게 제어할 수 있습니다. 리소스를 생성하면 태그가 즉시 적용되기 때문에 생성 단계부터 리소스를 적절하게 보호할 수 있습니다. 따라서 태그를 기반으로 리소스 사용을 제어하는 리소스 수준 권한이 즉시 발효됩니다. 이에 따라 더욱 정확한 리소스 추적 및 보고가 가능합니다. 새 리소스에서 태그 지정 사용을 적용하고 리소스에서 어떤 태그 키와 값이 설정되는지 제어할 수 있습니다.
자세한 내용은 [리소스에 태그 지정 예제](#tagging-your-resources-example) 섹션을 참조하세요.
결제를 위한 리소스 태그 지정에 대한 자세한 내용은 [비용 할당 태그를 사용하여 비용 모니터링](tagging.md) 섹션을 참조하세요.
## 클러스터 및 스냅샷과 Multi-Region 클러스터에 태그 지정
태그 지정에는 요청 작업의 일부로 다음 규칙이 적용됩니다.
+ **CreateCluster** :
+ `--cluster-name`이 제공된 경우:
태그가 요청에 포함되어 있으면 클러스터에 태그가 지정됩니다.
+ `--snapshot-name`이 제공된 경우:
태그가 요청에 포함되어 있으면 클러스터에는 해당 태그로만 태그가 지정됩니다. 요청에 태그가 포함되어 있지 않은 경우 스냅샷 태그가 클러스터에 추가됩니다.
+ **CreateSnapshot**:
+ `--cluster-name`이 제공된 경우:
태그가 요청에 포함되어 있으면 요청 태그만 스냅샷에 추가됩니다. 요청에 태그가 포함되어 있지 않은 경우 클러스터 태그가 스냅샷에 추가됩니다.
+ 자동 스냅샷의 경우:
태그가 클러스터 태그에서 전파됩니다.
+ **CopySnapshot**:
태그가 요청에 포함되어 있으면 요청 태그만 스냅샷에 추가됩니다. 요청에 태그가 포함되어 있지 않은 경우 소스 스냅샷 태그가 복사된 스냅샷에 추가됩니다.
+ **TagResource** 및 **UntagResource** :
리소스에서 태그가 추가/제거됩니다.
## 다중 리전 클러스터 태그 지정
MemoryDB 다중 리전 클러스터는 글로벌 리소스입니다. 따라서 MemoryDB Multi-Region이 지원되는 특정 리전에서 관련 APIs를 호출하여 다중 리전 클러스터에서 태그를 지정, 수정 또는 나열할 수 있습니다. 리전 지원에 대한 자세한 내용은 [사전 조건 및 제한 사항](multi-region.prereq.md)을 참조하세요.
다중 리전 클러스터의 태그는 리전 클러스터의 태그와 독립적입니다. 다중 리전 클러스터에서 다양한 태그 세트를 지정할 수 있으며 리전 클러스터가 포함되어 있습니다. 이러한 태그 간에는 계층적 연결이 없으며 이러한 리소스 유형 간의 계층 구조를 통해 복사되지 않습니다.
`TagResource` 및 `UntagResource` APIs를 통해 태그를 추가하거나 제거할 때 태그가 특히 다중 리전 클러스터에 대해 일관되게 유지되므로 ListTags API 응답에 최신 유효 태그가 즉시 표시되지 않을 수 있습니다.
## 태그 제한
태그에 적용되는 기본 제한은 다음과 같습니다.
+ 리소스당 최대 태그 수 – 50개
+ 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
+ 최대 키 길이는 유니코드 문자(UTF-8) 128자입니다.
+ 최대 값 길이는 유니코드 문자(UTF-8) 256자입니다.
+ MemoryDB는 태그에 모든 문자를 사용할 수 있지만, 다른 서비스에는 제한이 적용될 수 있습니다. 서비스에서 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 특수 문자 \+ - = . \_ : / @입니다.
+ 태그 키와 값은 대/소문자를 구분합니다.
+ `aws:` 접두사는 AWS용으로 예약되어 있습니다. 태그에 이 접두사가 있는 태그 키가 있는 경우 태그의 키 또는 값을 편집하거나 삭제할 수 없습니다. `aws:` 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.
태그에만 기초하여 리소스를 종료, 중지 또는 삭제할 수 없습니다. 리소스 식별자를 지정해야 합니다. 예를 들어 `DeleteMe`라는 태그 키로 태그를 지정한 스냅샷을 삭제하려면 해당 스냅샷의 리소스 식별자(예: `DeleteSnapshot`)를 지정하여 `snap-1234567890abcdef0` 작업을 사용해야 합니다.
태그를 지정할 수 있는 MemoryDB 리소스에 대한 자세한 내용은 [태그 지정이 가능한 리소스](#tagging-your-resources) 섹션을 참조하세요.
## 리소스에 태그 지정 예제
+ 새 클러스터에 태그 추가
```
aws memorydb tag-resource \
--resource-arn arn:aws:memorydb:us-east-1:{{111111222233}}:cluster/my-cluster \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
```
+ 태그를 사용하여 클러스터 생성
```
aws memorydb create-cluster \
--cluster-name testing-tags \
--description cluster-test \
--subnet-group-name test \
--node-type db.r6g.large \
--acl-name open-access \
--tags Key="project",Value="XYZ" Key="memorydb",Value="Service"
```
+ 태그를 사용하여 스냅샷 생성
이 경우 요청에 태그를 추가하면 클러스터에 태그가 포함되어 있더라도 스냅샷은 요청 태그만 받습니다.
```
aws memorydb create-snapshot \
--cluster-name testing-tags \
--snapshot-name bkp-testing-tags-mycluster \
--tags Key="work",Value="foo"
```