功能介紹
對復(fù)制對包含的兩個磁盤進行擴容操作。
接口約束
當復(fù)制對的status為available或者protected或者error-extending時才能進行擴容復(fù)制對操作。 擴容復(fù)制對之前請確認組成復(fù)制對的 云硬盤 狀態(tài)為available或者in-use。 若組成復(fù)制對的云硬盤計費模式為包周期,則不允許擴容復(fù)制對。 如果想增加復(fù)制對中云硬盤的容量,則需要先刪除復(fù)制對,對生產(chǎn)站點云硬盤擴容后再重新創(chuàng)建新的復(fù)制對。 說明: 組成復(fù)制對的云硬盤為非共享云硬盤當非共享云硬盤狀態(tài)為in-use時,若現(xiàn)網(wǎng)支持復(fù)制對在線擴容功能,則允許擴容復(fù)制對,否則不允許。 當非共享云硬盤狀態(tài)為in-use時,允許擴容復(fù)制對。 組成復(fù)制對的云硬盤為共享云硬盤當共享云硬盤狀態(tài)為in-use時,共享云硬盤組成的復(fù)制對不支持在線擴容。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/replications/{replication_id}/action
表1 路徑參數(shù)
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
project_id
|
是
|
String
|
項目ID。
|
|
replication_id
|
是
|
String
|
復(fù)制對的ID。
|
請求參數(shù)
表3 請求Body參數(shù)
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
extend-replication
|
是
|
ExtendReplicationRequestParams object
|
標識磁盤擴容操作。
|
表4 ExtendReplicationRequestParams
|
參數(shù)
|
是否必選
|
參數(shù)類型
|
描述
|
|
new_size
|
是
|
Integer
|
復(fù)制對內(nèi)的磁盤擴容后的最終容量。單位:GB 說明:該參數(shù)的取值為小數(shù)時,系統(tǒng)默認取小數(shù)點前的整數(shù)值。
|
響應(yīng)參數(shù)
狀態(tài)碼: 200
表5 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
job_id
|
String
|
成功返回jobId信息
|
狀態(tài)碼: 400
表6 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表7 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 401
表8 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表9 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 403
表10 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表11 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 404
表12 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表13 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 405
表14 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表15 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 406
表16 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表17 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 407
表18 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表19 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 408
表20 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表21 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 409
表22 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表23 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 500
表24 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表25 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 501
表26 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表27 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 502
表28 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表29 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 503
表30 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表31 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
狀態(tài)碼: 504
表32 響應(yīng)Body參數(shù)
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
error
|
ErrorInfo object
|
失敗返回結(jié)構(gòu)
|
表33 ErrorInfo
|
參數(shù)
|
參數(shù)類型
|
描述
|
|
message
|
String
|
錯誤信息
|
|
code
|
String
|
錯誤碼
|
請求示例
POST https://{Endpoint}/v1/{project_id}/replications/b93bc1c4-67ee-45a1-bc8a-d022fdd28811/action
{
"extend-replication" : {
"new_size" : 10
}
}
響應(yīng)示例
狀態(tài)碼: 200
OK
{
"job_id" : "0000000011db92d34587db9d20df32ch"
}
狀態(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
|