Consulta de la lista de tareas
Función
Esta API se utiliza para consultar la lista de tareas.
URI
GET /v3/{project_id}/operation-logs
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| project_id | Sí | String | ID de proyecto |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| end_time | No | String | Hora de finalización de una tarea, en formato %YYYY-%mm-%ddT%HH:%MM:%SSZ. Por ejemplo, 2018-02-01T12:00:00Z. |
| enterprise_project_id | No | String | ID de proyecto de empresa o all_granted_eps. all_granted_eps indica consultar los IDs de todos los proyectos de empresa en los que el usuario tiene permisos. |
| limit | No | Integer | Número de registros mostrados por página. El valor debe ser un número positivo entero. Mínimo: 1 |
| offset | No | Integer | Valor de desplazamiento. El valor debe ser un número positivo entero. Mínimo: 1 |
| operation_type | No | String | Tipo de tarea Valores de enumeración:
|
| provider_id | No | String | ID de proveedor de copia de respaldo, que especifica si el objeto de copia de respaldo es un servidor o un disco |
| resource_id | No | String | ID de recurso de copia de seguridad |
| resource_name | No | String | Nombre del recurso de copia de seguridad |
| start_time | No | String | Hora de inicio de una tarea, en formato %YYYY-%mm-%ddT%HH:%MM:%SSZ. Por ejemplo, 2018-01-01T12:00:00Z. |
| status | No | String | Estado de la tarea Valores de enumeración:
|
| vault_id | No | String | ID del almacén al que está asociado el recurso de destino |
| vault_name | No | String | Nombre del almacén al que está asociado el recurso de destino |
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| X-Auth-Token | Sí | String | Token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario. |
Parámetros de respuesta
Código de estado: 200
| Parámetro | Tipo | Descripción |
|---|---|---|
| operation_logs | Array of OperationLog objects | Lista de tareas |
| count | Integer | Número de tareas |
| limit | Integer | Número de registros mostrados en cada página Mínimo: 1 Máximo: 1000 Predeterminado: 1000 |
| offset | Integer | Desplazamiento donde comienza la consulta Mínimo: 0 Predeterminado: 0 |
| Parámetro | Tipo | Descripción |
|---|---|---|
| checkpoint_id | String | ID de registro de copia de seguridad |
| created_at | String | Tiempo de creación, por ejemplo, 2020-02-23T01:00:32Z |
| ended_at | String | Hora de finalización de tareas, por ejemplo, 2020-02-23T01:00:32Z |
| error_info | OpErrorInfo object | Mensaje de error de tarea |
| extra_info | OpExtraInfo object | Información de extensión de tareas |
| id | String | ID de tarea |
| operation_type | String | Tipo de tarea Valores de enumeración:
|
| policy_id | String | ID de política |
| project_id | String | ID de proyecto |
| provider_id | String | ID de proveedor de copia de respaldo, que especifica si el objeto de copia de respaldo es un servidor o un disco |
| started_at | String | Hora de inicio de la tarea, por ejemplo, 2020-02-23T01:00:32Z |
| status | String | Estado de la tarea Valores de enumeración:
|
| updated_at | String | Tiempo de modificación, por ejemplo, 2020-02-23T01:00:32Z |
| vault_id | String | ID del almacén al que está asociado el recurso de destino |
| vault_name | String | Nombre del almacén al que está asociado el recurso de destino |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Para obtener más información, consulte Códigos de error. |
| message | String | Mensaje de error |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup | OpExtendInfoBckup object | Parámetros extendidos de copia de respaldo |
| common | OpExtendInfoCommon object | Parámetros comunes |
| delete | OpExtendInfoDelete object | Parámetros extendidos de eliminación |
| sync | OpExtendInfoSync object | Parámetros extendidos de sincronización |
| remove_resources | OpExtendInfoRemoveResources object | Parámetros extendidos de eliminación de recursos de un almacén |
| replication | OpExtendInfoReplication object | Parámetros extendidos de replicación |
| resource | Resource object | Información del recurso |
| restore | OpExtendInfoRestore object | Parámetros extendidos de restauración |
| vault_delete | OpExtendInfoVaultDelete object | Parámetros extendidos de eliminación de un almacén |
| Parámetro | Tipo | Descripción |
|---|---|---|
| app_consistency_error_code | String | Código de error devuelto si falla la copia de respaldo compatible con la aplicación. Para obtener más información, consulte Códigos de error. |
| app_consistency_error_message | String | Mensaje de error devuelto si falla la copia de respaldo compatible con la aplicación |
| app_consistency_status | String | Estado de backup compatible con las aplicaciones, que se puede establecer en 0 (copia de respaldo no compatible con las aplicaciones) o 1 (copia de respaldo no compatible con las aplicaciones) Valores de enumeración:
|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| incremental | String | Si se utiliza la copia de respaldo incremental Valores de enumeración:
|
| Parámetro | Tipo | Descripción |
|---|---|---|
| progress | Integer | Progreso de la tarea de consulta. El valor varía de 0 a 100. Mínimo: 0 Máximo: 100 |
| request_id | String | ID de solicitud |
| task_id | String | ID de tarea de copia de seguridad |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| Parámetro | Tipo | Descripción |
|---|---|---|
| sync_backup_num | Integer | Número de copias de seguridad sincronizadas |
| delete_backup_num | Integer | Número de copias de seguridad eliminadas |
| err_sync_backup_num | Integer | Número de copias de seguridad que no se sincronizaron |
| Parámetro | Tipo | Descripción |
|---|---|---|
| fail_count | Integer | Número de recursos que no se pueden eliminar |
| total_count | Integer | Número de copias de seguridad eliminadas |
| resources | Array of Resource objects | Información del recurso |
| Parámetro | Tipo | Descripción |
|---|---|---|
| extra_info | ResourceExtraInfo object | Nombre de almacén |
| id | String | ID del tipo de recurso de almacén |
| name | String | Nombre del recurso al que se va a hacer una copia de seguridad. El valor consta de 0 a 255 caracteres. Mínimo: 0 Máximo: 255 |
| type | String | Tipo del recurso que se va a hacer una copia de seguridad, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo |
| Parámetro | Tipo | Descripción |
|---|---|---|
| destination_backup_id | String | ID de copia de respaldo de destino |
| destination_checkpoint_id | String | ID de punto de restauración de destino |
| destination_project_id | String | ID del proyecto de destino |
| destination_region | String | Región de destino |
| source_backup_id | String | ID de copia de respaldo de origen |
| source_checkpoint_id | String | ID de punto de restauración de origen |
| source_project_id | String | ID de proyecto de origen |
| source_region | String | Región de origen |
| source_backup_name | String | Nombre de copia de respaldo de origen |
| destination_backup_name | String | Nombre de la copia de respaldo de destino |
| Parámetro | Tipo | Descripción |
|---|---|---|
| exclude_volumes | Array of strings | ID de los discos de los que no se realizará una copia de seguridad. Este parámetro se utiliza cuando se agregan servidores a un almacén, que incluye todos los discos de servidor. Pero algunos discos no necesitan ser respaldados. O en caso de que se haya agregado un servidor previamente y no sea necesario realizar copias de seguridad de algunos discos de este servidor. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| target_resource_id | String | ID del recurso que se va a restaurar |
| target_resource_name | String | Nombre del recurso que se va a restaurar |
| Parámetro | Tipo | Descripción |
|---|---|---|
| fail_count | Integer | Número de recursos que no se pueden eliminar en esta tarea |
| total_count | Integer | Número de copias de seguridad eliminadas en esta tarea |
Código de estado: 404
| Parámetro | Tipo | Descripción |
|---|---|---|
| operation_logs | Array of OperationLog objects | Lista de tareas |
| count | Integer | Número de tareas |
| limit | Integer | Número de registros mostrados en cada página Mínimo: 1 Máximo: 1000 Predeterminado: 1000 |
| offset | Integer | Desplazamiento donde comienza la consulta Mínimo: 0 Predeterminado: 0 |
| Parámetro | Tipo | Descripción |
|---|---|---|
| checkpoint_id | String | ID de registro de copia de seguridad |
| created_at | String | Tiempo de creación, por ejemplo, 2020-02-23T01:00:32Z |
| ended_at | String | Hora de finalización de tareas, por ejemplo, 2020-02-23T01:00:32Z |
| error_info | OpErrorInfo object | Mensaje de error de tarea |
| extra_info | OpExtraInfo object | Información de extensión de tareas |
| id | String | ID de tarea |
| operation_type | String | Tipo de tarea Valores de enumeración:
|
| policy_id | String | ID de política |
| project_id | String | ID de proyecto |
| provider_id | String | ID de proveedor de copia de respaldo, que especifica si el objeto de copia de respaldo es un servidor o un disco |
| started_at | String | Hora de inicio de la tarea, por ejemplo, 2020-02-23T01:00:32Z |
| status | String | Estado de la tarea Valores de enumeración:
|
| updated_at | String | Tiempo de modificación, por ejemplo, 2020-02-23T01:00:32Z |
| vault_id | String | ID del almacén al que está asociado el recurso de destino |
| vault_name | String | Nombre del almacén al que está asociado el recurso de destino |
| Parámetro | Tipo | Descripción |
|---|---|---|
| code | String | Para obtener más información, consulte Códigos de error. |
| message | String | Mensaje de error |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup | OpExtendInfoBckup object | Parámetros extendidos de copia de respaldo |
| common | OpExtendInfoCommon object | Parámetros comunes |
| delete | OpExtendInfoDelete object | Parámetros extendidos de eliminación |
| sync | OpExtendInfoSync object | Parámetros extendidos de sincronización |
| remove_resources | OpExtendInfoRemoveResources object | Parámetros extendidos de eliminación de recursos de un almacén |
| replication | OpExtendInfoReplication object | Parámetros extendidos de replicación |
| resource | Resource object | Información del recurso |
| restore | OpExtendInfoRestore object | Parámetros extendidos de restauración |
| vault_delete | OpExtendInfoVaultDelete object | Parámetros extendidos de eliminación de un almacén |
| Parámetro | Tipo | Descripción |
|---|---|---|
| app_consistency_error_code | String | Código de error devuelto si falla la copia de respaldo compatible con la aplicación. Para obtener más información, consulte Códigos de error. |
| app_consistency_error_message | String | Mensaje de error devuelto si falla la copia de respaldo compatible con la aplicación |
| app_consistency_status | String | Estado de backup compatible con las aplicaciones, que se puede establecer en 0 (copia de respaldo no compatible con las aplicaciones) o 1 (copia de respaldo no compatible con las aplicaciones) Valores de enumeración:
|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| incremental | String | Si se utiliza la copia de respaldo incremental Valores de enumeración:
|
| Parámetro | Tipo | Descripción |
|---|---|---|
| progress | Integer | Progreso de la tarea de consulta. El valor varía de 0 a 100. Mínimo: 0 Máximo: 100 |
| request_id | String | ID de solicitud |
| task_id | String | ID de tarea de copia de seguridad |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| Parámetro | Tipo | Descripción |
|---|---|---|
| sync_backup_num | Integer | Número de copias de seguridad sincronizadas |
| delete_backup_num | Integer | Número de copias de seguridad eliminadas |
| err_sync_backup_num | Integer | Número de copias de seguridad que no se sincronizaron |
| Parámetro | Tipo | Descripción |
|---|---|---|
| fail_count | Integer | Número de recursos que no se pueden eliminar |
| total_count | Integer | Número de copias de seguridad eliminadas |
| resources | Array of Resource objects | Información del recurso |
| Parámetro | Tipo | Descripción |
|---|---|---|
| extra_info | ResourceExtraInfo object | Nombre de almacén |
| id | String | ID del tipo de recurso de almacén |
| name | String | Nombre del recurso al que se va a hacer una copia de seguridad. El valor consta de 0 a 255 caracteres. Mínimo: 0 Máximo: 255 |
| type | String | Tipo del recurso que se va a hacer una copia de seguridad, que puede ser OS::Nova::Server, OS::Cinder::Volume, o OS::Sfs::Turbo |
| Parámetro | Tipo | Descripción |
|---|---|---|
| destination_backup_id | String | ID de copia de respaldo de destino |
| destination_checkpoint_id | String | ID de punto de restauración de destino |
| destination_project_id | String | ID del proyecto de destino |
| destination_region | String | Región de destino |
| source_backup_id | String | ID de copia de respaldo de origen |
| source_checkpoint_id | String | ID de punto de restauración de origen |
| source_project_id | String | ID de proyecto de origen |
| source_region | String | Región de origen |
| source_backup_name | String | Nombre de copia de respaldo de origen |
| destination_backup_name | String | Nombre de la copia de respaldo de destino |
| Parámetro | Tipo | Descripción |
|---|---|---|
| exclude_volumes | Array of strings | ID de los discos de los que no se realizará una copia de seguridad. Este parámetro se utiliza cuando se agregan servidores a un almacén, que incluye todos los discos de servidor. Pero algunos discos no necesitan ser respaldados. O en caso de que se haya agregado un servidor previamente y no sea necesario realizar copias de seguridad de algunos discos de este servidor. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| backup_id | String | ID de copia de respaldo |
| backup_name | String | Nombre de copia de respaldo |
| target_resource_id | String | ID del recurso que se va a restaurar |
| target_resource_name | String | Nombre del recurso que se va a restaurar |
| Parámetro | Tipo | Descripción |
|---|---|---|
| fail_count | Integer | Número de recursos que no se pueden eliminar en esta tarea |
| total_count | Integer | Número de copias de seguridad eliminadas en esta tarea |
Solicitudes de ejemplo
GET https://{endpoint}/v3/{project_id}/operation-logs Ejemplo de respuestas
Código de estado: 200
OK
{
"count" : 1,
"operation_logs" : [ {
"status" : "success",
"provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
"checkpoint_id" : "b432511f-d889-428f-8b0e-5f47c524c6b6",
"updated_at" : "2019-05-23T14:35:23.584418",
"error_info" : {
"message" : "",
"code" : ""
},
"vault_id" : null,
"started_at" : "2019-05-23T14:31:36.007230",
"id" : "4827f2da-b008-4507-ab7d-42d0df5ed912",
"extra_info" : {
"resource" : {
"type" : "OS::Nova::Server",
"id" : "1dab32fa-ebf2-415a-ab0b-eabe6353bc86",
"name" : "ECS-0001"
},
"backup" : {
"backup_name" : "manualbk_backup",
"backup_id" : "0e5d0ef6-7f0a-4890-b98c-cb12490e31c1"
},
"common" : {
"progress" : 100,
"request_id" : "req-cdb98cc4-e87b-4f40-9b4a-57ec036620bc"
}
},
"ended_at" : "2019-05-23T14:35:23.511155",
"created_at" : "2019-05-23T14:31:36.039365",
"operation_type" : "backup",
"vault_name" : null,
"project_id" : "04f1829c788037ac2fb8c01eb2b04b95",
"policy_id" : null
} ]
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | OK |
| 404 | Not Found |
Códigos de error
Consulte Códigos de error.