文档首页/ 云备份 CBR/ API参考/ API/ 任务/ 查询单个任务 - ShowOpLog
更新时间:2026-10-20 GMT+08:00
分享

查询单个任务 - ShowOpLog

功能介绍

根据指定任务ID查询任务

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/{project_id}/operation-logs/{operation_log_id}

表1 路径参数

参数

是否必选

参数类型

描述

operation_log_id

是

String

参数解释:

任务ID,获取方法请参见获取任务ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

project_id

是

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

operation_log

OperationLog object

任务信息

表4 OperationLog

参数

参数类型

描述

checkpoint_id

String

参数解释:

备份记录id

取值范围:

不涉及

created_at

String

参数解释:

任务创建时间,使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ,例如: "2020-02-23T01:00:32Z"

取值范围:

不涉及

ended_at

String

参数解释:

任务结束时间,使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ,例如: "2020-02-23T01:00:32Z"

取值范围:

不涉及

error_info

OpErrorInfo object

参数解释:

任务错误信息

extra_info

OpExtraInfo object

参数解释:

任务扩展信息

id

String

参数解释:

任务id,即operation_log的ID

取值范围:

不涉及

operation_type

String

参数解释:

任务类型

取值范围:

  • backup: 备份

  • copy: 复制

  • replication: 跨Region复制

  • restore: 恢复

  • delete: 删除

  • sync: 同步

  • vault_delete: 删除存储库

  • remove_resource: 解绑资源

  • migrate_resources:迁移资源

  • update_expiration_time: 变更存量保留规则任务

policy_id

String

参数解释:

策略ID,查询方法参考获取策略列表

取值范围:

不涉及

project_id

String

参数解释:

项目ID。

取值范围:

不涉及

provider_id

String

参数解释:

备份提供商ID。用于区分备份对象。

取值范围:

根据备份资源的类型,provider_id的取值分为以下几类

云服务器备份:0daac4c5-6707-4851-97ba-169e36266b66

云硬盘备份:d1603440-187d-4516-af25-121250c7cc97

混合云备份:a13639de-00be-4e94-af30-26912d75e4a2

云数据库备份:8466a52f-e22a-4e59-b4c7-802bbe5a4985

弹性文件系统备份:3f3c3220-245c-4805-b811-758870015881

云桌面备份:86a80900-71bf-4961-956a-d52df944f84a

文件系统备份:85b8590b-a942-4667-ac39-8a4ece2292c0

started_at

String

参数解释:

任务开始时间,使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ,例如: "2020-02-23T01:00:32Z"

取值范围:

不涉及

status

String

参数解释:

任务状态

取值范围:

  • success: 成功

  • skipped: 跳过

  • failed: 失败

  • running: 运行中

  • timeout: 超时

  • waiting: 等待中

updated_at

String

参数解释:

修改时间,使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ,例如: "2020-02-23T01:00:32Z"

取值范围:

不涉及

vault_id

String

参数解释:

任务操作资源所属存储库ID

取值范围:

不涉及

vault_name

String

参数解释:

任务操作资源所属存储库名称

取值范围:

不涉及

表5 OpErrorInfo

参数

参数类型

描述

code

String

参数解释:

任务错误码,用于标识错误类型,请参见错误码

取值范围:

不涉及

message

String

参数解释:

错误信息

取值范围:

不涉及

表6 OpExtraInfo

参数

参数类型

描述

backup

OpExtendInfoBckup object

备份扩展参数

common

OpExtendInfoCommon object

公共参数

delete

OpExtendInfoDelete object

删除扩展参数

sync

OpExtendInfoSync object

扩展同步信息

remove_resources

OpExtendInfoRemoveResources object

移除Vault的资源

replication

OpExtendInfoReplication object

扩展复制信息

resource

OpResourceResp object

资源信息

restore

OpExtendInfoRestore object

扩展恢复信息

vault_delete

OpExtendInfoVaultDelete object

删除vault

update_expiration_time

OpExtendInfoUpdateExpirationTime object

更新过期时间信息

表7 OpExtendInfoBckup

参数

参数类型

描述

app_consistency_error_code

String

参数解释:

应用一致性备份失败错误码。请参见错误码

取值范围:

不涉及

app_consistency_error_message

String

参数解释:

应用一致性备份错误信息

取值范围:

不涉及

app_consistency_status

String

参数解释:

应用一致性备份状态

取值范围:

  • 0: 非应用一致性

  • 1: 应用一致性备份

backup_id

String

参数解释:

备份ID

取值范围:

不涉及

获取方法请参见获取备份ID

backup_name

String

参数解释:

备份名称

取值范围:

最大支持64字符,只能由数字、中文、英文大小写字母,以及下划线"_"和中横线 "-" 字符构成

incremental

String

参数解释:

是否为增量备份

取值范围:

  • "true":是增量备份

  • "false":不是增量备份

表8 OpExtendInfoCommon

参数

参数类型

描述

progress

Integer

参数解释:

对应任务的进度

取值范围:

取值为0-100,单位为%

request_id

String

参数解释:

请求id

取值范围:

不涉及

task_id

String

参数解释:

备份任务id,获取方法请参见获取任务ID

取值范围:

不涉及

表9 OpExtendInfoDelete

参数

参数类型

