Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Cloud Backup and Recovery/ Referencia de la API/ APIs de CBR/ Tareas/ Consulta de la lista de tareas
Actualización más reciente 2023-02-03 GMT+08:00
Ver PDF
Compartir

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

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto
Tabla 2 Parámetros de Query

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:

  • backup
  • delete
  • restore
  • vault_delete
  • remove_resource
  • sync

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:

  • success
  • skipped
  • failed
  • running
  • timeout
  • waiting

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

Tabla 3 Parámetros de encabezado 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

Tabla 4 Parámetros de body de respuesta

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
Tabla 5 OperationLog

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:

  • backup
  • restore
  • delete
  • vault_delete
  • remove_resource

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:

  • success
  • skipped
  • failed
  • running
  • timeout
  • waiting

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
Tabla 6 OpErrorInfo

Parámetro

Tipo

Descripción

code

String

Para obtener más información, consulte Códigos de error.

message

String

Mensaje de error
Tabla 7 OpExtraInfo

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
Tabla 8 OpExtendInfoBckup

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:

  • 0
  • 1

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:

  • "true"
  • "false"
Tabla 9 OpExtendInfoCommon

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
Tabla 10 OpExtendInfoDelete

Parámetro

Tipo

Descripción

backup_id

String

ID de copia de respaldo

backup_name

String

Nombre de copia de respaldo
Tabla 11 OpExtendInfoSync

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
Tabla 12 OpExtendInfoRemoveResources

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
Tabla 13 Resource

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
Tabla 14 OpExtendInfoReplication

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
Tabla 15 ResourceExtraInfo

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.
Tabla 16 OpExtendInfoRestore

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
Tabla 17 OpExtendInfoVaultDelete

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

Tabla 18 Parámetros de body de respuesta

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
Tabla 19 OperationLog

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:

  • backup
  • restore
  • delete
  • vault_delete
  • remove_resource

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:

  • success
  • skipped
  • failed
  • running
  • timeout
  • waiting

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
Tabla 20 OpErrorInfo

Parámetro

Tipo

Descripción

code

String

Para obtener más información, consulte Códigos de error.

message

String

Mensaje de error
Tabla 21 OpExtraInfo

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
Tabla 22 OpExtendInfoBckup

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:

  • 0
  • 1

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:

  • "true"
  • "false"
Tabla 23 OpExtendInfoCommon

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
Tabla 24 OpExtendInfoDelete

Parámetro

Tipo

Descripción

backup_id

String

ID de copia de respaldo

backup_name

String

Nombre de copia de respaldo
Tabla 25 OpExtendInfoSync

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
Tabla 26 OpExtendInfoRemoveResources

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
Tabla 27 Resource

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
Tabla 28 OpExtendInfoReplication

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
Tabla 29 ResourceExtraInfo

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.
Tabla 30 OpExtendInfoRestore

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
Tabla 31 OpExtendInfoVaultDelete

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.

Tema principal: Tareas