查看 Managed Kafka ACL

您可以查看特定 Managed Service for Apache Kafka ACL 资源的详细信息,包括其中包含的各个权限规则或 ACL 条目的列表。此命令可让您检查集群中应用于特定资源模式的当前权限。

所需的角色和权限

如需获得查看(描述)受管 Kafka ACL 所需的权限,请让您的管理员为您授予受管 Kafka ACL 资源的 Managed Kafka ACL Viewer (roles/managedkafka.aclViewer) 或 Managed Kafka Viewer (roles/managedkafka.viewer) IAM 角色。 如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

此预定义角色包含查看(描述)受管 Kafka ACL 所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

如需查看(描述)受管理的 Kafka ACL,需要具备以下权限:

  • 获取(查看)ACL: managedkafka.acls.get

您也可以使用自定义角色或其他预定义角色来获取这些权限。

Managed Kafka ACL Viewer (roles/managedkafka.aclViewer) 或更广泛的 Managed Kafka Viewer (roles/managedkafka.viewer) 角色包含查看 ACL 资源所需的权限。如需了解详情,请参阅 Google Cloud Managed Service for Apache Kafka 预定义角色

查看 ACL

  1. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command:

    gcloud init
  4. 运行 gcloud managed-kafka acls describe 命令:

  5. gcloud managed-kafka acls describe ACL_ID \
      --cluster=CLUSTER_ID \
      --location=LOCATION \

    替换以下内容:

    • ACL_ID(必需):您要查看的 Managed Service for Apache Kafka ACL 资源的唯一 ID。用于标识要检索其详细信息的资源模式。如需详细了解 ACL ID,请参阅 ACL ID
    • CLUSTER_ID(必需):包含 ACL 资源的集群的 ID。
    • LOCATION(必需):集群所在的区域。如需详细了解相应区域,请参阅支持的位置

示例命令

运行以下命令以显示指定 Managed Service for Apache Kafka ACL 资源(名为 test_ACL)的属性。

gcloud managed-kafka acls describe test_ACL \
  --cluster=default-cluster \
  --location=us-central1 \

以下是该命令的输出示例。输出会显示 ACL ID、其适用的资源模式、用于更新的当前 eTag 以及各个 ACL 条目的列表

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

describe 命令的输出提供有关 Managed Service for Apache Kafka ACL 资源的信息:

  • aclEntries:这是一个列表,其中包含为此 ACL 定义的所有访问控制条目(权限规则)。每个条目都包含以下字段:
    • host:ACL 条目的客户端主机。
    • operation:相应条目所适用的 Kafka 操作。
    • permissionType:访问权限是 ALLOW 还是 DENY
    • principal:相应条目所针对的用户或服务账号。
  • etag:这是 ACL 资源的实体标记。它用于在后续更新期间进行乐观并发控制。
  • name:ACL 资源的唯一标识符。其格式为 projects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}
  • patternType:相应 ACL 的资源模式类型,例如 LITERAL
  • resourceName:相应 ACL 所适用的 Kafka 资源的名称。
  • resourceType:Kafka 资源类型。

后续步骤

Apache Kafka® 是 Apache Software Foundation 或其关联公司在美国和/或其他国家/地区的注册商标。