查询实例可切换的VPC列表
更新时间 2025-09-25 11:11:17
最近更新时间: 2025-09-25 11:11:17
接口功能介绍
查询实例可切换的VPC、子网及安全组信息
接口约束
无
URI
GET /RDS2/v1/open-api/instance/switchable-vpc-list
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| outerProdInstId | 是 | String | 主机实例id | 9b7ed911dd304bc7891a99918c2b1e4f |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| project-id | 否 | String | 项目id | b829cb71308746a094853c21d5aac0a1 | |
| inst-id | 否 | String | 实例id （和参数outerProdInstId保持一致） | 264729201196525109 | |
| regionId | 是 | String | 资源区regionId，比如实例在资源区A，则需要填写A资源区的regionId | 81f7728662dd11ec810800155d307d5b |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回码 | 0 | |
| message | String | 返回消息 | ||
| returnObj | Array of Objects | 返回对象 | returnObj | |
| error | String | 错误码。当接口失败时才返回具体错误编码，成功不返回或者为空 | MYSQL_10001 | |
| 表 returnObj |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| vpcId | String | vpcId | vpc-ov5hf873s4 | |
| vpcName | String | vpc名称 | vpc-9cb6-20240827 | |
| vpcCIDR | String | vpc主网段（ipv4） | ||
| secondaryCIDRs | Array of Strings | vpc扩展网段 | ||
| availableSubnetList | Array of Objects | 当前vpc下可切换的子网列表 | availableSubnet | |
| securityGroupList | Array of Objects | 当前vpc下的安全组列表 | securityGroup | |
| 表 availableSubnet |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| subnetId | String | 子网id | subnet-q9luojsb90 | |
| subnetName | String | 子网名称 | subnet-9cb6-20240827 | |
| availableIpCount | Integer | 子网可用ip数量 | 65139 | |
| ipv6Cidr | String | ipv6网段 | 240e:981:b22d:f200::/64 | |
| 表 securityGroup |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| securityGroupId | String | 安全组id | sg-xghr6vbeyh | |
| securityGroupName | String | 安全组名称 | Default-Security-Group |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
无
响应示例
{
"statusCode": 0,
"message": "success",
"returnObj": [
{
"availableSubnetList": [
{
"subnetId": "subnet-q9luojsb90",
"availableIpCount": 65128,
"subnetName": "subnet-9cb6-20240827"
}
],
"vpcName": "vpc-9cb6-20240827",
"securityGroupList": [
{
"securityGroupId": "sg-xghr6vbeyh",
"securityGroupName": "Default-Security-Group"
}
],
"secondaryCIDRs": [],
"vpcId": "vpc-ov5hf873s4",
"vpcCIDR": "10.0.0.0/8"
},
{
"availableSubnetList": [
{
"subnetId": "subnet-wo7y4b0qxv",
"availableIpCount": 65020,
"subnetName": "subnet-137c-20240816"
}
],
"vpcName": "vpc-137c-20240816",
"securityGroupList": [
{
"securityGroupId": "sg-myn36zr8l2",
"securityGroupName": "Default-Security-Group"
}
],
"secondaryCIDRs": [],
"vpcId": "vpc-m9gxms1xoe",
"vpcCIDR": "10.0.0.0/8"
},
{
"availableSubnetList": [
{
"subnetId": "subnet-gmkjhdbsyz",
"availableIpCount": 65220,
"subnetName": "subnet-2457-20240806"
}
],
"vpcName": "vpc-2457-20240806",
"securityGroupList": [
{
"securityGroupId": "sg-5n09gduxgc",
"securityGroupName": "Default-Security-Group"
}
],
"secondaryCIDRs": [],
"vpcId": "vpc-de3s11xtwn",
"vpcCIDR": "10.0.0.0/8"
},
{
"availableSubnetList": [
{
"subnetId": "subnet-omm382grk8",
"availableIpCount": 65026,
"subnetName": "subnet-f34a-20240716"
}
],
"vpcName": "vpc-f34a-20240716",
"securityGroupList": [
{
"securityGroupId": "sg-fu0pgxj7tl",
"securityGroupName": "Default-Security-Group"
}
],
"secondaryCIDRs": [],
"vpcId": "vpc-4ly364dlc8",
"vpcCIDR": "10.0.0.0/8"
},
{
"availableSubnetList": [
{
"subnetId": "subnet-g7xq7x1zmj",
"availableIpCount": 65266,
"subnetName": "subnet-e473"
}
],
"vpcName": "vpc-e473-20240627",
"securityGroupList": [
{
"securityGroupId": "sg-hx2x9rit09",
"securityGroupName": "Default-Security-Group"
}
],
"secondaryCIDRs": [],
"vpcId": "vpc-zf7bti40xx",
"vpcCIDR": "10.0.0.0/8"
}
]
}
状态码
请参考 状态码
错误码
请参考 错误码
