Consulta de tareas de sincronización de datos de una instancia de StarRocks
Función
Esta API se utiliza para consultar tareas de sincronización de datos de 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
GET /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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
limit |
No |
String |
Número de registros que se van a consultar. Número de tareas de sincronización de datos mostradas en cada página. |
offset |
No |
String |
Desplazamiento de índice. Si offset se establece en N, la consulta comienza desde la pieza N + 1 de dato. El valor predeterminado es 0, lo que indica que la consulta comienza desde el primer dato. El valor debe ser un número pero no puede ser un número negativo. |
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ámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
total_count |
String |
Número total de tareas de sincronización de datos. |
replications |
Array of StarRocksReplicationInfo objects |
Información sobre las tareas de sincronización de datos. |
ext_text |
String |
Campo extendido. |
Parámetro |
Tipo |
Descripción |
---|---|---|
source_database |
String |
Base de datos de TaurusDB. El valor puede contener entre 3 y 1024 caracteres. |
target_database |
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 |
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 (_). |
status |
String |
Estado actual.
|
stage |
String |
Etapa de sincronización.
|
percentage |
String |
Porcentaje de progreso. |
catchup_stage |
String |
Etapa de recuperación.
|
catchup_percentage |
String |
Porcentaje de progreso de recuperación. |
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
Consulta de las 10 primeras tareas de sincronización en la primera página
GET https://{localhost}/v3/{project_id}/instances/{instance_id}/starrocks/databases/replication?offset=1&limit=10
Ejemplo de la respuesta
Código de estado: 200
Operación exitosa.
{ "total_count" : 1, "replications" : [ { "source_database" : "source_database", "target_database" : "target_database", "task_name" : "task_name", "status" : "Yes", "stage" : "Incremental", "percentage" : 100, "catchup_stage" : null, "catchup_percentage" : 0 } ], "ext_text" : null }
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.