Enumera todos los registros de esquemas

Versión preliminar

Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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 Managed Kafka.

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.

Los roles de nivel superior, como Editor del registro de esquemas de Kafka administrado (roles/managedkafka.schemaRegistryEditor) y Administrador del registro de esquemas de Kafka administrado (roles/managedkafka.schemaRegistryAdmin), también te permiten enumerar los registros de esquemas.

Para obtener más información sobre los roles predefinidos, consulta los roles predefinidos de Managed Service para Apache Kafka.

Enumera tus registros de esquemas

Para enumerar todos los registros de esquemas de tu proyecto, sigue estos pasos.

Console

1. 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 esquemas.

gcloud

1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:

   gcloud init

   Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

2. Ejecuta el comando gcloud beta managed-kafka schema-registries list:

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

Reemplaza lo siguiente:

• LOCATION (obligatorio): Es la Google Cloud región para la que se enumerarán los registros de esquema.

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: El ID de tu 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

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)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$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

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 esquemas que se encontraron 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.

Apache Kafka® es una marca registrada de The Apache Software Foundation o sus afiliados en Estados Unidos y otros países.