列出所有架构注册表

预览版

此产品或功能 受服务专用条款的约束。 非正式版产品和功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

您可以列出项目中的架构注册表。本文档介绍了如何使用Google Cloud 控制台、Google Cloud CLI 或 Managed Kafka API 列出架构注册表。

所需的角色和权限

如需获得列出架构注册表所需的权限，请让您的管理员向您授予项目和位置的 Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含列出架构注册表所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需列出架构注册表，需要具备以下权限：

• 在父位置授予以下权限： managedkafka.schemaRegistries.list

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

更高级别的角色（例如 Managed Kafka Schema Registry Editor [roles/managedkafka.schemaRegistryEditor] 和 Managed Kafka Schema Registry Admin [roles/managedkafka.schemaRegistryAdmin]）还允许您列出架构注册表。

如需详细了解预定义角色，请参阅 Managed Service for Apache Kafka 预定义角色。

列出架构注册表

如需列出项目中的所有架构注册表，请按以下步骤操作。

控制台

1. 在 Google Cloud 控制台中，前往架构注册表页面。

   前往架构注册表

   该页面会显示项目中的架构注册表列表。该列表包含以下属性对应的列：

   • 名称：架构注册表的唯一标识符。
   • 区域：托管架构注册表的 Google Cloud 区域。

gcloud

1. 安装 Google Cloud CLI。 安装完成后，运行以下命令来初始化 Google Cloud CLI：

   gcloud init

   如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

2. 运行 gcloud beta managed-kafka schema-registries list 命令：

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

替换以下内容：

• LOCATION（必需）：要列出架构注册表的 Google Cloud 区域。

例如，如需列出 us-central1 位置中的所有架构注册表，请运行以下命令：

gcloud beta managed-kafka schema-registries list --location=us-central1

示例输出：

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

如需列出架构注册表，请使用 projects.locations.schemaRegistries.list 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的 Google Cloud 项目 ID
• LOCATION：您要获取架构注册表列表的位置；例如 us-central1

HTTP 方法和网址：

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

返回的 JSON 对象包含指定位置中找到的架构注册表列表。 如果 view 查询参数为 SCHEMA_REGISTRY_VIEW_FULL，则响应还会包含与每个架构注册表关联的上下文。

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