기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Firehose 스트림에 태그 지정
Amazon Data Firehose에서 생성한 Firehose 스트림에 고유한 메타데이터를 *태그* 형태로 할당할 수 있습니다. 태그는 스트림에 대해 정의된 키-값 페어입니다. 태그를 사용하는 것은 AWS 리소스를 관리하고 결제 데이터를 포함한 데이터를 구성하는 간단하지만 강력한 방법입니다.
[CreateDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_CreateDeliveryStream.html)을 호출하여 새 Firehose 스트림을 생성할 때 태그를 지정할 수 있습니다. 기존 Firehose 스트림의 경우 다음 세 가지 작업을 사용하여 태그를 추가, 나열 및 제거할 수 있습니다.
+ [TagDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_TagDeliveryStream.html)
+ [ListTagsForDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_ListTagsForDeliveryStream.html)
+ [UntagDeliveryStream](https://docs.aws.amazon.com/firehose/latest/APIReference/API_UntagDeliveryStream.html)
# 태그의 기본 사항 이해
Amazon Data Firehose API 작업을 사용하여 다음 작업을 수행할 수 있습니다.
+ Firehose 스트림에 태그를 추가합니다.
+ Firehose 스트림에 대한 태그를 나열합니다.
+ Firehose 스트림에서 태그를 제거합니다.
태그를 사용하여 Firehose 스트림을 분류할 수 있습니다. 예를 들어, 용도, 소유자 또는 환경별로 Firehose 스트림을 분류할 수 있습니다. 각 태그에 대해 키와 값이 정의되기 때문에 특정 요구를 충족하는 사용자 지정 카테고리 세트를 생성할 수 있습니다. 예를 들어, 태그 세트를 정의하여 소유자 및 연관된 애플리케이션에 따라 Firehose 스트림을 추적할 수 있습니다.
다음은 몇 가지 태그의 예입니다.
+ `Project: Project name`
+ `Owner: Name`
+ `Purpose: Load testing`
+ `Application: Application name`
+ `Environment: Production`
`CreateDeliveryStream` 작업에서 태그를 지정하는 경우 Amazon Data Firehose는 `firehose:TagDeliveryStream` 작업에서 추가적인 권한 인증을 수행하여 사용자에게 태그를 생성할 권한이 있는지 확인합니다. 이 권한을 제공하지 않으면 IAM 리소스 태그가 있는 새 Firehose 스트림을 생성하려는 요청이 다음과 같이 `AccessDeniedException` 오류와 함께 실패합니다.
```
AccessDeniedException
User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.
```
다음 예제는 사용자가 Firehose 스트림을 생성하고 태그를 적용할 수 있도록 허용하는 정책을 보여줍니다.
# 태그 지정으로 비용 추적
태그를 사용하여 AWS 비용을 분류하고 추적할 수 있습니다. Firehose 스트림을 포함한 리소스에 AWS 태그를 적용하면 AWS 비용 할당 보고서에는 태그별로 집계된 사용량 및 비용이 포함됩니다. 비즈니스 범주를 나타내는 태그(예: 비용 센터, 애플리케이션 이름 또는 소유자)를 적용하여 여러 서비스에 대한 비용을 정리할 수 있습니다. 자세한 내용은 *AWS Billing 사용 설명서*의 [사용자 지정 결제 보고서에 비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 섹션을 참조하세요.
# 태그 제한 파악
Amazon Data Firehose의 태그에는 다음과 같은 제한 사항이 적용됩니다.
**기본 제한 사항**
+ 리소스(스트림)당 최대 태그 수는 50개입니다.
+ 태그 키와 값은 대/소문자를 구분합니다.
+ 삭제된 스트림에 대해 태그를 변경하거나 편집할 수 없습니다.
**태그 키 제한 사항**
+ 각 태그 키는 고유해야 합니다. 이미 사용 중인 키를 가진 태그를 추가하면 기존 키-값 쌍에 새 태그가 덮어쓰기 됩니다.
+ `aws:`를 사용하여 태그 키를 시작할 수 없습니다. 이 접두사는 AWS용으로 예약되어 있기 때문입니다. AWS 는 이 접두사로 시작되는 태그를 생성하지만, 사용자는 이를 편집하거나 삭제할 수 없습니다.
+ 태그 키의 길이는 유니코드 1\$1128자여야 합니다.
+ 태그 키의 문자로는 유니코드 문자, 숫자, 공백 그리고 `_ . / = + - @` 같은 특수 문자가 허용됩니다.
**태그 값 제한 사항**
+ 태그 값의 길이는 유니코드 0\$1255자여야 합니다.
+ 태그 값은 공백 상태로 둘 수 있습니다. 아니면 유니코드 문자, 숫자, 공백 그리고 `_ . / = + - @` 같은 특수 문자를 사용할 수 있습니다.