设置备节点优先级
功能介绍
设置副本优先级,主节点故障时,权重越小的备节点切换为主节点的优先级越高。
URI
POST /v2/{project_id}/instances/{instance_id}/groups/{group_id}/replications/{node_id}/slave-priority
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。获取方法请参见获取项目ID。 |
| instance_id | 是 | String | 实例ID。 |
| group_id | 是 | String | 分片ID。 |
| node_id | 是 | String | 节点ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| slave_priority_weight | 是 | Integer | 副本优先级,取值范围是0到100,0为默认禁止倒换。 |
响应参数
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 错误信息。 最大长度:1024 |
| error_code | String | 错误码。 最大长度:9 |
| error_ext_msg | String | 扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 错误信息。 最大长度:1024 |
| error_code | String | 错误码。 最大长度:9 |
| error_ext_msg | String | 扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 错误信息。 最大长度:1024 |
| error_code | String | 错误码。 最大长度:9 |
| error_ext_msg | String | 扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 错误信息。 最大长度:1024 |
| error_code | String | 错误码。 最大长度:9 |
| error_ext_msg | String | 扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_msg | String | 错误信息。 最大长度:1024 |
| error_code | String | 错误码。 最大长度:9 |
| error_ext_msg | String | 扩展错误信息(暂未使用,赋值为null)。 最大长度:1024 |
请求示例
设置实例备节点优先级为100。
POST https://{dcs_endpoint}/v2/{project_id}/instance/{instance_id}/groups/{group_id}/replications/{node_id}/slave-priority
{
"slave_priority_weight" : 100
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 204 | 设置副本优先级成功。 |
| 400 | 非法请求。 |
| 401 | 认证信息非法。 |
| 403 | 请求被拒绝访问。 |
| 404 | 所请求的资源不存在。 |
| 500 | 内部服务错误。 |
错误码
请参见错误码。