Amazon Kinesis Data Streams의 스트림 태그 지정 - Amazon Kinesis Data Streams
태그 기본 사항 검토태그 지정을 사용하여 비용 추적태그 제한 이해Kinesis Data Streams 콘솔을 사용하여 스트림 태그 지정AWS CLI를 사용하여 스트림에 태그 지정Kinesis Data Streams API를 사용하여 스트림 태그 지정

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

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. 스트림 세부 정보 페이지에서 태그 탭을 선택합니다.

태그를 사용하여 데이터 스트림을 생성하려면

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

  2. 스트림 생성을 선택합니다.

  3. 데이터 스트림 생성 페이지에서 데이터 스트림의 이름을 입력한 다음 온디맨드 또는 프로비저닝된 용량 모드를 선택합니다. 온디맨드 모드가 기본적으로 선택됩니다. 자세한 내용은 데이터 스트림 용량 모드 선택 단원을 참조하십시오.

  4. 태그 항목에서 새로운 태그 추가를 선택합니다. 키 필드에서 태그를 지정한 다음 값 필드에서 선택적으로 값을 지정합니다.

    오류가 표시되면 지정한 태그 키 또는 값이 태그 제한을 충족하지 않는 것입니다. 자세한 내용은 태그 제한 이해 단원을 참조하십시오.

  5. 데이터 스트림 생성을 선택합니다.

  6. 스트림이 생성 중인 동안 Kinesis 스트림 페이지에서 스트림의 상태는 생성 중으로 표시됩니다. 스트림을 사용할 준비가 되면 상태가 활성으로 변경됩니다.

  7. 스트림 명칭을 선택합니다. 스트림 세부 정보 페이지에 모니터링 정보와 함께 스트림 구성 요약이 표시됩니다.

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

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

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

  3. 스트림 세부 정보 페이지에서 태그 탭을 선택합니다.

  4. 키 필드에서 태그 키를 지정하고, 선택적으로 값 필드에서 태그 값을 지정한 다음 태그 추가를 선택합니다.

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

  5. 태그 탭의 목록에서 새 태그를 보려면 새로 고침 아이콘을 선택합니다.

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

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

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

  3. 스트림 세부 정보 페이지에서 태그 탭을 선택한 다음, 태그에 대한 제거 아이콘을 선택합니다.

  4. 태그 삭제 대화 상자에서 예, 삭제를 선택합니다.

AWS CLI를 사용하여 스트림에 태그 지정

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

create-stream

태그를 사용하여 스트림을 생성합니다.

add-tags-to-stream

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

list-tags-for-stream

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

remove-tags-from-stream

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

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

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

CreateStream

태그를 사용하여 스트림을 생성합니다.

AddTagsToStream

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

ListTagsForStream

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

RemoveTagsFromStream

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