Puedes enumerar los registros de esquemas de tu proyecto. En este documento, se muestra cómo enumerar los registros de esquemas con la consola deGoogle Cloud , Google Cloud CLI o la API de Kafka administrado.
Roles y permisos requeridos
Para obtener los permisos que necesitas
para enumerar registros de esquemas,
pídele a tu administrador que te otorgue el rol de IAM
Visualizador del registro de esquemas de Kafka administrado (roles/managedkafka.schemaRegistryViewer) en tu proyecto y ubicación.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para enumerar los registros de esquemas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para enumerar los registros de esquemas:
-
Otorga el siguiente permiso en la ubicación principal:
managedkafka.schemaRegistries.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Enumera tus registros de esquemas
Para enumerar todos tus registros de esquemas dentro de tu proyecto, sigue estos pasos.
Console
- En la consola Google Cloud , ve a la página Registros de esquemas.
Ir a los registros de esquemas
En la página, se muestra una lista de los registros de esquemas de tu proyecto. La lista incluye columnas para las siguientes propiedades:
- Nombre: Es el identificador único del registro de esquemas.
- Región: Es la región Google Cloud en la que se aloja el registro de esquema.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
- Ejecuta el comando
gcloud beta managed-kafka schema-registries list: - LOCATION (obligatorio): Es la Google Cloud región para la que se enumerarán los registros de esquemas.
gcloud beta managed-kafka schema-registries list \ --location=LOCATION \
Reemplaza lo siguiente:
Por ejemplo, para enumerar todos los registros de esquemas en la ubicación us-central1, ejecuta el siguiente comando:
gcloud beta managed-kafka schema-registries list --location=us-central1
Resultado de muestra:
NAME LOCATION sr_docs us-central1 sr_docs23 us-central1 sr23wert us-central1
REST
Para enumerar los registros de esquemas, usa el método
projects.locations.schemaRegistries.list.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
-
PROJECT_ID: ID del proyecto de Google Cloud -
LOCATION: Es la ubicación en la que deseas obtener la lista de registros de esquemas, por ejemplo,us-central1.
Método HTTP y URL:
GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"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"
]
}
}
El objeto JSON que se devuelve incluye una lista de los registros de esquema que se encuentran en la ubicación especificada.
Si el parámetro de consulta view es SCHEMA_REGISTRY_VIEW_FULL, la respuesta también incluye los contextos asociados con cada registro de esquema.