華為云計(jì)算 云知識 創(chuàng)建保護(hù)組CreateProtectionGroup
創(chuàng)建保護(hù)組CreateProtectionGroup

 

功能介紹

創(chuàng)建保護(hù)組。 說明: 本接口為異步接口,調(diào)用成功只是表示請求下發(fā),創(chuàng)建結(jié)果需要通過“查詢job狀態(tài)”接口獲取

接口約束

調(diào)試

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

URI

POST /v1/{project_id}/server-groups

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

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的值)

表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

server_group

CreateProtectionGroupRequestParams object

保護(hù)組信息。

表4 CreateProtectionGroupRequestParams

參數(shù)

是否必選

參數(shù)類型

描述

name

String

指定保護(hù)組的名稱,最大支持長度為64個(gè)字節(jié)。只包含中文字符、英文字母(a~z、A~Z)、數(shù)字(0~9)、小數(shù)點(diǎn)(.)、下劃線(_)、中劃線(-)。

最小長度:1

最大長度:64

description

String

指定保護(hù)組的描述,最大支持長度為64個(gè)字節(jié)。不能包含左尖括號(<)或右尖括號(>)。

最小長度:1

最大長度:64

source_availability_zone

String

指定保護(hù)組的生產(chǎn)站點(diǎn)可用區(qū)名稱。

target_availability_zone

String

指定保護(hù)組的容災(zāi)站點(diǎn)可用區(qū)名稱。

domain_id

String

指定雙活域的ID。

source_vpc_id

String

生產(chǎn)站點(diǎn) 虛擬私有云 ID。

dr_type

String

部署模式。默認(rèn)值為“migration”,migration表示VPC內(nèi) 遷移 。

缺省值:migration

枚舉值:

  • migration

響應(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

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表9 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表11 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表13 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 405

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表15 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 406

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表17 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 407

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表19 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 408

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表21 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 409

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表23 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表25 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 501

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表27 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 503

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表29 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 504

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

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

表31 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

請求示例

POST https://{endpoint}/v1/{project_id}/server-groups

{
  "server_group" : {
    "name" : "testname",
    "description" : "description",
    "source_availability_zone" : "cn-north-1a",
    "target_availability_zone" : "cn-north-1b",
    "domain_id" : "fb4bb8e3-a574-4437-a156-78c916aeea4d",
    "source_vpc_id" : "046852ef-c49d-409b-8389-546aaaa5701f",
    "dr_type" : "migration"
  }
}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "job_id" : "0000000062db92d70162db9d200f000a"
}

狀態(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

503

Service Unavailable

504

Gateway Timeout

錯(cuò)誤碼

請參見錯(cuò)誤碼。