Creación de un tema para una instancia de Kafka
Función
Esta API se utiliza para crear un tema para una instancia de Kafka.
URI
POST /v2/{project_id}/instances/{instance_id}/topics
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
project_id | Sí | String | ID del proyecto. |
instance_id | Sí | String | ID de la instancia |
Parámetros de solicitud
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
id | Sí | String | Nombre del tema, que consta de 4 a 64 caracteres, comienza con una letra y contiene solo letras, guiones (-), guiones bajos (_), y dígitos. |
replication | No | Integer | Número de réplicas, que se configura para garantizar la fiabilidad de los datos. Rango de valores: 1 a 3. |
sync_message_flush | No | Boolean | Si el vaciado síncrono está habilitado. El valor predeterminado es false. El lavado síncrono compromete el rendimiento. |
partition | No | Integer | Número de particiones de tema, que se utiliza para establecer el número de mensajes consumidos simultáneamente. Rango de valores: 1–100. |
sync_replication | No | Boolean | Si la replicación síncrona está habilitada. Después de activar esta función, el parámetro acks en el cliente productor debe establecerse en –1. En caso contrario, este parámetro no tiene efecto. |
retention_time | No | Integer | Período de retención de mensajes. El valor predeterminado es 72. Rango de valores: 1–168. Unidad: hora. |
Parámetros de respuesta
Código de estado: 200
Parámetro | Tipo | Descripción |
|---|---|---|
name | String | Nombre del tema |
Ejemplo de las solicitudes
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/topics
{
"id" : "kafka01"
} Ejemplo de las respuestas
Código de estado: 200
La creación se realiza correctamente.
{
"name" : "kafka01"
} Códigos de estado
Código de estado | Descripción |
|---|---|
200 | La creación se realiza correctamente. |
Códigos de error
Consulte Códigos de error.
