華為云計(jì)算 云知識(shí) 更新備份UpdateBackup
更新備份UpdateBackup

 

功能介紹

根據(jù)備份id更改備份

調(diào)試

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

URI

PUT /v3/{project_id}/backups/{backup_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

backup_id

String

備份ID

project_id

String

項(xiàng)目ID

請(qǐng)求參數(shù)

表2 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

backup

BackupUpdate object

更新請(qǐng)求參數(shù)體

表3 BackupUpdate

參數(shù)

是否必選

參數(shù)類型

描述

name

String

備份名稱

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

backup

BackupResp object

備份副本

表5 BackupResp

參數(shù)

參數(shù)類型

描述

checkpoint_id

String

還原點(diǎn)ID

created_at

String

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

description

String

備份描述

expired_at

String

過期時(shí)間,例如:"2020-02-05T10:38:34.209782"

extend_info

BackupExtendInfo object

擴(kuò)展信息

id

String

備份ID

image_type

String

備份類型。取值為backup和replication。

name

String

備份名稱

parent_id

String

父?jìng)浞軮D

project_id

String

項(xiàng)目ID

protected_at

String

備份時(shí)間

resource_az

String

資源可用區(qū)

resource_id

String

資源ID

resource_name

String

資源名稱

resource_size

Integer

資源大小,單位為GB

resource_type

String

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

status

String

備份狀態(tài)

枚舉值:

  • available

  • protecting

  • deleting

  • restoring

  • error

  • waiting_protect

  • waiting_delete

  • waiting_restore

updated_at

String

更新時(shí)間,例如:"2020-02-05T10:38:34.209782"

vault_id

String

存儲(chǔ)庫ID

replication_records

Array of ReplicationRecordGet objects

復(fù)制記錄

enterprise_project_id

String

企業(yè)項(xiàng)目id,默認(rèn)為‘0’。

provider_id

String

備份提供商ID,用于區(qū)分備份對(duì)象。當(dāng)前取值包含: 0daac4c5-6707-4851-97ba-169e36266b66,該值代表備份對(duì)象為 云服務(wù)器 。d1603440-187d-4516-af25-121250c7cc97,該值代表備份對(duì)象為 云硬盤 。3f3c3220-245c-4805-b811-758870015881, 該值代表備份對(duì)象為 SFS Turbo。a13639de-00be-4e94-af30-26912d75e4a2,該值代表備份對(duì)象為混合云VMware備份。

children

Array of BackupResp objects

子副本列表

表6 BackupExtendInfo

參數(shù)

參數(shù)類型

描述

auto_trigger

Boolean

是否是自動(dòng)生成的備份副本

bootable

Boolean

是否系統(tǒng)盤備份

incremental

Boolean

是否是增備

snapshot_id

String

卷備份副本的快照id

support_lld

Boolean

是否支持lazyloading快速恢復(fù)

supported_restore_mode

String

備份支持恢復(fù)的方式,當(dāng)前取值包含na,snapshot和backup。如果該字段取值為snapshot,代表備份此時(shí)已經(jīng)支持創(chuàng)建整機(jī) 鏡像 ;如果該字段取值為backup,備份支持通過云服務(wù)器上硬盤的備份進(jìn)行恢復(fù);如果該字段取值為na,備份不支持直接恢復(fù),只支持備份創(chuàng)建新資源等操作。

缺省值:na

枚舉值:

  • na

  • backup

  • snapshot

os_images_data

Array of ImageData objects

備份注冊(cè)鏡像ID列表

contain_system_disk

Boolean

整機(jī)備份是否包含系統(tǒng)盤

encrypted

Boolean

是否加密

system_disk

Boolean

是否是系統(tǒng)盤

表7 ImageData

參數(shù)

參數(shù)類型

描述

image_id

String

鏡像ID

表8 ReplicationRecordGet

參數(shù)

參數(shù)類型

描述

created_at

String

復(fù)制的開始時(shí)間

