# 查询单个任务 - ShowOpLog #### 功能介绍 根据指定任务ID查询任务 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI GET /v3/{project_id}/operation-logs/{operation_log_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | operation_log_id | 是 | String | **参数解释：** 任务ID，获取方法请参见[获取任务ID](https://support.huaweicloud.com/api-cbr/ListOpLogs.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | project_id | 是 | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | operation_log | [OperationLog] object | 任务信息 | 表4OperationLog | 参数 | 参数类型 | 描述 | |:---|:---|:---| | checkpoint_id | String | **参数解释：** 备份记录id **取值范围：** 不涉及 | | created_at | String | 创建时间,例如: "2020-02-23T01:00:32Z" | | ended_at | String | 任务结束时间,例如: "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，查询方法参考[获取策略列表](https://support.huaweicloud.com/api-cbr/ListPolicies.html) **取值范围：** 不涉及 | | project_id | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html) **取值范围：** 不涉及 | | 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 | 任务开始时间,例如: "2020-02-23T01:00:32Z" | | status | String | **参数解释：** 任务状态 **取值范围：** - success: 成功 - skipped: 跳过 - failed: 失败 - running: 运行中 - timeout: 超时 - waiting: 等待中 | | updated_at | String | 修改时间,例如: "2020-02-23T01:00:32Z" | | vault_id | String | **参数解释：** 任务操作资源所属存储库ID **取值范围：** 不涉及 | | vault_name | String | **参数解释：** 任务操作资源所属存储库名称 **取值范围：** 不涉及 | 表5OpErrorInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | 请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。 | | message | String | 错误信息 | 表6OpExtraInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backup | [OpExtendInfoBckup] object | 备份扩展参数 | | common | [OpExtendInfoCommon] object | 公共参数 | | delete | [OpExtendInfoDelete] object | 删除扩展参数 | | sync | [OpExtendInfoSync] object | 扩展同步信息 | | remove_resources | [OpExtendInfoRemoveResources] object | 移除Vault的资源 | | replication | [OpExtendInfoReplication] object | 扩展复制信息 | | resource | [Resource] object | 资源信息 | | restore | [OpExtendInfoRestore] object | 扩展恢复信息 | | vault_delete | [OpExtendInfoVaultDelete] object | 删除vault | | update_expiration_time | [OpExtendInfoUpdateExpirationTime] object | 更新过期时间信息 | 表7OpExtendInfoBckup | 参数 | 参数类型 | 描述 | |:---|:---|:---| | app_consistency_error_code | String | 应用一致性备份失败错误码。请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。 | | app_consistency_error_message | String | 应用一致性备份错误信息 | | app_consistency_status | String | **参数解释：** 应用一致性备份状态 **取值范围：** - 0: 非应用一致性 - 1: 应用一致性备份 | | backup_id | String | **参数解释：** 备份ID **取值范围：** 不涉及 获取方法请参见[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html) | | backup_name | String | **参数解释：** 备份名称 **取值范围：** 最大支持64字符，只能由数字、中文、英文大小写字母，以及下划线"_"和中横线 "-" 字符构成。默认取值不涉及。 | | incremental | String | **参数解释：** 是否为增量备份 **取值范围：** - "true"：是增量备份 - "false"：不是增量备份 | 表8OpExtendInfoCommon | 参数 | 参数类型 | 描述 | |:---|:---|:---| | progress | Integer | 进度，取值为0-100 | | request_id | String | **参数解释：** 请求id **取值范围：** 不涉及 | | task_id | String | **参数解释：** 备份任务id，获取方法请参见[获取任务ID](https://support.huaweicloud.com/api-cbr/ListOpLogs.html) **取值范围：** 不涉及 | 表9OpExtendInfoDelete | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backup_id | String | 备份ID。默认取值不涉及。 获取方法请参见[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html) | | backup_name | String | 备份名称，最大支持64字符，只能由数字、中文、英文大小写字母，以及下划线"_"和中横线 "-" 字符构成。默认取值不涉及。 | 表10OpExtendInfoSync | 参数 | 参数类型 | 描述 | |:---|:---|:---| | sync_backup_num | Integer | 同步备份副本数 | | delete_backup_num | Integer | 删除的备份副本数 | | err_sync_backup_num | Integer | 同步失败备份副本数 | 表11OpExtendInfoRemoveResources | 参数 | 参数类型 | 描述 | |:---|:---|:---| | fail_count | Integer | 删除失败的资源数量 | | total_count | Integer | 删除的备份数量 | | resources | Array of [Resource] objects | 资源信息 | 表12Resource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | extra_info | [ResourceExtraInfo] object | 资源附加信息 | | id | String | 待备份资源id，需要该资源已经绑定到该存储库中，且属于可备份的状态。默认取值不涉及。 获取方法请参见"[查询存储库绑定资源信息](https://support.huaweicloud.com/api-cbr/ShowVault.html)"，"[查询资源可保护性](https://support.huaweicloud.com/api-cbr/ShowProtectable.html)"。 | | name | String | 待备份资源名称，长度限制：0-255字符。默认取值不涉及。 | | type | String | 待备份资源的类型: OS::Nova::Server：云服务器； OS::Cinder::Volume：云硬盘；OS::Ironic::BareMetalServer：裸金属服务器；OS::Sfs::Turbo：SFS Turbo文件系统；OS::Workspace::DesktopV2：云桌面。默认取值不涉及。 | 表13OpExtendInfoReplication | 参数 | 参数类型 | 描述 | |:---|:---|:---| | destination_backup_id | String | 目标区域备份ID，默认取值不涉及。 获取方法请参见"[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html)"，其中project_id需填写目标区域的project_id。 | | destination_checkpoint_id | String | 目标还原点ID | | destination_project_id | String | 目标区域项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 | | destination_region | String | 目标区域，默认取值不涉及。 获取方法请参见"[地区和终端节点查询](https://console.huaweicloud.com/apiexplorer/#/endpoint/CBR)"。 | | source_backup_id | String | 源端备份ID，默认取值不涉及。 获取方法请参见"[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html)"，其中project_id需填写源端的project_id。 | | source_checkpoint_id | String | 源还原点ID | | source_project_id | String | 源端区域的项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 | | source_region | String | 复制的源区域。默认取值不涉及。 获取方法请参见"[地区和终端节点查询](https://console.huaweicloud.com/apiexplorer/#/endpoint/CBR)"。 | | source_backup_name | String | 源备份名称 | | destination_backup_name | String | 目标备份名称 | 表14ResourceExtraInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | exclude_volumes | Array of strings | **参数解释：** 需要排除备份的卷id。仅在多盘备份特性中有效，排除不需要备份的磁盘。当虚拟机新绑定磁盘时，也能继续排除之前设置不用备份的卷 **取值范围：** 不涉及 | 表15OpExtendInfoRestore | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backup_id | String | 备份副本ID，默认取值不涉及。 获取方法请参见"[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html)"。 | | backup_name | String | 备份名称，最大支持64字符，只能由数字、中文、英文大小写字母，以及下划线"_"和中横线 "-" 字符构成。默认取值不涉及。 | | target_resource_id | String | **参数解释：** 恢复目标资源ID **取值范围：** 格式为UUID，默认取值不涉及 | | target_resource_name | String | **参数解释：** 恢复目标资源名称 **取值范围：** 不涉及 | 表16OpExtendInfoVaultDelete | 参数 | 参数类型 | 描述 | |:---|:---|:---| | fail_count | Integer | 本次任务删除失败的资源数量 | | total_count | Integer | 本次任务删除的备份总数 | 表17OpExtendInfoUpdateExpirationTime | 参数 | 参数类型 | 描述 | |:---|:---|:---| | affected_backups_count | Integer | 本次任务受影响的备份个数 | | expiration_day | String | 本次任务预期过期日期，格式：YYYY-MM-DD。 | **状态码：404** 表18响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。 | | error_msg | String | 错误信息 | #### 请求示例 ``` GET https://{endpoint}/v3/{project_id}/operation-logs/{operation_log_id} ``` #### 响应示例 **状态码：200** OK ``` { "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** 任务ID不存在 ``` { "error_code" : "BackupService.6500", "error_msg" : "Operation log does not exist." } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 404 | 任务ID不存在 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。