创建主备服务器组。一组主备服务器组只能包含两个ECS实例，一个为主服务器，另一个为备服务器。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI
Explorer可以自动生成SDK代码示例。
调试
调试
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| slb:CreateMasterSlaveServerGroup | Write |
|
|
无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 |
传统型负载均衡实例的地域ID。 |
cn-hangzhou |
| LoadBalancerId | string | 是 |
传统型负载均衡实例ID。 |
lb-bp1hv944r69al4j****** |
| MasterSlaveServerGroupName | string | 否 |
主备虚拟服务器组名称。 |
Group1 |
| MasterSlaveBackendServers | string | 是 |
主备服务器组列表。 取值：是一个Json string，其结构是一个JsonList。一次请求中，列表最多支持20个元素。
一个主备服务器组最多可包含2个后端服务器。 如果不指定该参数，则创建一个空的主备服务器组列表。 示例说明如下：
|
[{ “ServerId”: “i-xxxxxxxxx”, “Weight”: “100”, “Type”: “ecs”, “Port”:”82″,”ServerType”:”Master”,”Description”:”test-112″ }, { “ServerId”: “i-xxxxxxxxx”, “Weight”: “100”, “Type”: “ecs”, “Port”:”84″,”ServerType”:”Slave”,”Description”:”test-112″ }] |
| Tag | object [] | 否 |
标签列表。 |
|
| Key | string | 否 |
资源标签键。N的取值范围：1~20。一旦输入该值，则不允许为空字符串。 最多支持64个字符，不能以 |
test |
| Value | string | 否 |
资源的标签值。N的取值范围：1~20。一旦输入该值，可以为空字符串。 |
1 |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| object | |||
| MasterSlaveServerGroupId | string |
主备服务器组ID。 |
rsp-bp19au4****** |
| RequestId | string |
请求ID。 |
7CA4DB76-4D32-523B-822E-5C9494613D46 |
| MasterSlaveBackendServers | object [] |
主备服务器组列表。 |
|
| Type | string |
后端服务器类型，取值：
|
ecs |
| Weight | integer |
后端服务器的权重。 |
100 |
| Description | string |
主备服务器组描述。 |
test-112 |
| Port | integer |
后端服务器使用的端口。 |
82 |
| ServerId | string |
要添加的ECS实例ID或者ENI实例ID。 |
i-bp1fq61enf4loa5i**** |
| ServerType | string |
服务器类型。 取值：Master或Slave。 |
Master |
示例
正常返回示例
JSON格式
{
"MasterSlaveServerGroupId": "rsp-bp19au4******",
"RequestId": "7CA4DB76-4D32-523B-822E-5C9494613D46",
"MasterSlaveBackendServers": {
"MasterSlaveBackendServer": [
{
"Type": "ecs",
"Weight": 100,
"Description": "test-112",
"Port": 82,
"ServerId": "i-bp1fq61enf4loa5i****",
"ServerType": "Master"
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | BACKEND_SERVERS_NUM_MUST_BE_TWO | Backend servers num must be 2. | 后端服务器数量必须是2。 |
| 400 | Mismatched.ZoneId | The zone of the server is not matched with the cloud box loadbalancer. | 当前服务器的可用区与云盒实例可用区不匹配。 |
| 400 | BACKEND_SERVERS_HAVE_SAME_PORT_AND_SERVERID | Backend servers have same port and serverId. | 后端服务器组中已存在具有相同的端口和服务器ID的虚拟服务器。 |
| 400 | BACKEND_SERVERS_CAN_ONLY_CONTAIN_ONE_MASTER_AND_ONE_SLAVE | Backend servers can only contain one master and one slave. | 主备虚拟服务器组只能包含一个主服务器和一个备服务器。 |
| 400 | BACKEND_SERVER_ID_CAN_NOT_EMPTY | Backend server id can not empty. | 后端服务器ID不能为空。 |
| 400 | INVALID_SERVER_TYPE | Invalid server type. | 非法的服务器类型。 |
| 400 | BACKEND_SERVER_PORT_CAN_NOT_EMPTY | Backend server port can not empty. | 后端服务器端口不允许为空。 |
| 400 | RealServerPortNotSupport | Real server port not support. | 后端服务器端口不支持。 |
| 400 | OperationUnsupported.CreateMasterSlaveServerGroup | This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb. | 这种类型的后端服务器不允许附加到 singleTunnel 或 anyTunnel lb。 |
| 400 | IncorrectStatus.RSByPassToas | %s. | 指定后端服务器的BypassToa配置无效。 |
| 400 | OperationFailed.ActionNotSupport | The loadbalancer does not support such action. | 当前实例不支持该操作。 |
| 400 | RsTunnelIp2VmNameConflict | %s. | – |
| 400 | NetworkConflict | %s. | 虚拟服务器组和ECS配置信息不一致。 |
| 400 | InvalidParam.TagValue | %s. | – |
| 400 | InvalidParam.TagKey | %s. | – |
| 400 | SizeLimitExceeded.Tag | %s. | – |
| 400 | MissingParam.TagKey | The param MissingParam.TagKey is missing. | – |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||
|---|---|---|---|---|---|---|
| 2023-06-02 | OpenAPI 错误码发生变更 | 看变更集 | ||||
|
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
阿里云企业补贴进行中： 马上申请
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠
转转请注明出处：https://www.yunxiaoer.com/168754.html