本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 適用於 Amazon MSK 叢集之 Apache Kafka API 的動作、資源和條件索引鍵
<a name="list_apachekafkaapisforamazonmskclusters"></a>

適用於 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 定義的動作
<a name="apachekafkaapisforamazonmskclusters-actions-as-permissions"></a>

您可在 IAM 政策陳述式的 `Action` 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

動作資料表的**存取層級**欄說明動作的分類方式 （列出、讀取、許可管理或標記）。此分類可協助您了解在政策中使用某動作時，該動作授予您的存取層級。如需存取層級的詳細資訊，請參閱[政策摘要中的存取層級](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_understand-policy-summary-access-level-summaries.html)。

「動作」資料表的**資源類型**欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 `Resource` 元素中指定政策適用的所有資源 ("\*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (\*) 表示。如果您使用 IAM 政策中的 `Resource` 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的**條件索引鍵**欄包含您可以在政策陳述式的 `Condition` 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的**條件索引鍵**欄。

動作資料表的**相依動作**欄會顯示成功呼叫動作所需的其他許可。除了 動作本身的許可之外，還可能需要這些許可。當動作指定相依動作時，這些相依性可能適用於針對該動作定義的其他資源，而不只是資料表中列出的第一個資源。

**注意**  
資源條件索引鍵會列在[資源類型](#apachekafkaapisforamazonmskclusters-resources-for-iam-policies)資料表中。您可以在「動作」資料表的**資源類型 (\*必填) **欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括**條件索引鍵**欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱[動作資料表](reference_policies_actions-resources-contextkeys.html#actions_table)。


****  

| 動作 | 描述 | 存取層級 | 資源類型 (\*必填項目) | 條件索引鍵 | 相依動作 | 
| --- | --- | --- | --- | --- | --- | 
|   [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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster)  |  |  kafka-cluster:Connect <br /> 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\_CONFIGS CLUSTER ACL | 寫入 |  [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster)  |  |  kafka-cluster:Connect <br /> 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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-group](#apachekafkaapisforamazonmskclusters-group)  |  |  kafka-cluster:Connect <br /> 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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic)  |  |  kafka-cluster:Connect <br /> 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\_CONFIGS TOPIC ACL | 寫入 |  [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic)  |  |  kafka-cluster:Connect <br /> 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)  | 准許改變叢集上的交易 ID，相當於 Apache Kafka 的 WRITE TRANSACTIONAL\_ID ACL | 寫入 |  [#apachekafkaapisforamazonmskclusters-transactional-id](#apachekafkaapisforamazonmskclusters-transactional-id)  |  |  kafka-cluster:Connect <br /> kafka-cluster:DescribeTransactionalId <br /> 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)  | 准許連線和身分驗證叢集 | 寫入 |  [#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 | 寫入 |  [#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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-group](#apachekafkaapisforamazonmskclusters-group)  |  |  kafka-cluster:Connect <br /> 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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic)  |  |  kafka-cluster:Connect <br /> 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\_CONFIGS 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\_CONFIGS 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)  | 准許描述叢集上的交易 ID，相當於 Apache Kafka 的 DESCRIBE TRANSACTIONAL\_ID ACL | 列出 |  [#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 | 讀取 |  [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic)  |  |  kafka-cluster:AlterGroup <br /> kafka-cluster:Connect <br /> 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 | 寫入 |  [#apachekafkaapisforamazonmskclusters-topic](#apachekafkaapisforamazonmskclusters-topic)  |  |  kafka-cluster:Connect <br /> 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\_WRITE CLUSTER ACL | 寫入 |  [#apachekafkaapisforamazonmskclusters-cluster](#apachekafkaapisforamazonmskclusters-cluster)  |  |  kafka-cluster:Connect <br /> kafka-cluster:WriteData  | 

## 適用於 Amazon MSK 叢集之 Apache Kafka API 定義的資料類型
<a name="apachekafkaapisforamazonmskclusters-resources-for-iam-policies"></a>

此服務會定義下列資源類型，並可用在 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:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid}  |  [#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:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName}  |  | 
|   [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:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName}  |  | 
|   [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:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId}  |  | 

## 適用於 Amazon MSK 叢集之 Apache Kafka API 的條件索引鍵
<a name="apachekafkaapisforamazonmskclusters-policy-keys"></a>

適用於 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)。


****  

| 條件索引鍵 | 描述 | 類型 | 
| --- | --- | --- | 
|   [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 | 字串 |