기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon MSK 클러스터용 Apache Kafka API에 사용되는 작업, 리소스 및 조건 키 Amazon MSK 클러스터용 Apache Kafka API Amazon MSK 클러스터용 Apache Kafka API(서비스 접두사: `kafka-cluster`)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다. 참조: + [이 서비스를 구성](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html)하는 방법을 알아봅니다. + [이 서비스에 사용 가능한 API 작업](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html)의 목록을 봅니다. + IAM 권한 정책을 [사용](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html)하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다. **Topics** + [ ## Amazon MSK 클러스터용 Apache Kafka API에서 정의한 작업 ](#apachekafkaapisforamazonmskclusters-actions-as-permissions) + [ ## Amazon MSK 클러스터용 Apache Kafka API에서 정의한 리소스 유형 ](#apachekafkaapisforamazonmskclusters-resources-for-iam-policies) + [ ## Amazon MSK 클러스터용 Apache Kafka API에 대한 조건 키 ](#apachekafkaapisforamazonmskclusters-policy-keys) ## Amazon MSK 클러스터용 Apache Kafka API에서 정의한 작업 작업 IAM 정책 설명의 `Action` 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다. 작업 테이블의 **액세스 레벨** 열은 작업이 분류되는 방법(나열, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 레벨에 대한 자세한 내용은 [정책 요약의 액세스 레벨](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_understand-policy-summary-access-level-summaries.html)을 참조하세요. 작업 테이블의 **리소스 유형** 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 `Resource` 요소에서 정책이 적용되는 모든 리소스("\$1")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(\$1)로 표시됩니다. IAM 정책의 `Resource` 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다. 작업 테이블의 **조건 키** 열에는 정책 설명의 `Condition` 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 **조건 키** 열을 참조하세요. 작업 테이블의 **종속 작업** 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다. **참고** 리소스 조건 키는 [리소스 유형](#apachekafkaapisforamazonmskclusters-resources-for-iam-policies) 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 **리소스 유형(\$1필수)** 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 **조건 키** 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다. 다음 테이블의 열에 대한 자세한 내용은 [작업 테이블](reference_policies_actions-resources-contextkeys.html#actions_table)을 참조하세요. **** | 작업 | 설명 | 액세스 레벨 | 리소스 유형(\$1필수) | 조건 키 | 종속 작업 | | --- | --- | --- | --- | --- | --- | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 ALTER CLUSTER ACL에 해당하는 클러스터의 다양한 측면을 변경할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | kafka-cluster:Connect kafka-cluster:DescribeCluster | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 ALTER\$1CONFIGS CLUSTER ACL에 해당하는 클러스터의 동적 구성을 변경할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | kafka-cluster:Connect kafka-cluster:DescribeClusterDynamicConfiguration | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 READ GROUP ACL에 해당하는 클러스터에서 그룹에 참여할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-group](#apachekafkaapisforamazonmskclusters-group) | | kafka-cluster:Connect kafka-cluster:DescribeGroup | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 ALTER TOPIC ACL에 해당하는 클러스터에서 주제를 변경할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect kafka-cluster:DescribeTopic | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 ALTER\$1CONFIGS TOPIC ACL에 해당하는 클러스터에서 주제의 동적 구성을 변경할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect kafka-cluster:DescribeTopicDynamicConfiguration | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 WRITE TRANSACTIONAL\$1ID ACL에 해당하는 클러스터에서 트랜잭션 ID를 변경할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-transactional-id](#apachekafkaapisforamazonmskclusters-transactional-id) | | kafka-cluster:Connect kafka-cluster:DescribeTransactionalId kafka-cluster:WriteData | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | 클러스터에 연결하고 인증할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 CREATE CLUSTER/TOPIC ACL에 해당하는 클러스터에서 주제를 생성할 수 있는 권한을 부여합니다 | Write | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DELETE GROUP ACL에 해당하는 클러스터에서 그룹을 삭제할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-group](#apachekafkaapisforamazonmskclusters-group) | | kafka-cluster:Connect kafka-cluster:DescribeGroup | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DELETE TOPIC ACL에 해당하는 클러스터에서 주제를 삭제할 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect kafka-cluster:DescribeTopic | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE CLUSTER ACL에 해당하는 클러스터의 다양한 측면을 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE\$1CONFIGS CLUSTER ACL에 해당하는 클러스터의 동적 구성을 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE GROUP ACL에 해당하는 클러스터에서 그룹을 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-group](#apachekafkaapisforamazonmskclusters-group) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE TOPIC ACL에 해당하는 클러스터에서 주제를 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE\$1CONFIGS TOPIC ACL에 해당하는 클러스터에서 주제의 동적 구성을 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 DESCRIBE TRANSACTIONAL\$1ID ACL에 해당하는 클러스터에서 트랜잭션 ID를 설명할 수 있는 권한을 부여합니다. | 나열 | [#apachekafkaapisforamazonmskclusters-transactional-id](#apachekafkaapisforamazonmskclusters-transactional-id) | | kafka-cluster:Connect | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 READ TOPIC ACL에 해당하는 클러스터에서 주제의 데이터를 읽을 수 있는 권한을 부여합니다. | Read | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:AlterGroup kafka-cluster:Connect kafka-cluster:DescribeTopic | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 WRITE TOPIC ACL에 해당하는 클러스터에서 주제에 데이터를 쓸 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic) | | kafka-cluster:Connect kafka-cluster:DescribeTopic | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#actions) | Apache Kafka의 IDEMPOTENT\$1WRITE CLUSTER ACL에 해당하는 클러스터에서 멱등하게 데이터를 쓸 수 있는 권한을 부여합니다. | Write | [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster) | | kafka-cluster:Connect kafka-cluster:WriteData | ## Amazon MSK 클러스터용 Apache Kafka API에서 정의한 리소스 유형 리소스 유형 이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 `Resource` 요소에서 사용할 수 있습니다. [작업 테이블](#apachekafkaapisforamazonmskclusters-actions-as-permissions)의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 [리소스 유형 테이블](reference_policies_actions-resources-contextkeys.html#resources_table)을 참조하세요. **** | 조건 키 | ARN | 조건 키 | | --- | --- | --- | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources) | arn:\$1\$1Partition\$1:kafka:\$1\$1Region\$1:\$1\$1Account\$1:cluster/\$1\$1ClusterName\$1/\$1\$1ClusterUuid\$1 | [#apachekafkaapisforamazonmskclusters-aws_ResourceTag___TagKey_](#apachekafkaapisforamazonmskclusters-aws_ResourceTag___TagKey_) | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources) | arn:\$1\$1Partition\$1:kafka:\$1\$1Region\$1:\$1\$1Account\$1:topic/\$1\$1ClusterName\$1/\$1\$1ClusterUuid\$1/\$1\$1TopicName\$1 | | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources) | arn:\$1\$1Partition\$1:kafka:\$1\$1Region\$1:\$1\$1Account\$1:group/\$1\$1ClusterName\$1/\$1\$1ClusterUuid\$1/\$1\$1GroupName\$1 | | | [https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources](https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html#msk-iam-resources) | arn:\$1\$1Partition\$1:kafka:\$1\$1Region\$1:\$1\$1Account\$1:transactional-id/\$1\$1ClusterName\$1/\$1\$1ClusterUuid\$1/\$1\$1TransactionalId\$1 | | ## Amazon MSK 클러스터용 Apache Kafka API에 대한 조건 키 조건 키 Amazon MSK 클러스터용 Apache Kafka API는 IAM 정책의 `Condition` 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 [조건 키 테이블](reference_policies_actions-resources-contextkeys.html#context_keys_table)을 참조하세요. 모든 서비스에 사용할 수 있는 전역 조건 키를 보려면 [AWS 전역 조건 컨텍스트 키](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html)를 참조하세요. **** | 조건 키 | 설명 | Type | | --- | --- | --- | | [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag) | 리소스에 연결된 태그 키-값 페어를 기준으로 작업을 필터링합니다. 리소스 태그 컨텍스트 키는 주제, 그룹 및 트랜잭션 ID가 아닌 클러스터 리소스에만 적용됩니다. | 문자열 |