기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Kinesis Data Streams에서 생성하는 스트림 및 향상된 팬아웃 소비자에 고유한 메타데이터를 태그 형태로 할당할 수 있습니다. 태그는 스트림에 대해 정의된 키-값 페어입니다. 태그를 사용하는 것은 AWS 리소스를 관리하고 결제 데이터를 포함한 데이터를 구성하는 간단하지만 강력한 방법입니다.
내용
태그 기본 사항 검토
태그를 지정할 수 있는 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 사용 설명서의 사용자 지정 결제 보고서에 비용 할당 태그 사용 섹션을 참조하세요.
태그 제한 이해
태그에 적용되는 제한은 다음과 같습니다.
기본 제한
-
각 리소스의 최대 태그 수는 50입니다.
-
태그 키와 값은 대/소문자를 구분합니다.
-
삭제된 리소스에 대해 태그를 변경하거나 편집할 수 없습니다.
태그 키 제한
-
각 태그 키는 고유해야 합니다. 이미 사용 중인 키를 가진 태그를 추가하면 기존 키-값 페어에 새 태그가 덮어쓰기 됩니다.
-
이 접두사는 사용자 대신이 접두사로 시작하는 태그를 AWS AWS 생성하지만 편집하거나 삭제할 수는
aws:없으므로 로 태그 키를 시작할 수 없습니다. -
태그 키의 길이는 유니코드 1~128자여야 합니다.
-
태그 키의 문자로는 유니코드 문자, 숫자, 공백 그리고
_ . / = + - @같은 특수 문자가 허용됩니다.
태그 값 제한
-
태그 값의 길이는 유니코드 0~255자여야 합니다.
-
태그 값은 공백 상태로 둘 수 있습니다. 아니면 유니코드 문자, 숫자, 공백 그리고
_ . / = + - @같은 특수 문자를 사용할 수 있습니다.
Kinesis Data Streams 콘솔을 사용하여 스트림 태그 지정
Kinesis Data Streams 콘솔을 사용하여 스트림에 태그를 추가, 업데이트, 나열 및 제거할 수 있습니다.
스트림에 대한 태그를 보려면
-
에 로그인 AWS Management Console 하고 https://console.aws.amazon.com/kinesis
Kinesis 콘솔을 엽니다. -
왼쪽 탐색 창에서 데이터 스트림을 선택합니다.
-
데이터 스트림 페이지에서 태그를 지정할 스트림을 선택합니다.
-
스트림 세부 정보 페이지에서 구성을 선택합니다.
-
태그 섹션에서 스트림에 적용된 태그를 확인합니다.
태그를 사용하여 데이터 스트림을 생성하려면
-
Kinesis Data Streams 콘솔을 엽니다.
-
왼쪽 탐색 창에서 데이터 스트림을 선택합니다.
-
데이터 스트림 생성을 선택합니다.
-
데이터 스트림 생성 페이지에서 데이터 스트림의 이름을 입력합니다.
-
데이터 스트림 용량에서 온디맨드 또는 프로비저닝된 용량 모드를 선택합니다.
용량 모드에 대한 자세한 내용은 섹션을 참조하세요데이터 스트림 용량 모드 선택.
-
태그 섹션에서 다음을 수행합니다.
-
새로운 태그 추가를 선택합니다.
-
키에 태그를 입력하고 선택적으로 값 필드에 값을 지정합니다.
오류가 표시되면 지정한 태그 키 또는 값이 태그 제한을 충족하지 않는 것입니다. 자세한 내용은 태그 제한 이해 단원을 참조하십시오.
-
-
데이터 스트림 생성을 선택합니다.
스트림에 태그를 추가하거나 업데이트하려면
-
Kinesis Data Streams 콘솔을 엽니다.
-
왼쪽 탐색 창에서 데이터 스트림을 선택합니다.
-
데이터 스트림 페이지에서 태그를 추가하거나 업데이트할 스트림을 선택합니다.
-
스트림 세부 정보 페이지에서 구성을 선택합니다.
-
태그 섹션에서 태그 관리를 선택합니다.
-
태그에서 다음 중 하나를 수행합니다.
-
새 태그를 추가하려면 새 태그 추가를 선택한 다음 태그의 키 및 값 데이터를 입력합니다. 이 단계를 필요한 만큼 반복합니다.
각 스트림에 추가할 수 있는 최대 태그 수는 50개입니다.
-
기존 태그를 업데이트하려면 해당 태그 키의 값 필드에 새 태그 값을 입력합니다.
오류가 표시되면 지정한 태그 키 또는 값이 태그 제한을 충족하지 않는 것입니다. 자세한 내용은 태그 제한 이해 단원을 참조하십시오.
-
-
변경 사항 저장을 선택합니다.
스트림에서 태그를 제거하려면
-
Kinesis Data Streams 콘솔을 엽니다.
-
왼쪽 탐색 창에서 데이터 스트림을 선택합니다.
-
데이터 스트림 페이지에서 태그를 제거할 스트림을 선택합니다.
-
스트림 세부 정보 페이지에서 구성을 선택합니다.
-
태그 섹션에서 태그 관리를 선택합니다.
-
제거할 태그 키 및 값 페어를 찾습니다. 그런 다음 제거를 선택합니다.
-
변경 사항 저장을 선택합니다.
를 사용하여 스트림에 태그 지정 AWS CLI
를 사용하여 스트림에 태그를 추가, 나열 및 제거할 수 있습니다 AWS CLI. 예제는 다음 설명서를 참조하십시오.
- create-stream
-
태그를 사용하여 스트림을 생성합니다.
- add-tags-to-stream
-
지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.
- list-tags-for-stream
-
지정된 스트림에 대한 태그를 나열합니다.
- remove-tags-from-stream
-
지정된 스트림에 대한 태그를 제거합니다.
Kinesis Data Streams APIs
Kinesis Data Streams APIs. 예제는 다음 설명서를 참조하세요.
- CreateStream
-
태그를 사용하여 스트림을 생성합니다.
- AddTagsToStream
-
지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.
- ListTagsForStream
-
지정된 스트림에 대한 태그를 나열합니다.
- RemoveTagsFromStream
-
지정된 스트림에 대한 태그를 제거합니다.
를 사용하여 소비자에게 태그 지정 AWS CLI
를 사용하여 소비자의 태그를 추가, 나열 및 제거할 수 있습니다 AWS CLI. 예제는 다음 설명서를 참조하세요.
- register-stream-consumer
-
Kinesis 데이터 스트림의 소비자를 태그로 등록합니다.
- tag-resource
-
지정된 Kinesis 리소스에 대한 태그를 추가하거나 업데이트합니다.
- list-tags-for-resource
-
지정된 Kinesis 리소스의 태그를 나열합니다.
- untag-resource
-
지정된 Kinesis 리소스에서 태그를 제거합니다.
Kinesis Data Streams APIs를 사용하여 소비자에게 태그 지정
Kinesis Data Streams APIs. 예제는 다음 설명서를 참조하세요.
- RegisterStreamConsumer
-
Kinesis 데이터 스트림의 소비자를 태그로 등록합니다.
- TagResource
-
지정된 Kinesis 리소스에 대한 태그를 추가하거나 업데이트합니다.
- ListTagsForResource
-
지정된 Kinesis 리소스의 태그를 나열합니다.
- UntagResource
-
지정된 Kinesis 리소스에서 태그를 제거합니다.
