Amazon Kinesis Data Streams의 스트림 태그 지정

Amazon Kinesis Data Streams에서 생성한 스트림에 고유한 메타데이터를 태그 형태로 할당할 수 있습니다. 태그는 스트림에 대해 정의된 키-값 페어입니다. 태그를 사용하면 간단하면서도 효과적으로 AWS 리소스를 관리하고 결제 데이터를 포함하여 데이터를 구성할 수 있습니다.

태그 기본 사항

Kinesis Data Streams 콘솔, AWS CLI 또는 Kinesis Data Streams API를 사용하여 다음 작업을 완료합니다.

• 스트림에 태그 추가

• 스트림에 대한 태그 나열

• 스트림에서 태그 제거

태그를 사용하여 스트림을 분류할 수 있습니다. 예를 들어, 용도, 소유자 또는 환경별로 스트림을 분류할 수 있습니다. 각 태그에 대해 키와 값이 정의되기 때문에 특정 요구를 충족하는 사용자 지정 범주 세트를 생성할 수 있습니다. 예를 들어, 태그 세트를 정의하여 소유자 및 연관된 애플리케이션에 따라 스트림을 추적할 수 있습니다. 다음은 태그의 몇 가지 예제입니다.

• 프로젝트: 프로젝트 이름

• 소유자: 이름

• 용도: 로드 테스트

• 애플리케이션: 애플리케이션 이름

• 환경: 프로덕션

태그 지정을 사용하여 비용 추적

태그를 사용하여 AWS 비용을 분류하고 추적할 수 있습니다. 스트림을 비롯하여 AWS 리소스에 태그를 적용할 때 AWS 비용 할당 보고서에는 태그별로 집계된 사용 내역 및 비용이 포함됩니다. 비즈니스 범주를 나타내는 태그(예: 비용 센터, 애플리케이션 이름 또는 소유자)를 적용하여 여러 서비스에 대한 비용을 정리할 수 있습니다. 자세한 내용은 AWS Billing 사용 설명서의 사용자 지정 결제 보고서에 비용 할당 태그 사용을 참조하세요.

태그 제한

태그에 적용되는 제한은 다음과 같습니다.

기본 제한

• 리소스(스트림)당 최대 태그 수는 50개입니다.

• 태그 키와 값은 대/소문자를 구분합니다.

• 삭제된 스트림에 대해 태그를 변경하거나 편집할 수 없습니다.

태그 키 제한

• 각 태그 키는 고유해야 합니다. 이미 사용 중인 키를 가진 태그를 추가하면 기존 키-값 페어에 새 태그가 덮어쓰기 됩니다.

• aws:를 사용하여 태그 키를 시작할 수 없습니다. 이 접두사는 AWS용으로 예약되어 있기 때문입니다. AWS는 이 접두사로 시작되는 태그를 생성하지만, 사용자는 이를 편집하거나 삭제할 수 없습니다.

• 태그 키의 길이는 유니코드 1~128자여야 합니다.

• 태그 키의 문자로는 유니코드 문자, 숫자, 공백, 그리고 _ . / = + - @ 같은 특별 문자가 허용됩니다.

태그 값 제한

• 태그 값의 길이는 유니코드 0~255자여야 합니다.

• 태그 값은 공백 상태로 둘 수 있습니다. 아니면 유니코드 문자, 숫자, 공백, 그리고 _ . / = + - @ 같은 특별 문자를 사용할 수 있습니다.

Kinesis Data Streams 콘솔을 사용하여 스트림 태그 지정

Kinesis Data Streams 콘솔을 사용하여 태그를 추가, 나열 및 제거할 수 있습니다.

스트림에 대한 태그를 보려면

1. Kinesis Data Streams 콘솔을 엽니다. 탐색 모음에서 리전 선택기를 확장하고 리전을 선택합니다.

2. Stream List(스트림 목록) 페이지에서 스트림을 선택합니다.

3. Stream Details(스트림 세부 정보) 페이지에서 Tags(태그) 탭을 클릭합니다.

스트림에 태그를 추가하려면

1. Kinesis Data Streams 콘솔을 엽니다. 탐색 모음에서 리전 선택기를 확장하고 리전을 선택합니다.

2. Stream List(스트림 목록) 페이지에서 스트림을 선택합니다.

3. Stream Details(스트림 세부 정보) 페이지에서 Tags(태그) 탭을 클릭합니다.

4. Key(키) 필드에서 태그 키를 지정하고, 선택적으로 Value(값) 필드에서 태그 값을 지정한 다음, Add Tag(태그 추가)를 클릭합니다.

   Add Tag(태그 추가) 버튼이 활성화되지 않는 경우 지정한 태그 키 또는 태그 값이 태그 제한 사항을 충족하지 않는 것입니다. 자세한 내용은 태그 제한 섹션을 참조하세요.

5. Tags(태그) 탭의 목록에서 새 태그를 보려면 새로 고침 아이콘을 클릭합니다.

스트림에서 태그를 제거하려면

1. Kinesis Data Streams 콘솔을 엽니다. 탐색 모음에서 리전 선택기를 확장하고 리전을 선택합니다.

2. [Stream List] 페이지에서 스트림을 선택합니다.

3. Stream Details(스트림 세부 전보) 페이지에서 Tags(태그) 탭을 클릭한 다음, 태그에 대한 Remove(제거) 아이콘을 클릭합니다.

4. Delete Tag(태그 삭제) 대화 상자에서 Yes, Delete(예, 삭제합니다)를 클릭합니다.

AWS CLI를 사용하여 스트림에 태깅

AWS CLI를 사용하여 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하십시오.

add-tags-to-stream

지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.

list-tags-for-stream

지정된 스트림에 대한 태그를 나열합니다.

remove-tags-from-stream

지정된 스트림에 대한 태그를 제거합니다.

Kinesis Data Streams API를 사용하여 스트림 태그 지정

Kinesis Data Streams API를 사용하여 태그를 추가, 나열 및 제거할 수 있습니다. 예제는 다음 설명서를 참조하세요.

AddTagsToStream

지정된 스트림에 대한 태그를 추가 또는 업데이트합니다.

ListTagsForStream

지정된 스트림에 대한 태그를 나열합니다.

RemoveTagsFromStream

지정된 스트림에 대한 태그를 제거합니다.