華為云計算 云知識 查詢備份還原點ShowCheckpoint
查詢備份還原點ShowCheckpoint

 

功能介紹

根據(jù)還原點ID查詢指定還原點

調(diào)試

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

URI

GET /v3/{project_id}/checkpoints/{checkpoint_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

checkpoint_id

String

還原點ID

project_id

String

項目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ù)類型

描述

checkpoint

CheckpointCreate object

還原點信息

表4 CheckpointCreate

參數(shù)

參數(shù)類型

描述

created_at

String

創(chuàng)建時間,例如:"2020-02-05T10:38:34.209782"

id

String

還原點ID

project_id

String

項目ID

status

String

狀態(tài):available,deleting,protecting,deleted,error-deleting,error

枚舉值:

  • available

  • deleting

  • protecting

  • deleted

  • error-deleting

  • error

vault

CheckpointPlanCreate object

存儲庫信息

extra_info

CheckpointExtraInfoResp object

擴展信息

表5 CheckpointPlanCreate

參數(shù)

參數(shù)類型

描述

id

String

存儲庫id

name

String

存儲庫名稱

resources

Array of CheckpointResourceResp objects

備份對象

skipped_resources

Array of CheckpointCreateSkippedResource objects

備份時跳過的資源列表

表6 CheckpointResourceResp

參數(shù)

參數(shù)類型

描述

extra_info

String

資源附加信息

id

String

待備份資源id

name

String

待備份資源名稱

protect_status

String

保護狀態(tài)。available(可用),error(錯誤),protecting(備份中),restoring(恢復中),removing(刪除中)。

枚舉值:

  • available

  • error

  • protecting

  • restoring

  • removing

resource_size

String

資源已分配容量,單位為GB

type

String

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

backup_size

String

副本大小

backup_count

String

副本數(shù)量

表7 CheckpointCreateSkippedResource

參數(shù)

參數(shù)類型

描述

id

String

資源ID

type

String

資源類型

name

String

資源名稱

code

String

請參見錯誤碼。

reason

String

跳過原因,例如:該資源正在備份中。

表8 CheckpointExtraInfoResp

參數(shù)

參數(shù)類型

描述

name

String

備份名稱

description

String

備份描述

retention_duration

Integer

備份保留天數(shù)

請求示例

GET https://{endpoint}/v3/4229d7a45436489f8c3dc2b1d35d4987/checkpoints/8b0851a8-adf3-4f4c-a914-dead08bf9664

 

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "checkpoint" : {
    "status" : "available",
    "created_at" : "2019-05-10T07:59:12.036982",
    "vault" : {
      "id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
      "resources" : [ {
        "name" : "ecs-1f0f-0002",
        "resource_size" : "40",
        "protect_status" : "available",
        "type" : "OS::Nova::Server",
        "id" : "94eba8b2-acc9-4d82-badc-127144cc5526",
        "extra_info" : null
      } ],
      "name" : "vault-be94"
    },
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
    "extra_info" : null
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼。