기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Kinesis Data Streams 리소스에 태그 지정
Amazon Kinesis Data Streams에서 생성한 스트림 및 향상된 팬아웃 소비자에게 자체 메타데이터를 *태그* 형태로 할당할 수 있습니다. 태그는 스트림에 대해 정의된 키-값 페어입니다. 태그를 사용하는 것은 AWS 리소스를 관리하고 결제 데이터를 포함한 데이터를 구성하는 간단하지만 강력한 방법입니다.
**Topics**
+ [태그 기본 사항 검토](#tagging-basics)
+ [태그 지정을 사용하여 비용 추적](#tagging-billing)
+ [태그 제한 이해](#tagging-restrictions)
+ [Kinesis Data Streams 콘솔을 사용하여 스트림 태그 지정](#tagging-console)
+ [를 사용하여 스트림에 태그 지정 AWS CLI](#tagging-cli)
+ [Kinesis Data Streams API를 사용하여 스트림 태그 지정](#tagging-api)
+ [를 사용하여 소비자에게 태그 지정 AWS CLI](#tagging-consumers-cli)
+ [Kinesis Data Streams API를 사용하여 소비자 태그 지정](#tagging-consumers-api)
## 태그 기본 사항 검토
태그를 지정할 수 있는 Kinesis Data Streams 리소스에는 데이터 스트림과 향상된 팬아웃 소비자가 포함됩니다. Kinesis Data Streams 콘솔 AWS CLI또는 Kinesis Data Streams API를 사용하여 다음 작업을 완료합니다.
+ 태그가 지정된 리소스 생성
+ 리소스에 태그 추가
+ 리소스에 대한 태그 나열
+ 리소스에서 태그 제거
**참고**
Kinesis Data Streams 콘솔을 사용하여 향상된 팬아웃 소비자에게 태그를 적용할 수 없습니다. 소비자에게 태그를 적용하려면 AWS CLI 또는 Kinesis Data Streams API를 사용합니다.
태그를 사용하여 리소스를 범주화할 수 있습니다. 예를 들어, 용도, 소유자 또는 환경 기준별로 리소스를 범주화할 수 있습니다. 각 태그에 대해 키와 값이 정의되기 때문에 특정 요구를 충족하는 사용자 지정 범주 세트를 생성할 수 있습니다. 예를 들어, 태그 세트를 정의하여 소유자 및 연관된 애플리케이션에 따라 리소스를 추적할 수 있습니다. 다음은 태그의 몇 가지 예제입니다.
+ 프로젝트: 프로젝트 이름
+ 소유자: 이름
+ 용도: 로드 테스트
+ 애플리케이션: 애플리케이션 이름
+ 환경: 프로덕션
**중요**
스트림을 생성하는 동안 태그를 추가하려면 해당 스트림에 대한 `kinesis:CreateStream` 및 `kinesis:AddTagsToStream` 권한을 포함해야 합니다. 스트림을 생성하는 동안에는 `kinesis:TagResource` 권한을 **사용**하여 태그를 지정할 수 없습니다.
소비자 등록 중에 태그를 추가하려면 `kinesis:TagResource` 및 `kinesis:RegisterStreamConsumer` 권한을 포함해야 합니다.
## 태그 지정을 사용하여 비용 추적
태그를 사용하여 AWS 비용을 분류하고 추적할 수 있습니다. Kinesis Data Streams 리소스에 태그를 적용하면 AWS 비용 할당 보고서에는 태그별로 집계된 사용량 및 비용이 포함됩니다. 비즈니스 범주를 나타내는 태그(예: 비용 센터, 애플리케이션 이름 또는 소유자)를 적용하여 여러 서비스에 대한 비용을 정리할 수 있습니다. 자세한 내용은 *AWS Billing 사용 설명서*의 [사용자 지정 결제 보고서에 비용 할당 태그 사용](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 섹션을 참조하세요.
## 태그 제한 이해
태그에 적용되는 제한은 다음과 같습니다.
**기본 제한 사항**
+ 각 리소스의 최대 태그 수는 50입니다.
+ 태그 키와 값은 대/소문자를 구분합니다.
+ 삭제된 리소스에 대해 태그를 변경하거나 편집할 수 없습니다.
**태그 키 제한 사항**
+ 각 태그 키는 고유해야 합니다. 이미 사용 중인 키를 가진 태그를 추가하면 기존 키-값 쌍에 새 태그가 덮어쓰기 됩니다.
+ 이 접두사는 사용자 대신이 접두사로 시작하는 태그를 AWS AWS 생성하지만 편집하거나 삭제할 수는 `aws:` 없으므로 로 태그 키를 시작할 수 없습니다.
+ 태그 키의 길이는 유니코드 1\$1128자여야 합니다.
+ 태그 키의 문자로는 유니코드 문자, 숫자, 공백 그리고 `_ . / = + - @` 같은 특수 문자가 허용됩니다.
**태그 값 제한 사항**
+ 태그 값의 길이는 유니코드 0\$1255자여야 합니다.
+ 태그 값은 공백 상태로 둘 수 있습니다. 아니면 유니코드 문자, 숫자, 공백 그리고 `_ . / = + - @` 같은 특수 문자를 사용할 수 있습니다.
## Kinesis Data Streams 콘솔을 사용하여 스트림 태그 지정
Kinesis Data Streams 콘솔을 사용하여 스트림에 태그를 추가하고 이를 업데이트, 나열 및 제거할 수 있습니다.
**스트림에 대한 태그를 보려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/kinesis](https://console.aws.amazon.com/kinesis) Kinesis 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **데이터 스트림**을 선택합니다.
1. **데이터 스트림** 페이지에서 태그를 지정할 스트림을 선택합니다.
1. 스트림 세부 정보 페이지에서 **구성**을 선택합니다.
1. **태그** 섹션에서 스트림에 적용된 태그를 확인합니다.
**태그를 사용하여 데이터 스트림을 생성하려면**
1. Kinesis Data Streams 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **데이터 스트림**을 선택합니다.
1. **데이터 스트림 생성**을 선택합니다.
1. **데이터 스트림 생성** 페이지에서 데이터 스트림의 이름을 입력합니다.
1. **데이터 스트림 용량**에서 **온디맨드** 또는 **프로비저닝된** 용량 모드를 선택합니다.
용량 모드에 대한 자세한 내용은 [스트리밍할 올바른 모드 선택](how-do-i-size-a-stream.md) 섹션을 참조하세요.
1. **태그** 섹션에서 다음을 수행합니다.
1. **새로운 태그 추가**를 선택합니다.
1. **키** 필드에서 태그를 입력한 다음 **값** 필드에서 선택적으로 값을 지정합니다.
오류가 표시되면 지정한 태그 키 또는 값이 태그 제한을 충족하지 않는 것입니다. 자세한 내용은 [태그 제한 이해](#tagging-restrictions) 단원을 참조하십시오.
1. **데이터 스트림 생성**을 선택합니다.
**스트림의 태그를 추가하거나 업데이트하려면**
1. Kinesis Data Streams 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **데이터 스트림**을 선택합니다.
1. **데이터 스트림** 페이지에서 태그를 추가하거나 업데이트할 스트림을 선택합니다.
1. 스트림 세부 정보 페이지에서 **구성**을 선택합니다.
1. **태그** 섹션에서 **태그 관리**를 선택합니다.
1. **태그** 아래에서 다음 중 하나를 수행합니다.
+ 새 태그를 추가하려면 **새 태그 추가**를 선택한 다음 태그의 **키**와 **값** 데이터를 입력합니다. 이 단계를 필요한 만큼 반복합니다.
각 스트림에 추가할 수 있는 최대 태그 수는 50개입니다.
+ 기존 태그를 업데이트하려면 해당 태그 **키**의 **값** 필드에 새 태그 값을 입력합니다.
오류가 표시되면 지정한 태그 키 또는 값이 태그 제한을 충족하지 않는 것입니다. 자세한 내용은 [태그 제한 이해](#tagging-restrictions) 단원을 참조하십시오.
1. **변경 사항 저장**을 선택합니다.
**스트림에서 태그를 제거하려면**
1. Kinesis Data Streams 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **데이터 스트림**을 선택합니다.
1. **데이터 스트림** 페이지에서 태그를 제거할 스트림을 선택합니다.
1. 스트림 세부 정보 페이지에서 **구성**을 선택합니다.
1. **태그** 섹션에서 **태그 관리**를 선택합니다.
1. 제거할 태그의 **키** 및 **값** 페어를 찾습니다. 그런 다음 **제거**를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
## 를 사용하여 스트림에 태그 지정 AWS CLI
AWS CLI를 사용하여 스트림의 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하십시오.
[create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)
태그를 사용하여 스트림을 생성합니다.
[add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)
지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.
[list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)
지정된 스트림에 대한 태그를 나열합니다.
[remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)
지정된 스트림에 대한 태그를 제거합니다.
## Kinesis Data Streams API를 사용하여 스트림 태그 지정
Kinesis Data Streams API를 사용하여 스트림의 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하세요.
[CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)
태그를 사용하여 스트림을 생성합니다.
[AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)
지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.
[ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)
지정된 스트림에 대한 태그를 나열합니다.
[RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)
지정된 스트림에 대한 태그를 제거합니다.
## 를 사용하여 소비자에게 태그 지정 AWS CLI
AWS CLI를 사용하여 소비자의 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하세요.
[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)
태그를 사용하여 Kinesis 데이터 스트림에 소비자를 등록합니다.
[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)
지정된 Kinesis 리소스에 대한 태그를 추가하거나 업데이트합니다.
[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)
지정된 Kinesis 리소스의 태그를 나열합니다.
[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)
지정된 Kinesis 리소스에서 태그를 제거합니다.
## Kinesis Data Streams API를 사용하여 소비자 태그 지정
Kinesis Data Streams API를 사용하여 소비자의 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하세요.
[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)
태그를 사용하여 Kinesis 데이터 스트림에 소비자를 등록합니다.
[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)
지정된 Kinesis 리소스에 대한 태그를 추가하거나 업데이트합니다.
[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)
지정된 Kinesis 리소스의 태그를 나열합니다.
[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)
지정된 Kinesis 리소스에서 태그를 제거합니다.