

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon QLDB 리소스 태그 지정
<a name="tagging"></a>

**중요**  
지원 종료 알림: 기존 고객은 07/31/2025에 지원이 종료될 때까지 Amazon QLDB를 사용할 수 있습니다. 자세한 내용은 [Amazon QLDB 원장을 Amazon Aurora PostgreSQL로 마이그레이션](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)을 참조하세요.

*태그*는 AWS 리소스에 할당하거나 할당하는 AWS 사용자 지정 속성 레이블입니다. 각 태그에는 다음 두 가지 부분이 있습니다.
+ *태그 키*(예: `CostCenter`, `Environment` 또는 `Project`) 태그 키는 대/소문자를 구별합니다.
+ *태그 값*(예: `111122223333` 또는 `Production`)으로 알려진 선택적 필드 태그 값을 생략하는 것은 빈 문자열을 사용하는 것과 같습니다. 태그 키처럼 태그 값은 대/소문자를 구별합니다.

태그는 다음을 지원합니다.
+  AWS 리소스를 식별하고 구성합니다. 많은가 태그 지정을 AWS 서비스 지원하므로 서로 다른 서비스의 리소스에 동일한 태그를 할당하여 리소스가 관련이 있음을 나타낼 수 있습니다. 예컨대, Amazon S3 버킷에 할당한 것과 동일한 태그를 Amazon QLDB 원장에 할당할 수 있습니다.
+  AWS 비용을 추적합니다. AWS 결제 및 비용 관리 대시보드에서 이러한 태그를 활성화합니다. AWS 는 태그를 사용하여 비용을 분류하고 월별 비용 할당 보고서를 제공합니다. 자세한 설명은 [AWS Billing 사용자 가이드](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/)에서 [비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)을 참조하세요.
+  AWS Identity and Access Management (IAM)을 사용하여 AWS 리소스에 대한 액세스를 제어합니다. 자세한 설명은 이 개발자 가이드의 [QLDB와 함께하는 ABAC(속성 기반 액세스 제어)](security_iam_service-with-iam.md#security_iam_service-with-iam-tags) 섹션과 *IAM 사용자 가이드*의 [IAM 태그를 사용한 액세스 통제](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_iam-tags.html)를 참조하세요.

태그 사용에 대한 팁은 *AWS Answers* 블로그의 게시글 [AWS Tagging Strategies](https://aws.amazon.com/answers/account-management/aws-tagging-strategies/)를 참조하세요.​

다음 섹션에서는 Amazon QLDB용 태그에 대한 추가 정보를 제공합니다.

**Topics**
+ [Amazon QLDB에서 지원되는 리소스](#supported-resources)
+ [태그 명칭 지정 및 사용 규칙](#tagging-conventions)
+ [태그 관리](#tagging-add-edit-delete)
+ [생성 시 리소스 태그 지정](#tagging-on-creation)

## Amazon QLDB에서 지원되는 리소스
<a name="supported-resources"></a>

Amazon QLDB의 다음 리소스는 태깅을 지원합니다.
+ 원장
+ 테이블
+ 저널 스트림

태그 추가 및 관리에 대한 자세한 설명은 [태그 관리](#tagging-add-edit-delete) 섹션을 참조하세요.

## 태그 명칭 지정 및 사용 규칙
<a name="tagging-conventions"></a>

다음 기본 명명 및 사용 규칙은 Amazon QLDB 리소스와 함께 태그를 사용할 때 적용됩니다:
+ 각 리소스는 최대 50개의 태그를 보유할 수 있습니다.
+ 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
+ 태그 키의 최대 길이는 UTF-8 형식의 유니코드 문자 128자입니다.
+ 태그 값의 최대 길이는 UTF-8 형식의 유니코드 문자 256자입니다.
+ 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자, 공백 및 ***. : \$1 = @ \$1 / -***(하이픈) 문자도 있습니다.
+ 태그 키와 값은 대소문자를 구분합니다. 태그를 대문자로 사용하는 전략을 세우고 이러한 전략을 모든 리소스 타입에 대해 일관되게 구현하는 것이 가장 좋습니다. 예컨대, `Costcenter`, `costcenter` 또는 `CostCenter`를 사용할지 결정하고 모든 태그에 대해 동일한 규칙을 사용합니다. 대/소문자가 일치하지 않는 유사한 태그를 사용하지 마십시오.
+ `aws:` 접두사는 AWS 사용을 위해 예약되어 있습니다. 태그에 `aws:` 접두사가 있는 태그 키가 있는 경우 태그의 키 또는 값을 편집하거나 삭제할 수 없습니다. 이 접두사가 지정된 태그는 리소스당 태그 수 제한에 포함되지 않습니다.

## 태그 관리
<a name="tagging-add-edit-delete"></a>

태그는 리소스의 `Key` 및 `Value` 속성으로 구성됩니다. Amazon QLDB 콘솔, AWS CLI또는 QLDB API를 사용하여 이러한 속성의 값을 추가, 편집 또는 삭제할 수 있습니다. AWS Resource Groups [태그 편집기](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)를 사용하여 태그를 관리할 수도 있습니다.

태그 작업에 대한 자세한 설명은 다음 API 작업을 참조하세요:
+ *Amazon QLDB API 참조*의 [ListTagsForResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_ListTagsForResource.html)
+ *Amazon QLDB API 참조*의 [TagResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_TagResource.html)
+ *Amazon QLDB API 참조*의 [UntagResource](https://docs.aws.amazon.com/qldb/latest/developerguide/API_UntagResource.html)

**QLDB 태그 지정 패널을 사용하려면(콘솔)**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/qldb](https://console.aws.amazon.com/qldb) Amazon QLDB 콘솔을 엽니다.

1. 탐색 창에서 **원장**을 선택합니다.

1. **원장** 목록에서 태그를 관리하려는 원장 명칭을 선택합니다.

1. 원장 세부 정보 페이지에서 **태그** 카드를 찾아 **태그 관리**를 선택합니다.

1. **태그 관리** 페이지에서 원장에 적합한 태그를 추가, 편집 또는 제거할 수 있습니다. 태그 키와 값을 원하는 대로 설정했으면 **저장**을 선택합니다.

## 생성 시 리소스 태그 지정
<a name="tagging-on-creation"></a>

태그 지정을 지원하는 QLDB 리소스의 경우 AWS Management Console, , AWS CLI또는 QLDB API를 사용하여 리소스를 생성하는 동안 태그를 정의할 수 있습니다. 리소스를 생성하는 동안 태그를 지정하면 리소스 생성 후 사용자 지정 태그 지정 스크립트를 실행할 필요가 없습니다.

리소스에 태그가 지정되면 해당 태그를 기반으로 리소스에 대한 액세스를 제어할 수 있습니다. 예컨대 특정 태그가 있는 표 리소스에만 전체 액세스 권한을 부여할 수 있습니다. JSON 정책의 예는 [테이블 태그를 기반으로 하는 모든 작업에 대한 전체 액세스 권한](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-full-tags) 섹션을 참조하세요.

**참고**  
표 및 스트림 리소스는 루트 원장 리소스의 태그를 상속하지 않습니다.

또한 `CREATE TABLE` PartiQL 문에 표 태그를 지정하여 표 태그를 정의할 수 있습니다. 자세한 내용은 [태그 지정 테이블](getting-started-standard-mode.md#security_iam_partiql-ref.table-tags) 섹션을 참조하세요.