列出代管 Kafka ACL

本文說明如何列出為特定 Managed Service for Apache Kafka 叢集定義的 Managed Kafka ACL 資源。

所需角色和權限

如要取得列出代管 Kafka ACL 所需的權限，請要求管理員授予您專案的代管 Kafka ACL 檢視者 (roles/managedkafka.aclViewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 managedkafka.acls.list 權限，可列出代管 Kafka ACL。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

列出 ACL

gcloud managed-kafka acls list CLUSTER_ID \
  --location=LOCATION

指令範例

執行下列指令，查看與名為 kafka-cluster 的叢集相關聯的 ACL 詳細資料：

gcloud managed-kafka acls list kafka-cluster \
  --location=us central1 \

輸出結果會與下列內容相似：

---
aclEntries:
- host: '*'
  operation: ALL
  permissionType: ALLOW
  principal: User:admin@project.iam.gserviceaccount.com
etag: W/da909178
name: projects/gmk-consumer-smjo/locations/us-central1/clusters/default-cluster/acls/allTopics
patternType: LITERAL
resourceName: '*'
resourceType: TOPIC
---
aclEntries:
- host: '*'
  operation: ALL
  permissionType: ALLOW
  principal: User:admin@project.iam.gserviceaccount.com
etag: W/da909178
name: projects/test-project/locations/us-central1/clusters/default-cluster/acls/cluster
patternType: LITERAL
resourceName: kafka-cluster
resourceType: CLUSTER

輸出內容會針對每個 Managed Kafka ACL 資源，列出下列資訊：

• aclEntries：這個 ACL 資源的存取控制項目清單。每個項目都會定義權限規則：

  • host：主體可從中存取資源的主機。'*' 表示任何主機。
  • operation：已授權或拒絕的 Kafka 作業類型。示例：ALL、READ、WRITE。
  • permissionType：作業是否為 ALLOW 或 DENY。
  • principal：ACL 項目適用的使用者或服務帳戶。格式通常為 User:{google_service_account_email} 或萬用字元 User:*。

• etag：用於更新期間的並行控制。

• name：代管 Kafka ACL 資源的專屬 ID，包括專案、位置、叢集和 ACL ID。

• patternType：ACL ID 定義的資源模式類型 (特定資源為 LITERAL，具有共同前置字元的資源為 PREFIXED)。

• resourceName：ACL 適用的 Kafka 資源名稱。 可以是主題名稱、前置字元或萬用字元 (*) 等特定名稱。如果是叢集層級的 ACL，則為 kafka-cluster。

• resourceType：ACL 適用的 Kafka 資源類型，例如 TOPIC、CLUSTER、GROUP、TRANSACTIONAL_ID。

後續步驟

• 建立 ACL

• 查看 ACL

• 更新 ACL

• 刪除 ACL