華為云計(jì)算 云知識(shí) 更新復(fù)制對(duì)名稱UpdateReplicationName
更新復(fù)制對(duì)名稱UpdateReplicationName

 

功能介紹

更新復(fù)制對(duì)名稱。

接口約束

無(wú)

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

PUT /v1/{project_id}/replications/{replication_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。

replication_id

String

replication_id

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

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

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

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

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

參數(shù)

是否必選

參數(shù)類型

描述

replication

UpdateReplicationNameRequestParams object

復(fù)制對(duì)的信息。

表4 UpdateReplicationNameRequestParams

參數(shù)

是否必選

參數(shù)類型

描述

name

String

復(fù)制對(duì)的名稱。最大支持長(zhǎng)度為64個(gè)字節(jié)。只包含中文字符、英文字母(a~z、A~Z)、數(shù)字(0~9)、小數(shù)點(diǎn)(.)、下劃線(_)、中劃線(-)。

最小長(zhǎng)度:1

最大長(zhǎng)度:64

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

replication

ShowReplicationParams object

復(fù)制對(duì)的信息。

表6 ShowReplicationParams

參數(shù)

參數(shù)類型

描述

id

String

復(fù)制對(duì)的ID。

name

String

復(fù)制對(duì)的名稱。

description

String

復(fù)制對(duì)的描述。

status

String

復(fù)制對(duì)的狀態(tài)。

volume_ids

String

復(fù)制對(duì)使用的 云硬盤 ID。

attachment

Array of ReplicationAttachment objects

掛載點(diǎn)。

created_at

String

創(chuàng)建時(shí)間。默認(rèn)格式為:"yyyy-MM-ddTHH:mm:ss.SSSZ",例如:"2019-04-01T12:00:00.000Z"

updated_at

String

更新時(shí)間。默認(rèn)格式為:"yyyy-MM-ddTHH:mm:ss.SSSZ",例如:"2019-04-01T12:00:00.000Z"

replication_model

String

復(fù)制對(duì)的復(fù)制類型。默認(rèn)值為“hypermetro”,表示同步復(fù)制。

progress

Integer

復(fù)制對(duì)的同步進(jìn)度。單位:百分比(%)。

failure_detail

String

僅在復(fù)制對(duì)的狀態(tài)“status”為“error”時(shí),返回的錯(cuò)誤碼。

record_metadata

ReplicationRecordMetadata object

復(fù)制對(duì)的話單數(shù)據(jù)。

fault_level

String

復(fù)制對(duì)的故障等級(jí)。0:表示無(wú)故障。2:表示當(dāng)前生產(chǎn)站點(diǎn)的云硬盤無(wú)讀寫數(shù)據(jù)權(quán)限,此時(shí)建議執(zhí)行故障切換操作。5:表示復(fù)制鏈路已斷,不能執(zhí)行故障切換操作,需聯(lián)系技術(shù)支持工程師。

server_group_id

String

保護(hù)組的ID。

priority_station

String

標(biāo)識(shí)復(fù)制對(duì)所在保護(hù)組的當(dāng)前生產(chǎn)站點(diǎn)可用區(qū)。source:表示當(dāng)前生產(chǎn)站點(diǎn)可用區(qū)為保護(hù)組source_availability_zone的值。target:表示當(dāng)前生產(chǎn)站點(diǎn)可用區(qū)為保護(hù)組target_availability_zone的值。

replication_status

String

數(shù)據(jù)同步狀態(tài)。active:表示數(shù)據(jù)已同步完成。inactive:表示數(shù)據(jù)未同步。copying:表示數(shù)據(jù)正在同步。active-stopped:表示數(shù)據(jù)已停止同步。

枚舉值:

  • active

  • inactive

  • copying

  • active-stopped

表7 ReplicationAttachment

參數(shù)

參數(shù)類型

描述

protected_instance

String

該復(fù)制對(duì)掛載的保護(hù)實(shí)例ID。

device

String

掛載點(diǎn)。

表8 ReplicationRecordMetadata

參數(shù)

參數(shù)類型

描述

multiattach

Boolean

復(fù)制對(duì)中的云硬盤是否為共享云硬盤。

bootable

Boolean

復(fù)制對(duì)中的云硬盤是否為系統(tǒng)盤。

volume_size

Integer

復(fù)制對(duì)中的云硬盤容量。單位:GB

volume_type

String

復(fù)制對(duì)中的云硬盤類型。SATA:普通IO磁盤類型。SAS:高IO磁盤類型。SSD:超高IO磁盤類型。co-p1:高IO(性能優(yōu)化I型)uh-l1:超高IO(時(shí)延優(yōu)化)其中co-p1和uh-l1兩種云硬盤只能使用在HANA 云服務(wù)器 、HL1型云服務(wù)器、HL2型云服務(wù)器上。

枚舉值:

  • SATA

  • SAS

  • SSD

  • co-p1

  • uh-l1

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表10 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表12 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表14 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表16 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表18 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表20 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表22 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表24 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表26 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表28 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表30 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 502

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表32 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表34 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表36 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

請(qǐng)求示例

PUT https://{Endpoint}/v1/{project_id}/replications/b93bc1c4-67ee-45a1-bc8a-d022fdd28811

{
  "replication" : {
    "name" : "new_name"
  }
}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "replication" : {
    "id" : "b93bc1c4-67ee-45a1-bc8a-d022fdd28811",
    "name" : "test_sdrs_replication",
    "description" : "test_description",
    "replication_model" : "hypermetro",
    "status" : "available",
    "progress" : 0,
    "attachment" : [ {
      "device" : "/dev/vda",
      "protected_instance" : "8a7a6339-679b-452b-948c-144e0ef85d9c"
    } ],
    "server_group_id" : "c2aee29a-2959-4d01-9755-01cc76a4d17d",
    "volume_ids" : "48dda0c0-c800-46f2-9728-a519ff783d35,388b324a-a9d1-44a4-a00d-42085f22a9bc",
    "priority_station" : "source",
    "fault_level" : "0",
    "created_at" : "2018-05-04T03:43:24.108526",
    "updated_at" : "2018-05-04T03:44:28.322873",
    "record_metadata" : {
      "multiattach" : false,
      "bootable" : false,
      "volume_size" : 10,
      "volume_type" : "SATA"
    }
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

405

Method Not Allowed

406

Not Acceptable

407

Proxy Authentication Required

408

Request Timeout

409

Conflict

500

Internal Server Error

501

Not Implemented

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

錯(cuò)誤碼

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