列出可用区下交换机。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
selectdb:DescribeVSwitches |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| RegionId |
string |
是 |
地域 ID。 |
cn-hangzhou |
| VpcId |
string |
是 |
实例 VPC ID。 |
vpc-bp175iuvg8nxqraf2**** |
| ZoneId |
string |
是 |
可用区 ID。 |
cn-hangzhou-i |
| PageSize |
integer |
否 |
页数。 |
10 |
| PageNumber |
integer |
否 |
查询页码。 |
1 |
| MaxResults |
integer |
否 |
分页查询时每页行数。 警告 预留参数，暂不支持。 |
20 |
| NextToken |
string |
否 |
下一个查询开始的 Token。 警告 预留参数，暂不支持。 |
4ea98363565e4951e0b5e8707e68181f |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
4773E4EC-025D-509F-AEA9-D53123FDFB0F |
| TotalRecordCount |
string |
总记录数。 |
15 |
| PageNumber |
string |
当前页码。 |
1 |
| PageSize |
string |
每页包含的条目数。 |
10 |
| Items |
array<object> |
结果列表。 |
|
|
object |
结果列表。 |
||
| ZoneId |
string |
可用区 ID。 |
cn-hangzhou-i |
| VSwitchId |
string |
交换机 ID。 |
vsw-bp1usf8eabhvibkkfde96 |
| VSwitchName |
string |
交换机名称。 |
subnet |
| NextToken |
string |
下一个查询开始的 Token，NextToken 为空表示没有下一个。 |
459a0909c0315bfbe0b5e8707e68181f |
| MaxResults |
integer |
分页查询时每页行数。 |
10 |
示例
正常返回示例
JSON格式
{
"RequestId": "4773E4EC-025D-509F-AEA9-D53123FDFB0F",
"TotalRecordCount": "15",
"PageNumber": "1",
"PageSize": "10",
"Items": [
{
"ZoneId": "cn-hangzhou-i",
"VSwitchId": "vsw-bp1usf8eabhvibkkfde96",
"VSwitchName": "subnet"
}
],
"NextToken": "459a0909c0315bfbe0b5e8707e68181f",
"MaxResults": 10
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | SystemError | A system error occurred while processing your request. | 系统异常。 |
| 400 | ClusterNotSupport | Current instance cluster does not support this operation. | 当前集群状态不支持该操作。 |
| 400 | Forbidden | User not authorized to operate on the specified resource, or this API does not support RAM. | 子账号权限不足，请先获取授权。 |
| 400 | InvalidChargeType.NotSupport | The specified parameter "ChargeType" does not meet the requirements. | 当前计费类型不支持此操作。 |
| 400 | InvalidDBName.Duplicate | Specified DB name already exists in the This instance. | 新建集群名称重复。 |
| 400 | InvalidClusterName.Format | Specified ClusterName is not valid. It can not be empty string. | 输入的集群名称参数不合法。 |
| 400 | MinorVersionNotSupport | The instance version does not support the current operation. | 实例版本不支持当前操作。 |
| 403 | DBClusterNotSupported | The requested operation can not be performed while the cluster is not sale. | 当集群未运行时，无法执行请求的操作。 |
| 403 | IncorrectDBInstanceState | Current DB instance state does not support this operation. | 当前实例状态不支持此操作。 |
| 403 | OperationDenied.VirtualClusterBound | The operation is not permitted due to it has been bound to a virtual cluster. | 操作不允许，因为已绑定到虚拟集群。 |
| 404 | DBInstanceLocked | The current instance lock mode does not support this operation. | 操作失败，当前实例已锁定。 |
| 404 | InvalidApi.NotFound | Specified api is not found, please check your url and method. | |
| 404 | InvalidDBInstanceId.NotFound | The DBInstanceId provided does not exist in our records. | SelectDB实例不存在。 |
| 404 | InvalidParam | Invalid parameter, please check. | 无效参数，请检查。 |
| 404 | InvalidClusterName.NotFound | The specified cluster name is not available. | 指定的集群名称不可用 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。