前置检查
更新时间:2023-09-21
前置检查
接口描述
本接口用于创建实例组和实例组中添加集群的前置检查。请确保前置检查全部通过后创建多活实例组。
请求结构
Plain Text
1POST /v{version}/syncGroup/check HTTP/1.1
2Host: redis.bj.baidubce.com
3Authorization: authorization string
4{
5 "syncGroupShowId": "syncGroupShowId",
6 "members": [
7 {
8 "memberId": "scs-fsh-ifjmkpkdzceq",
9 "region": "fsh"
10 },
11 {
12 "memberId": "scs-fsh-luoreupenrtn",
13 "region": "fsh"
14 }
15 ]
16}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
version | String | 是 | PATH参数 | API版本号。此处值为2。 |
syncGroupShowId | String | 否 | RequestBody参数 | 多活实例组ID。已有的多活实例组中添加集群时必填,新建多活实例组时不需要改参数。 |
members | List<Member> | 是 | RequestBody参数 | 需要检查的多活组成员的集群ID。 |
Member
参数名称 | 类型 | 描述 |
---|---|---|
memberId | String | 集群ID。 |
region | String | 集群所在地域。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
checkResult | List |
多活组成员检查结果。 |
connectionResults | List |
网络连通性检查结果。 |
CheckItem
参数名称 | 类型 | 描述 |
---|---|---|
memberId | String | 实例组成员集群ID。 |
noData | Boolean | 实例是否无数据。 |
version | Boolean | 实例引擎类型及版本类型是否支持。 |
engineVersion | Boolean | 引擎版本是否支持。说明:Redis企业集群版支持4.0和6.0版本。 |
clusterStatus | Boolean | 网络连通性检查结果。 |
shardNum | Boolean | 实例分片数是否一致。 |
replicationNum | Boolean | 实例副本数是否一致。 |
flavor | Boolean | 实例单分片容量是否一致。 |
notJoined | Boolean | 实例是否未加入实例组。 |
noSecurityGroup | Boolean | 实例是否未关联VPC侧安全组。 |
isHitX1 | Boolean | 集群当前架构是否支持。 |
isAppendOnlyOn | Boolean | 实例是否开启aof。 |
samePasswd | Boolean | 实例密码是否一致。 |
ConnectionItem
参数名称 | 类型 | 描述 |
---|---|---|
sourceId | String | 源实例ID。 |
targetId | String | 目标实例ID。 |
connectable | Boolean | 源端到目标端的连通性是否正常。 |
请求示例
Plain Text
1POST http://redis.fsh.baidubce.com/v2/syncGroup/check
2Host: redis.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "members": [
6 {
7 "memberId": "scs-fsh-ifjmkpkdzceq",
8 "region": "fsh"
9 },
10 {
11 "memberId": "scs-fsh-luoreupenrtn",
12 "region": "fsh"
13 }
14 ]
15}
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "checkResult": [
8 {
9 "memberId": "scs-fsh-ifjmkpkdzceq",
10 "noData": true,
11 "version": true,
12 "engineVersion": true,
13 "clusterStatus": true,
14 "shardNum": false,
15 "replicationNum": true,
16 "flavor": true,
17 "notJoined": true,
18 "noSecurityGroup": true,
19 "isHitX1": true,
20 "isAppendOnlyOn": true,
21 "samePasswd": true
22 },
23 {
24 "memberId": "scs-fsh-luoreupenrtn",
25 "noData": true,
26 "version": true,
27 "engineVersion": true,
28 "clusterStatus": true,
29 "shardNum": false,
30 "replicationNum": true,
31 "flavor": true,
32 "notJoined": true,
33 "noSecurityGroup": true,
34 "isHitX1": true,
35 "isAppendOnlyOn": true,
36 "samePasswd": true
37 }
38 ],
39 "connectionResults": [
40 {
41 "sourceId": "scs-fsh-ifjmkpkdzceq",
42 "targetId": "scs-fsh-luoreupenrtn",
43 "connectable": true
44 },
45 {
46 "sourceId": "scs-fsh-luoreupenrtn",
47 "targetId": "scs-fsh-ifjmkpkdzceq",
48 "connectable": true
49 }
50 ]
51}