本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Managed Streaming for Apache Kafka 的動作、資源和條件索引鍵
Amazon Managed Streaming for Apache Kafka （服務字首：kafka) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
主題
Amazon Managed Streaming for Apache Kafka 定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| BatchAssociateScramSecret | 准許將一或多個 Scram Secrets 與 Amazon MSK 叢集建立關聯 | 寫入 |
kms:CreateGrant kms:RetireGrant |
||
| BatchDisassociateScramSecret | 准許取消一或多個 Scram Secrets 與 Amazon MSK 叢集的關聯 | 寫入 |
kms:RetireGrant |
||
| CreateCluster | 准許建立 MSK 叢集 | 寫入 |
ec2:DescribeSecurityGroups ec2:DescribeSubnets ec2:DescribeVpcs iam:AttachRolePolicy iam:CreateServiceLinkedRole iam:PutRolePolicy kms:CreateGrant kms:DescribeKey |
||
| CreateClusterV2 | 准許建立 MSK 叢集 | 寫入 |
ec2:CreateTags ec2:CreateVpcEndpoint ec2:DeleteVpcEndpoints ec2:DescribeSecurityGroups ec2:DescribeSubnets ec2:DescribeVpcAttribute ec2:DescribeVpcEndpoints ec2:DescribeVpcs iam:AttachRolePolicy iam:CreateServiceLinkedRole iam:PutRolePolicy kms:CreateGrant kms:DescribeKey |
||
| CreateConfiguration | 准許建立 MSK 組態 | 寫入 | |||
| CreateReplicator | 准許建立 MSK 複寫器 | 寫入 |
ec2:DescribeSecurityGroups ec2:DescribeSubnets ec2:DescribeVpcs iam:AttachRolePolicy iam:CreateServiceLinkedRole iam:PassRole iam:PutRolePolicy kafka:DescribeClusterV2 kafka:GetBootstrapBrokers |
||
| CreateVpcConnection | 准許建立 MSK VPC連線 | 寫入 |
ec2:CreateTags ec2:CreateVpcEndpoint ec2:DescribeSecurityGroups ec2:DescribeSubnets ec2:DescribeVpcAttribute ec2:DescribeVpcEndpoints ec2:DescribeVpcs iam:AttachRolePolicy iam:CreateServiceLinkedRole iam:PutRolePolicy |
||
| DeleteCluster | 准許刪除 MSK 叢集 | 寫入 |
ec2:DeleteVpcEndpoints ec2:DescribeVpcAttribute ec2:DescribeVpcEndpoints |
||
| DeleteClusterPolicy | 准許刪除叢集資源型政策 | 寫入 | |||
| DeleteConfiguration | 准許刪除指定的 MSK 組態 | 寫入 | |||
| DeleteReplicator | 准許刪除 MSK 複寫器 | 寫入 | |||
| DeleteVpcConnection | 准許刪除 MSK VPC連線 | 寫入 |
ec2:DeleteVpcEndpoints ec2:DescribeVpcEndpoints |
||
| DescribeCluster | 准許描述 MSK 叢集 | 讀取 | |||
| DescribeClusterOperation | 准許描述指定 ARN 指定的叢集操作 | 讀取 | |||
| DescribeClusterOperationV2 | 准許描述指定 ARN 指定的叢集操作 | 讀取 | |||
| DescribeClusterV2 | 准許描述 MSK 叢集 | 讀取 | |||
| DescribeConfiguration | 准許描述 MSK 組態 | 讀取 | |||
| DescribeConfigurationRevision | 准許描述 MSK 組態修訂 | 讀取 | |||
| DescribeReplicator | 准許描述 MSK 複寫器 | 讀取 | |||
| DescribeVpcConnection | 准許描述 MSK VPC連線 | 讀取 | |||
| GetBootstrapBrokers | 准許取得 MSK 叢集中代理程式的連線詳細資訊 | 讀取 | |||
| GetClusterPolicy | 准許描述叢集資源型政策 | 讀取 | |||
| GetCompatibleKafkaVersions | 准許取得 Apache Kafka 版本的清單，您可以將 MSK 叢集更新至該版本 | 清單 | |||
| ListClientVpcConnections | 准許列出為叢集建立的所有 MSK VPC連線 | 清單 | |||
| ListClusterOperations | 准許傳回已在指定 MSK 叢集上執行的所有操作清單 | 清單 | |||
| ListClusterOperationsV2 | 准許傳回已在指定 MSK 叢集上執行的所有操作清單 | 清單 | |||
| ListClusters | 准許列出此帳戶中的所有 MSK 叢集 | 清單 | |||
| ListClustersV2 | 准許列出此帳戶中的所有 MSK 叢集 | 清單 | |||
| ListConfigurationRevisions | 准許列出此帳戶中 MSK 組態的所有修訂 | 清單 | |||
| ListConfigurations | 准許列出此帳戶中的所有 MSK 組態 | 清單 | |||
| ListKafkaVersions | 准許列出 Amazon MSK 支援的所有 Apache Kafka 版本 | 清單 | |||
| ListNodes | 准許列出 MSK 叢集中的代理程式 | 清單 | |||
| ListReplicators | 准許列出此帳戶中的所有 MSK 複寫器 | 清單 | |||
| ListScramSecrets | 准許列出與 Amazon MSK 叢集相關聯的 Scram Secrets | 清單 | |||
| ListTagsForResource | 准許列出 MSK 資源的標籤 | 讀取 | |||
| ListVpcConnections | 准許列出此帳戶使用的所有 MSK VPC連線 | 清單 | |||
| PutClusterPolicy | 准許為叢集建立或更新資源型政策 | 寫入 | |||
| RebootBroker | 准許重新啟動中介裝置 | 寫入 | |||
| RejectClientVpcConnection | 准許拒絕 MSK VPC連線 | 寫入 | |||
| TagResource | 准許標記 MSK 資源 | 標記 | |||
| UntagResource | 准許從 MSK 資源中移除標籤 | 標記 | |||
| UpdateBrokerCount | 准許更新 MSK 叢集的代理程式數量 | 寫入 | |||
| UpdateBrokerStorage | 准許更新 MSK 叢集代理程式的儲存體大小 | 寫入 | |||
| UpdateBrokerType | 准許更新 Amazon MSK 叢集的代理程式類型 | 寫入 | |||
| UpdateClusterConfiguration | 准許更新 MSK 叢集的組態 | 寫入 | |||
| UpdateClusterKafkaVersion | 准許將 MSK 叢集更新至指定的 Apache Kafka 版本 | 寫入 | |||
| UpdateConfiguration | 准許建立新的 MSK 組態修訂 | 寫入 | |||
| UpdateConnectivity | 准許更新 MSK 叢集的連線設定 | 寫入 |
ec2:DescribeRouteTables ec2:DescribeSubnets |
||
| UpdateMonitoring | 准許更新 MSK 叢集的監控設定 | 寫入 | |||
| UpdateReplicationInfo | 准許更新 MSK 複寫器的複寫資訊 | 寫入 | |||
| UpdateSecurity | 准許更新 MSK 叢集的安全設定 | 寫入 |
kms:RetireGrant |
||
| UpdateStorage | 准許更新與 EBS 代理程式相關聯的 MSK 儲存體 （大小或佈建的輸送量），或將叢集儲存模式設定為 TIERED | 寫入 |
Amazon Managed Streaming for Apache Kafka 定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| cluster |
arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${Uuid}
|
|
| configuration |
arn:${Partition}:kafka:${Region}:${Account}:configuration/${ConfigurationName}/${Uuid}
|
|
| vpc-connection |
arn:${Partition}:kafka:${Region}:${VpcOwnerAccount}:vpc-connection/${ClusterOwnerAccount}/${ClusterName}/${Uuid}
|
|
| replicator |
arn:${Partition}:kafka:${Region}:${Account}:replicator/${ReplicatorName}/${Uuid}
|
|
| topic |
arn:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName}
|
|
| group |
arn:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName}
|
|
| transactional-id |
arn:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId}
|
Amazon Managed Streaming for Apache Kafka 的條件索引鍵
Amazon Managed Streaming for Apache Kafka 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤鍵值對是否存在篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依連接到資源的標籤鍵值對篩選存取權 | 字串 |
| aws:TagKeys | 依請求中是否存在標籤索引鍵來篩選存取 | ArrayOfString |
| kafka:publicAccessEnabled | 依請求中是否存在啟用的公開存取權來篩選存取權 | Bool |
