Temas de la lista

Puedes enumerar los temas dentro de un registro o contexto de esquema específico en tu proyecto.

En este documento, se muestra cómo enumerar los temas con la consola deGoogle Cloud o la API de Managed Kafka.

Roles y permisos requeridos

Para obtener los permisos que necesitas para enumerar temas, pídele a tu administrador que te otorgue el rol de IAM de Visualizador del registro de esquemas de Kafka administrado (roles/managedkafka.schemaRegistryViewer) en tu registro de esquemas o contexto. 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 asuntos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para enumerar los asuntos:

  • Otorga el siguiente permiso en el registro o contexto de esquema principal: managedkafka.googleapis.com/subjects.list

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Enumera los asuntos en un registro de esquemas

Para enumerar todos los temas en un registro o contexto de esquema específico dentro de tu proyecto, sigue estos pasos.

Console

  1. En la consola Google Cloud , ve a la página Registros de esquemas.

    Ir a Registros de esquemas

  2. Haz clic en el nombre del registro de esquemas cuyos detalles quieres ver.

  3. En la página Detalles del registro de esquemas, los sujetos se enumeran en Sujetos en este registro de esquemas.

  4. Opcional: Para filtrar los asuntos que se muestran, haz clic en Filtro. Puedes filtrar por las siguientes propiedades:

    • Nombre
    • Contexto
    • Borrado de forma no definitiva (Sí/No)
  5. Opcional: Para mostrar u ocultar columnas, haz clic en Opciones de visualización de columnas y, luego, selecciona las columnas que deseas ver u ocultar.

REST

La solicitud debe autenticarse con un token de acceso en el encabezado Authorization. Para obtener un token de acceso para las credenciales predeterminadas de la aplicación actuales, usa gcloud auth application-default print-access-token.

Para enumerar los temas directamente en un registro de esquema, realiza una solicitud GET al URI específico con el método projects.locations.schemaRegistries.schemas.subjects.list para el contexto predeterminado.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects
Authorization: Bearer $(gcloud auth application-default print-access-token)

Para enumerar los temas en un contexto dentro de un registro de esquemas, haz una solicitud GET al URI específico con el método projects.locations.schemaRegistries.contexts.schemas.subjects.list:

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/contexts/CONTEXT_ID/subjects?subjectPrefix=SUBJECT_PREFIX
Authorization: Bearer $(gcloud auth application-default print-access-token)

Reemplaza lo siguiente:

  • PROJECT_ID (obligatorio): ID del proyecto de Google Cloud.

  • LOCATION (obligatorio): Es la región Google Cloud en la que se encuentra el registro de esquemas.

  • REGISTRY_ID (obligatorio): Es el ID de tu registro de esquema.

  • CONTEXT_ID (opcional): Es el ID del contexto (si se enumeran temas dentro de un contexto).

  • SUBJECT_PREFIX (opcional): Es el contexto por el que se filtran los temas, en el formato :.{context}:. Si no se establece, se devuelven todos los temas del registro. Si se establece en una cadena vacía, se enumeran los temas en el contexto predeterminado.

Si la solicitud se realiza correctamente, la API devuelve un código de estado 200 OK. El cuerpo de la respuesta contiene un array JSON con los nombres de los temas.

A continuación, se muestra un ejemplo de una respuesta correcta de temas en un array JSON para el contexto predeterminado:

[
  "orders-topic-key",
  "orders-topic-value",
  "user-profile-event"
]

Los temas en contextos no predeterminados se muestran en el formato :.context:subject.

Para obtener más información, consulta la documentación del método projects.locations.schemaRegistries.contexts.schemas.subjects/list.

¿Qué sigue?

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