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.
