華為云計(jì)算 云知識 查詢單個(gè)任務(wù)ShowOpLog
查詢單個(gè)任務(wù)ShowOpLog

 

功能介紹

根據(jù)指定任務(wù)ID查詢?nèi)蝿?wù)

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

operation_log_id

String

任務(wù)ID

project_id

String

項(xiàng)目ID

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

operation_log

OperationLog object

任務(wù)信息

表4 OperationLog

參數(shù)

參數(shù)類型

描述

checkpoint_id

String

備份記錄id

created_at

String

創(chuàng)建時(shí)間,例如: "2020-02-23T01:00:32Z"

ended_at

String

任務(wù)結(jié)束時(shí)間,例如: "2020-02-23T01:00:32Z"

error_info

OpErrorInfo object

任務(wù)錯(cuò)誤信息

extra_info

OpExtraInfo object

任務(wù)擴(kuò)展信息

id

String

任務(wù)id

operation_type

String

任務(wù)類型

枚舉值:

  • backup

  • copy

  • replication

  • restore

  • delete

  • sync

  • vault_delete

  • remove_resource

policy_id

String

策略ID

project_id

String

項(xiàng)目ID

provider_id

String

備份提供商ID。用于區(qū)分備份對象。

started_at

String

任務(wù)開始時(shí)間,例如: "2020-02-23T01:00:32Z"

status

String

任務(wù)狀態(tài)

枚舉值:

  • success

  • skipped

  • failed

  • running

  • timeout

  • waiting

updated_at

String

修改時(shí)間,例如: "2020-02-23T01:00:32Z"

vault_id

String

任務(wù)操作資源所屬存儲庫ID

vault_name

String

任務(wù)操作資源所屬存儲庫名稱

表5 OpErrorInfo

參數(shù)

參數(shù)類型

描述

code

String

請參見錯(cuò)誤碼。

message

String

錯(cuò)誤信息

表6 OpExtraInfo

參數(shù)

參數(shù)類型

描述

backup

OpExtendInfoBckup object

備份擴(kuò)展參數(shù)

common

OpExtendInfoCommon object

公共參數(shù)

delete

OpExtendInfoDelete object

刪除擴(kuò)展參數(shù)

sync

OpExtendInfoSync object

擴(kuò)展同步信息

remove_resources

OpExtendInfoRemoveResources object

移除Vault的資源

replication

OpExtendInfoReplication object

擴(kuò)展復(fù)制信息

resource

Resource object

資源信息

restore

OpExtendInfoRestore object

擴(kuò)展恢復(fù)信息

vault_delete

OpExtendInfoVaultDelete object

刪除vault

表7 OpExtendInfoBckup

參數(shù)

參數(shù)類型

描述

app_consistency_error_code

String

應(yīng)用一致性備份失敗錯(cuò)誤碼。請參見錯(cuò)誤碼

app_consistency_error_message

String

應(yīng)用一致性備份錯(cuò)誤信息

app_consistency_status

String

應(yīng)用一致性備份狀態(tài);0:非應(yīng)用一致性,1:應(yīng)用一致性備份

枚舉值:

  • 0

  • 1

backup_id

String

備份副本ID

backup_name

String

備份名稱

incremental

String

是否增備

枚舉值:

  • "true"

  • "false"

表8 OpExtendInfoCommon

參數(shù)

參數(shù)類型

描述

progress

Integer

進(jìn)度,取值為0-100

最小值:0

最大值:100

request_id

String

請求id

task_id

String

備份任務(wù)id

表9 OpExtendInfoDelete

參數(shù)

參數(shù)類型

描述

backup_id

String

備份副本ID

backup_name

String

備份名稱

表10 OpExtendInfoSync

參數(shù)

參數(shù)類型

描述

sync_backup_num

Integer

同步備份副本數(shù)

delete_backup_num

Integer

刪除的備份副本數(shù)

err_sync_backup_num

Integer

同步失敗備份副本數(shù)

表11 OpExtendInfoRemoveResources

參數(shù)

參數(shù)類型

描述

fail_count

Integer

刪除失敗的資源數(shù)量

total_count

Integer

刪除的備份數(shù)量

resources

Array of Resource objects

資源信息

表12 Resource

參數(shù)

參數(shù)類型

描述

extra_info

ResourceExtraInfo object

資源附加信息

id

String

待備份資源id

name

String

待備份資源名稱,長度限制:0-255

最小長度:0

最大長度:255

type

String

待備份資源的類型: OS::Nova::Server, OS::Cinder::Volume, OS::Ironic::BareMetalServer, OS::Native::Server, OS::Sfs::Turbo, OS:: Workspace ::DesktopV2

表13 OpExtendInfoReplication

參數(shù)

參數(shù)類型

描述

destination_backup_id

String

目標(biāo)副本ID

destination_checkpoint_id

String

目標(biāo)還原點(diǎn)ID

destination_project_id

String

目標(biāo)project_id

destination_region

String

目標(biāo)區(qū)域

source_backup_id

String

源副本ID

source_checkpoint_id

String

源還原點(diǎn)ID

source_project_id

String

源project_id

source_region

String

源區(qū)域

source_backup_name

String

源備份名稱

destination_backup_name

String

目標(biāo)備份名稱

表14 ResourceExtraInfo

參數(shù)

參數(shù)類型

描述

exclude_volumes

Array of strings

需要排除備份的卷id。僅在多盤備份特性中有效,排除不需要備份的磁盤。當(dāng)虛擬機(jī)新綁定磁盤時(shí),也能繼續(xù)排除之前設(shè)置不用備份的卷。

表15 OpExtendInfoRestore

參數(shù)

參數(shù)類型

描述

backup_id

String

備份副本ID

backup_name

String

備份名稱

target_resource_id

String

恢復(fù)目標(biāo)資源ID

target_resource_name

String

恢復(fù)目標(biāo)資源名稱

表16 OpExtendInfoVaultDelete

參數(shù)

參數(shù)類型

描述

fail_count

Integer

本次任務(wù)刪除失敗的資源數(shù)量

total_count

Integer

本次任務(wù)刪除的備份總數(shù)

狀態(tài)碼: 404

表17 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error_code

String

請參見錯(cuò)誤碼

error_msg

String

錯(cuò)誤信息

請求示例

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

響應(yīng)示例

狀態(tài)碼: 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.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_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.511155",
    "created_at" : "2019-05-23T14:31:36.039365",
    "operation_type" : "backup",
    "vault_name" : null,
    "project_id" : "04f1829c788037ac2fb8c01eb2b04b95",
    "policy_id" : null
  }
}

狀態(tài)碼: 404

任務(wù)ID不存在

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

404

任務(wù)ID不存在

錯(cuò)誤碼

請參見錯(cuò)誤碼。