destination_backup_id

String

復(fù)制的目的備份ID

destination_checkpoint_id

String

復(fù)制的目的備份記錄ID

destination_project_id

String

復(fù)制的目標(biāo)項(xiàng)目ID

destination_region

String

復(fù)制的目標(biāo)區(qū)域

destination_vault_id

String

目標(biāo)存儲(chǔ)庫ID

extra_info

ReplicationRecordsExtraInfo object

復(fù)制附加信息

id

String

復(fù)制記錄ID

source_backup_id

String

復(fù)制的源備份ID

source_checkpoint_id

String

復(fù)制的源備份記錄ID

source_project_id

String

復(fù)制的源項(xiàng)目ID

source_region

String

復(fù)制的源區(qū)域

status

String

復(fù)制的狀態(tài)

枚舉值:

  • replicating

  • success

  • fail

  • skip

  • waiting_replicate

vault_id

String

備份所在的存儲(chǔ)庫ID

表9 ReplicationRecordsExtraInfo

參數(shù)

參數(shù)類型

描述

progress

Integer

復(fù)制進(jìn)度

fail_code

String

失敗錯(cuò)誤碼,成功時(shí)為空

fail_reason

String

錯(cuò)誤原因

auto_trigger

Boolean

是否為自動(dòng)調(diào)度復(fù)制

destinatio_vault_id

String

目標(biāo)端的存儲(chǔ)庫id

請(qǐng)求示例

更改指定備份的備份名稱。

PUT https://{endpoint}/v3/4229d7a45436489f8c3dc2b1d35d4987/backup/6df2b54c-dd62-4059-a07c-1b8f24f2725d

{
  "backup" : {
    "name" : "backup-name02"
  }
}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "backup" : {
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
    "enterprise_project_id" : "0",
    "updated_at" : null,
    "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
    "id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
    "resource_az" : "az1.dc1",
    "image_type" : "backup",
    "resource_id" : "94eba8b2-acc9-4d82-badc-127144cc5526",
    "resource_size" : 40,
    "children" : [ {
      "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
      "checkpoint_id" : "8b0851a8-adf3-4f4c-a914-dead08bf9664",
      "updated_at" : null,
      "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce",
      "id" : "5d822633-2bbf-4af8-a16e-5ab1c7705235",
      "resource_az" : null,
      "image_type" : "backup",
      "resource_id" : "eccbcfdd-f843-4bbb-b2c0-a5ce861f9376",
      "resource_size" : 40,
      "children" : [ ],
      "parent_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
      "extend_info" : {
        "auto_trigger" : true,
        "supported_restore_mode" : null,
        "os_images_data" : null,
        "snapshot_id" : "5230a977-1a94-4092-8edd-519303a44cda",
        "bootable" : true,
        "support_lld" : null,
        "encrypted" : true
      },
      "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
      "status" : "available",
      "resource_name" : "ecs-1f0f-0002",
      "description" : null,
      "expired_at" : null,
      "replication_records" : [ ],
      "name" : "autobk_a843_ecs-1f0f-0002",
      "created_at" : "2019-05-10T07:59:59.450700",
      "protected_at" : null,
      "resource_type" : "OS::Cinder::Volume"
    } ],
    "parent_id" : null,
    "extend_info" : {
      "auto_trigger" : true,
      "supported_restore_mode" : "backup",
      "os_images_data" : null,
      "contain_system_disk" : true,
      "snapshot_id" : null,
      "bootable" : null,
      "support_lld" : true
    },
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "status" : "available",
    "resource_name" : "ecs-1f0f-0002",
    "description" : "backup_description",
    "expired_at" : null,
    "replication_records" : [ ],
    "name" : "backup-name02",
    "created_at" : "2019-05-10T07:59:12.084695",
    "protected_at" : null,
    "resource_type" : "OS::Nova::Server"
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯(cuò)誤碼

請(qǐng)參見錯(cuò)誤碼。