1. 接口描述
允许已授权的用户通过此接口更新自己的信息
- URL:/v2/webservice/table/table-slave-read-conf
- Method:post
- Content-Type: application/json
- 需要登录:是
- 需要鉴权:是
2. 请求参数
| 参数 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| app_id | Yes | String | |
| zone_id | Yes | String | |
| table_name | Yes | String |
3. 返回data参数说明
| 参数 | 是否必填 | 类型 | 说明 |
|---|---|---|---|
| slave_read_conf | Yes | String | |
| table_name | Yes | String |
3.1. slave_read_conf参数说明
| 参数 | 类型 | 说明 | ||||
|---|---|---|---|---|---|---|
| slave_read_date | 0 | -1 | '日期字符串' | 开启日期, -1表示每天 | ||
| slave_read_hour | 0 | -1 | 数字数组 | 执行时间 | ||
| slave_read_level | 0 | 1 | 2 | 3 | 读分流级别0 (read none)1 (read batch)2 (read multi )3 (read all) | |
| slave_read_ratio | (0~100] | 分流比例 | ||||
| slave_read_retry | 0 | 1 | Slave异常时发给Master |
4. 请求示例
示例1:描述示例1
{
"app_id": 2,
"zone_id": 1,
"table_name":"GenericTableDemo"
}
5. 成功响应
响应示例:没有配置读分流的表
{
"code": 0,
"request_id": "ad7cbeba-5304-4f1f-ba42-3dc3861c957f",
"data": {
"app_id": 5,
"zone_id": 1,
"table_name": "GenericTableDemo",
"table_type": 0,
"slave_read_conf": {
"slave_read_date": 0,
"slave_read_hour": 0,
"slave_read_level": 0,
"slave_read_ratio": 50,
"slave_read_retry": 1
}
}
}
响应示例:配置了读分流的表, 7点,和8点都开启读分流
{
"code": 0,
"request_id": "1d5362d5-89e7-4e80-ae94-131c5b40064b",
"data": {
"app_id": 2,
"zone_id": 1,
"table_name": "GenericTableDemo",
"table_type": 0,
"slave_read_conf": {
"slave_read_date": -1,
"slave_read_hour": [
7,
8
],
"slave_read_level": 1,
"slave_read_ratio": 50,
"slave_read_retry": 0
}
}
}
6. 错误响应
条件:表不存在
响应示例:
{
"request_id": "a040b27a-63f0-4c7d-8757-e36e44dbda1e",
"code": 102,
"message": "表不存在",
"debug_message": {
"app_id": 2,
"zone_id": 1,
"table_name": "GenericTableDemo1"
}
}