描述

backup_id

String

参数解释:

备份ID

取值范围:

不涉及

backup_name

String

参数解释:

备份名称

取值范围:

最大支持64字符,只能由数字、中文、英文大小写字母,以及下划线"_"和中横线 "-" 字符构成

表10 OpExtendInfoSync

参数

参数类型

描述

sync_backup_num

Integer

参数解释:

同步备份副本的数量

取值范围:

不涉及

delete_backup_num

Integer

参数解释:

删除的备份副本数量

取值范围:

不涉及

err_sync_backup_num

Integer

参数解释:

同步失败的备份副本数量

取值范围:

不涉及

表11 OpExtendInfoRemoveResources

参数

参数类型

描述

fail_count

Integer

参数解释:

删除失败的资源数量

取值范围:

不涉及

total_count

Integer

参数解释:

删除的备份总数量

取值范围:

不涉及

resources

Array of OpResourceExtraInfoResp objects

参数解释:

资源信息

表12 OpResourceExtraInfoResp

参数

参数类型

描述

exclude_volumes

Array of strings

参数解释:

需要排除备份的卷ID列表,列表元素为String类型的UUID。

取值范围:

不涉及

表13 OpExtendInfoReplication

参数

参数类型

描述

destination_backup_id

String

参数解释:

目标区域备份ID

取值范围:

不涉及

destination_checkpoint_id

String

参数解释:

目标还原点ID

取值范围:

不涉及

destination_project_id

String

参数解释:

目标区域项目ID

取值范围:

不涉及

destination_region

String

参数解释:

目标区域名称

取值范围:

不涉及

source_backup_id

String

参数解释:

源端备份ID

取值范围:

不涉及

source_checkpoint_id

String

参数解释:

源还原点ID

取值范围:

不涉及

source_project_id

String

参数解释:

源端区域的项目ID

取值范围:

不涉及

source_region

String

参数解释:

复制的源区域的名称

取值范围:

不涉及

source_backup_name

String

参数解释:

复制源端的备份的名称

取值范围:

不涉及

destination_backup_name

String

参数解释:

复制目标端的备份的名称

取值范围:

不涉及

表14 OpResourceResp

参数

参数类型

描述

extra_info

OpResourceExtraInfoResp object

参数解释:

资源附加信息

取值范围:

不涉及

id

String

参数解释:

待备份资源ID,用于标识需要备份的资源。

获取方法请参见"查询存储库绑定资源信息","查询资源可保护性"。

取值范围:

格式为UUID

name

String

参数解释:

待备份资源名称,用于标识待备份的资源名称。

取值范围:

长度为0~255个字符。

type

String

参数解释:

待备份资源的类型,用于指定待备份的资源类型,不同类型对应不同的云服务资源。

取值范围:

OS::Nova::Server:云服务器; OS::Cinder::Volume:云硬盘;OS::Ironic::BareMetalServer:裸金属服务器;OS::Sfs::Turbo:SFS Turbo文件系统;OS::Workspace::DesktopV2:云桌面。

表15 OpExtendInfoRestore

参数

参数类型

描述

backup_id

String

参数解释:

备份副本ID

取值范围:

不涉及

backup_name

String

参数解释:

备份名称

取值范围:

最大支持64字符,只能由数字、中文、英文大小写字母,以及下划线"_"和中横线 "-" 字符构成

target_resource_id

String

参数解释:

恢复目标资源ID

取值范围:

格式为UUID,默认取值不涉及

target_resource_name

String

参数解释:

恢复目标资源名称

取值范围:

不涉及

表16 OpExtendInfoVaultDelete

参数

参数类型

描述

fail_count

Integer

参数解释:

本次任务删除失败的资源数量

取值范围:

大于等于零的整数

total_count

Integer

参数解释:

本次任务删除的备份总数

取值范围:

大于等于零的整数

表17 OpExtendInfoUpdateExpirationTime

参数

参数类型

描述

affected_backups_count

Integer

参数解释:

本次任务受影响的备份个数

取值范围:

大于等于零的整数

expiration_day

String

参数解释:

本次任务预期过期日期,格式:YYYY-MM-DD。

取值范围:

不涉及

状态码:404

表18 响应Body参数

参数

参数类型

描述

error_code

String

请参见错误码。

error_msg

String

错误信息

请求示例

GET https://{endpoint}/v3/{project_id}/operation-logs/{operation_log_id}

响应示例

状态码:200

{
  "operation_log" : {
    "status" : "success",
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "checkpoint_id" : "b432511f-d889-428f-8b0e-5f47c524c6b6",
    "updated_at" : "2019-05-23T14:35:23.584+00:00",
    "error_info" : {
      "message" : "",
      "code" : ""
    },
    "started_at" : "2019-05-23T14:31:36.007+00:00",
    "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_1234",
        "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.511+00:00",
    "created_at" : "2019-05-23T14:31:36.039+00:00",
    "operation_type" : "backup",
    "project_id" : "04f1829c788037ac2fb8c01eb2b04b95"
  }
}

状态码:404

{
  "error_code" : "BackupService.6500",
  "error_msg" : "Operation log does not exist."
}

状态码

状态码

描述

200

OK

404

任务ID不存在

错误码

请参见错误码。

相关文档