Amazon Kinesis Data Streams에 사용되는 작업, 리소스 및 조건 키

Amazon Kinesis Data Streams(서비스 접두사: kinesis)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

• 이 서비스를 구성하는 방법을 알아봅니다.

• 이 서비스에 사용할 수 있는 API 작업 목록을 봅니다.

• IAM 권한 정책을 사용하여이 서비스와 리소스를 보호하는 방법을 알아봅니다.

Amazon Kinesis Data Streams에서 정의한 작업

IAM 정책 문의 Action 요소에 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하는 경우 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 열에 리소스 유형이 포함된 경우 해당 작업과 함께 문에 해당 유형의 ARN를 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우 필요한 각 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
AddTagsToStream	지정된 Amazon Kinesis 스트림에 대한 태그를 추가하거나 업데이트할 수 있는 권한을 부여합니다. 각 스트림은 최대 10개의 태그를 보유할 수 있습니다.	태그 지정	stream*	aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
CreateStream	Amazon Kinesis 스트림을 생성할 수 있는 권한을 부여합니다.	쓰기	stream*	aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
DecreaseStreamRetentionPeriod	스트림의 보존 기간(데이터 레코드를 스트림에 추가한 후 데이터 레코드에 액세스할 수 있는 기간)을 줄일 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
DeleteResourcePolicy	지정된 스트림 또는 소비자와 연결된 리소스 정책을 삭제할 수 있는 권한을 부여합니다.	쓰기	consumer*
			stream*	aws:ResourceTag/${TagKey}
DeleteStream	스트림 및 해당 데이터를 삭제할 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
DeregisterStreamConsumer	Kinesis 데이터 스트림에서 스트림 소비자를 등록 취소할 수 있는 권한을 부여합니다.	쓰기	consumer*
DescribeLimits	계정에 대한 샤드 한도 및 사용량을 설명할 수 있는 권한을 부여합니다.	읽기
DescribeStream	지정된 스트림을 설명할 수 있는 권한을 부여합니다.	읽기	stream*	aws:ResourceTag/${TagKey}
DescribeStreamConsumer	등록된 스트림 소비자에 대한 설명을 가져올 수 있는 권한을 부여합니다.	읽기	consumer*
DescribeStreamSummary	샤드 목록 없이 지정된 Kinesis 데이터 스트림에 대한 요약 설명을 제공할 수 있는 권한을 부여합니다.	읽기	stream*	aws:ResourceTag/${TagKey}
DisableEnhancedMonitoring	향상된 모니터링을 비활성화할 수 있는 권한을 부여합니다.	쓰기
EnableEnhancedMonitoring	샤드 수준 지표에 대해 향상된 Kinesis 데이터 스트림 모니터링을 활성화할 수 있는 권한을 부여합니다.	쓰기
GetRecords	샤드에서 데이터 레코드를 가져올 수 있는 권한을 부여합니다.	읽기	stream*	aws:ResourceTag/${TagKey}
GetResourcePolicy	지정된 스트림 또는 소비자와 연결된 리소스 정책을 가져올 수 있는 권한을 부여합니다.	읽기	consumer*
			stream*	aws:ResourceTag/${TagKey}
GetShardIterator	샤드 반복자를 가져올 수 있는 권한을 부여합니다. 샤드 반복자는 요청자에게 반환되고 5분 후에 만료됩니다.	읽기	stream*	aws:ResourceTag/${TagKey}
IncreaseStreamRetentionPeriod	스트림의 보존 기간(데이터 레코드를 스트림에 추가한 후 데이터 레코드에 액세스할 수 있는 기간)을 늘릴 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
ListShards	스트림의 샤드를 나열하고 각 샤드에 대한 정보를 제공할 수 있는 권한을 부여합니다.	나열	stream*	aws:ResourceTag/${TagKey}
ListStreamConsumers	향상된 팬아웃을 사용하여 Kinesis 스트림으로부터 데이터를 수신하도록 등록된 스트림 소비자를 나열하고 각 소비자에 대한 정보를 제공할 수 있는 권한을 부여합니다.	나열	stream*	aws:ResourceTag/${TagKey}
ListStreams	스트림을 나열할 수 있는 권한을 부여합니다.	나열
ListTagsForStream	지정된 Amazon Kinesis 스트림의 태그를 나열할 수 있는 권한을 부여합니다.	읽기	stream*	aws:ResourceTag/${TagKey}
MergeShards	데이터를 수집하고 전송하기 위한 스트림의 용량을 줄이기 위해 스트림에서 두 인접 샤드를 병합하고 단일 샤드로 결합할 수수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
PutRecord	생산자의 단일 데이터 레코드를 Amazon Kinesis 스트림에 쓸 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
PutRecords	생산자의 여러 데이터 레코드를 단일 호출(A PutRecords 요청이라고도 함)로 Amazon Kinesis 스트림에 쓸 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
PutResourcePolicy	지정된 스트림 또는 소비자에 리소스 정책을 연결할 수 있는 권한을 부여합니다.	쓰기	consumer*
			stream*	aws:ResourceTag/${TagKey}
RegisterStreamConsumer	Kinesis 데이터 스트림에 스트림 소비자를 등록할 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
RemoveTagsFromStream	지정된 Kinesis 데이터터 스트림에서 태그를 제거할 수 있는 권한을 부여합니다. 제거된 태그가 삭제되었으며 이 작업이 성공적으로 완료된 후에는 복구할 수 없습니다.	태그 지정	stream*	aws:TagKeys aws:ResourceTag/${TagKey}
SplitShard	데이터를 수집하고 전송하기 위한 스트림의 용량을 늘리기 위해 Kinesis 데이터 스트림에서 샤드를 두 개의 새 샤드로 분할할 수 있는 권한을 부여합니다.	쓰기	stream*	aws:ResourceTag/${TagKey}
StartStreamEncryption	지정된 스트림에 대해 AWS KMS 키를 사용하여 서버 측 암호화를 활성화하거나 업데이트할 수 있는 권한을 부여합니다.	쓰기	kmsKey*
			stream*	aws:ResourceTag/${TagKey}
StopStreamEncryption	지정된 스트림에서 서버 측 암호화를 비활성화할 수 있는 권한을 부여합니다.	쓰기	kmsKey*
			stream*	aws:ResourceTag/${TagKey}
SubscribeToShard	향상된 팬아웃으로 특정 샤드를 수신할 수 있는 권한을 부여합니다.	읽기	consumer*
UpdateShardCount	지정된 스트림의 샤드 수를 지정된 샤드 수로 업데이트할 수 있는 권한을 부여합니다.	쓰기
UpdateStreamMode	데이터 스트림의 용량 모드를 업데이트할 수 있는 권한을 부여합니다.	쓰기

Amazon Kinesis Data Streams에서 정의한 리소스 유형

다음 리소스 유형은이 서비스에 의해 정의되며 IAM 권한 정책 문의 Resource 요소에 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형	ARN	조건 키
stream	arn:${Partition}:kinesis:${Region}:${Account}:stream/${StreamName}	aws:ResourceTag/${TagKey}
consumer	arn:${Partition}:kinesis:${Region}:${Account}:${StreamType}/${StreamName}/consumer/${ConsumerName}:${ConsumerCreationTimpstamp}
kmsKey	arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}

Amazon Kinesis Data Streams에 사용되는 조건 키

Amazon Kinesis Data Streams는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	형식
aws:RequestTag/${TagKey}	요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다.	String
aws:ResourceTag/${TagKey}	리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다.	String
aws:TagKeys	요청에 태그 키가 있는지 여부를 기준으로 액세스를 필터링합니다.	ArrayOfString