DescribeRdsVpcs - 查询VPC列表_云原生数据库 PolarDB(PolarDB)-阿里云帮助中心

查询VPC信息列表

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

polardb:DescribeRdsVpcs

get

*DBCluster

acs:polardb:{#regionId}:{#accountId}:{#resource-type}/*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 id。>可通过接口 describeregions 查看可用的地域。	cn-hangzhou
ZoneId	string	否	可用区 id。	cn-hangzhou-k
ResourceGroupId	string	否	资源组 id。	rg-************

返回参数

名称	类型	描述	示例值
	object
Vpcs	object	VPC 列表
Vpc	array<object>	vpc 信息。
	object	vpc 信息。
Status	string	VPC 的状态，取值： Pending：配置中。 Available：可用。	Available
VpcName	string	vpc 的名称。	fc-webide
VpcId	string	vpc 的 id。	vpc-*************
IsDefault	boolean	是否是默认 vpc。	true
CidrBlock	string	VPC 的网段。	10.21.0.0/16
RegionNo	string	地域 id。	cn-hangzhou
GmtCreate	string	创建时间。	2025-08-28T02:25:41Z
AliUid	string	阿里云账户 id。	1485293698******
VSwitchs	array<object>	vpc 的交换机信息。
	object	vpc 的交换机信息。
Status	string	vSwitch 状态。Available 表示可用。	Available
VSwitchId	string	交换机 id。	vsw-**********
IsDefault	boolean	是否是默认交换机，取值： true：是默认交换机。 false：非默认交换机。	true
CidrBlock	string	交换机网段。	192.168.7.0/24
GmtCreate	string	创建时间。	2025-05-12 18:17:25
GmtModified	string	最后修改时间。	2025-01-07T15:10:32+08:00
IzNo	string	可用区 id。	cn-hangzhou-k
VSwitchName	string	交换机名称。	test
GmtModified	string	最后修改时间。	2025-04-30T09:41:14+08:00
Bid	string	区分账户是金融云、政务云或公有云。	26842
RequestId	string	请求 id。	B45E8D29-EA17-5141-AE09-F7A399760C9E

示例

正常返回示例

JSON格式

{
  "Vpcs": {
    "Vpc": [
      {
        "Status": "Available",
        "VpcName": "fc-webide",
        "VpcId": "vpc-*************",
        "IsDefault": true,
        "CidrBlock": "10.21.0.0/16",
        "RegionNo": "cn-hangzhou",
        "GmtCreate": "2025-08-28T02:25:41Z",
        "AliUid": "1485293698******",
        "VSwitchs": [
          {
            "Status": "Available",
            "VSwitchId": "vsw-**********",
            "IsDefault": true,
            "CidrBlock": "192.168.7.0/24",
            "GmtCreate": "2025-05-12 18:17:25",
            "GmtModified": "2025-01-07T15:10:32+08:00",
            "IzNo": "cn-hangzhou-k",
            "VSwitchName": "test"
          }
        ],
        "GmtModified": "2025-04-30T09:41:14+08:00",
        "Bid": "26842"
      }
    ]
  },
  "RequestId": "B45E8D29-EA17-5141-AE09-F7A399760C9E"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。