Obtención de tareas instantáneas
Función
Esta API se utiliza para obtener las tareas instantáneas. 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}/immediate-jobs
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. |
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
status | No | String | Estado de ejecución de tareas. Valores:
|
job_name | No | String | Nombre de la tarea.
|
job_id | No | String | ID de tarea. |
offset | No | String | Desplazamiento de índice. La consulta comienza desde el primer dato. El valor predeterminado es 1. El valor debe ser un número y no puede ser un número negativo. |
limit | No | String | Número de registros a consultar. Valor: 10 (valor predeterminado), 20 o 50. |
start_time | No | String | Hora de inicio en el formato "yyyy-mm-ddThh:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100. |
end_time | No | String | Hora de finalización en el formato "yyyy-mm-ddThh:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100. |
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 | No | 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 |
|---|---|---|
jobs | Array of TaskDetailInfo objects | Detalles de la tarea. |
total_count | Integer | Número total de tareas. |
Parámetro | Tipo | Descripción |
|---|---|---|
instance_id | String | ID de instancia, que es compatible con el formato UUID. |
instance_name | String | Nombre de instancia. |
instance_status | String | Estado de la instancia. Valores:
|
job_id | String | ID de tarea. |
order_id | String | ID de pedido. |
job_name | String | Nombre de la tarea. Valores:
|
status | String | Estado de ejecución de tareas. Valores:
|
process | String | Progreso de la tarea. |
created_time | String | Hora de creación de la tarea en el formato "yyyy-mm-ddThh:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100. |
ended_time | String | Hora de finalización de la tarea en el formato "yyyy-mm-ddThh:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, si el desplazamiento de la zona horaria es de una hora, el valor de Z es de +0100. |
fail_reason | String | Causa de error de la tarea. |
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
Obtención de las tareas instantáneas
GET https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/immediate-jobs Ejemplo de respuesta
Código de estado: 200
Operación exitosa.
{
"jobs" : [ {
"instance_id" : "ede953923f06448d9be8686ef0c1378ein07",
"instance_name" : "gauss-1234",
"instance_status" : "deleted",
"job_id" : "7155730b-a60b-4dc0-9f89-3f55897f29d6",
"order_id" : "",
"job_name" : "CloseGaussDBforMySQLProxy",
"status" : "Completed",
"process" : "",
"created_time" : "2018-08-06T10:41:14+0000",
"ended_time" : "2018-08-06T12:41:14+0000",
"fail_reason" : "Single task exception."
} ],
"total_count" : 1
} 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.

