describeSpecConfig
描述
查询缓存Redis实例的规格配置信息
请求方式
GET
请求地址
https://redis.jdcloud-api.com/v1/regions/{regionId}/specConfig
| 名称 |
类型 |
是否必需 |
默认值 |
描述 |
| regionId |
String |
True |
|
缓存Redis实例所在区域的Region ID。目前有华北-北京、华南-广州、华东-上海三个区域，Region ID分别为cn-north-1、cn-south-1、cn-east-2 |
请求参数
无
返回参数
| 名称 |
类型 |
描述 |
| result |
Result |
|
| requestId |
String |
|
Result
| 名称 |
类型 |
描述 |
| shardSpec |
Map |
单分片规格，自定义分片规格集群实例才需要 |
| instanceSpec |
InstanceSpec |
实例规格 |
InstanceSpec
| 名称 |
类型 |
描述 |
| region |
String |
region id |
| instanceVersions |
VersionInfo[ ] |
版本信息列表 |
VersionInfo
| 名称 |
类型 |
描述 |
| redisVersion |
String |
redis引擎版本：目前支持2.8、4.0 |
| instanceTypes |
TypeInfo[ ] |
类型信息列表 |
TypeInfo
| 名称 |
类型 |
描述 |
| instanceType |
String |
实例类型：目前支持标准版（master-slave）、集群版（cluster） |
| specs |
SpecInfo[ ] |
规格列表 |
SpecInfo
| 名称 |
类型 |
描述 |
| memoryGB |
Integer |
内存大小（GB） |
| instanceClass |
String |
实例规格，标准版不为空，4.0 自定义分片集群版规格为空，具体规格参考单分片规格 |
| cpu |
Integer |
实例CPU核数，0表示自定义分片集群版规格，CPU核数由分片数变化 |
| diskGB |
Integer |
实例磁盘大小（GB)，0表示自定义分片集群版规格，磁盘大小由分片数变化 |
| maxConnection |
Integer |
最大连接数，0表示自定义分片集群版规格，最大连接数由分片数变化 |
| bandwidthMbps |
Integer |
带宽（Mbps)，0表示自定义分片集群版规格，带宽由分片数变化 |
| ipNumber |
Integer |
需要的IP数，0表示自定义分片集群版规格，IP数由分片数变化 |
| shard |
ShardInfo |
实例的分片列表信息，redis 2.8标准版、集群版以及redis 4.0标准版没有分片列表信息 |
| azs |
String[ ] |
az列表 |
ShardInfo
| 名称 |
类型 |
描述 |
| defaultShardNumber |
Integer |
默认分片数 |
| defaultShardClass |
String |
默认单分片规格代码 |
| shardNumberList |
Integer[ ] |
分片数列表 |
| ipNumberList |
Integer[ ] |
需要的IP数列表 |
返回码
请求示例
GET
@Test
public void testAvailableRegion() {
// 1. 设置请求参数
DescribeSpecConfigRequest request = new DescribeSpecConfigRequest();
request.regionId("cn-north-1");
// 2. 发起请求
DescribeSpecConfigResponse response = redisClient.describeSpecConfig(request);
// 3. 处理响应结果
System.out.println(new Gson().toJson(response));
}
返回示例
{
"requestId": "c3o559jq7qbwwfm9qngbsr7jm99h5me2",
"result": {
"instanceSpec": {
"instanceVersions": [
{
"instanceTypes": [
{
"instanceType": "master-slave",
"specs": [
{
"azs": [
"cn-north-1b",
"cn-north-1c",
"cn-north-1a"
],
"bandwidthMbps": 48,
"cpu": 1,
"diskGB": 20,
"instanceClass": "redis.m.micro.basic",
"ipNumber": 6,
"maxConnection": 10000,
"memoryGB": 1,
"shard": null
}
]
},
{
"instanceType": "cluster",
"specs": [
{
"azs": [
"cn-north-1b",
"cn-north-1c",
"cn-north-1a"
],
"bandwidthMbps": 0,
"cpu": 0,
"diskGB": 0,
"instanceClass": "",
"ipNumber": 0,
"maxConnection": 0,
"memoryGB": 16,
"shard": {
"defaultShardClass": "redis.s.medium.basic",
"defaultShardNumber": 4,
"ipNumberList": [
8,
14,
26
],
"shardNumberList": [
2,
4,
8
]
}
}
]
}
],
"redisVersion": "4.0"
}
],
"region": "cn-north-1"
},
"shardSpec": {
"redis.s.micro.basic": {
"bandwidthMbps": 48,
"cpu": 1,
"diskGB": 20,
"maxConnection": 10000,
"memoryGB": 1,
"shardClass": "redis.s.micro.basic"
},
"redis.s.small.basic": {
"bandwidthMbps": 48,
"cpu": 1,
"diskGB": 20,
"maxConnection": 10000,
"memoryGB": 2,
"shardClass": "redis.s.small.basic"
}
}
}
}
