Temas de la lista

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 temas dentro de un registro o contexto de esquema específico en tu proyecto.

En este documento, se muestra cómo enumerar 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 del esquema principal: managedkafka.googleapis.com/subjects.list

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

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

Enumera los sujetos 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 deseas 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 temas que se muestran, haz clic en Filtrar. 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 actuales de la aplicación, usa el siguiente comando: 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 esquema, realiza 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): La Google Cloud región 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 formato :.{context}:. Si no se configura, 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 de nombres de asuntos.

A continuación, se muestra un ejemplo de respuesta exitosa 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?

• Más información sobre el registro de esquemas
• Enumera las versiones del asunto
• Cómo registrar una nueva versión del esquema
• Cómo borrar un asunto

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