Creación de una tarea de sincronización de datos para una instancia de StarRocks
Función
Esta API se utiliza para crear una tarea de sincronización de datos para una instancia de StarRocks. Antes de invocar a esta API:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
POST /v3/{project_id}/instances/{instance_id}/starrocks/databases/replication
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto. |
instance_id |
Sí |
String |
ID de instancia de StarRocks, que es compatible con el formato UUID. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. |
X-Language |
Sí |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
source_instance_id |
Sí |
String |
ID de instancia de TaurusDB. |
source_node_id |
No |
String |
ID de réplica de lectura. Si este parámetro se deja en blanco, se utilizará el ID del nodo primario. |
source_database |
Sí |
String |
Base de datos de origen. El valor puede contener entre 3 y 1024 caracteres. Solo se permiten mayúsculas, minúsculas, dígitos y guiones bajos (_). |
target_database |
Sí |
String |
Base de datos de destino. El valor puede contener de 3 a 128 caracteres. Solo se permiten mayúsculas, minúsculas, dígitos y guiones bajos (_). |
task_name |
Sí |
String |
Nombre de la tarea de sincronización. El valor puede contener de 3 a 128 caracteres. Solo se permiten mayúsculas, minúsculas, dígitos y guiones bajos (_). |
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
job_id |
String |
ID de la tarea de sincronización de datos. |
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Ejemplo de la solicitud
POST https://{localhost}/v3/{project_id}/instances/{instance_id}/starrocks/databases/replication { "source_instance_id" : "source_instance_id", "source_node_id" : "source_node_id", "source_database" : "source_database", "target_database" : "target_database", "task_name" : "task_name" }
Ejemplo de la respuesta
Código de estado: 200
Operación exitosa.
{ "job_id" : "123" }
Código de estado: 400
Error de cliente.
{ "error_code" : "DBS.200022", "error_msg" : "Instance not found." }
Código de estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.