调用ListGrantVSwitchesToCen接口查询云企业网实例已连接的跨账号专有网络VPC(Virtual Private Cloud)下交换机的信息。

使用说明

在调用ListGrantVSwitchesToCen接口前,请确保:

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListGrantVSwitchesToCen

系统规定参数。取值:ListGrantVSwitchesToCen

RegionId String cn-hangzhou

VPC实例所属地域ID。

您可以调用DescribeChildInstanceRegions接口获取地域ID。

CenId String cen-44m0p68spvlrqq****

云企业网实例ID。

VpcId String vpc-bp12ge2tq5gzdc915****

VPC实例ID。

PageNumber Integer 1

列表的页码。默认值:1

PageSize Integer 10

分页查询时每页显示的条目数。取值范围:1~50。默认值:10

ZoneId String cn-hangzhou-h

可用区ID。

  • 如果您指定可用区ID,则系统只查询VPC实例位于当前可用区的交换机的信息。
  • 如果您不指定可用区ID,则系统默认查询该VPC实例位于所有可用区的交换机的信息。

您可以调用DescribeZones接口获取可用区ID。

返回数据

名称 类型 示例值 描述
PageSize Integer 10

分页查询时每页显示的条目数。

RequestId String A9288C78-881A-5D30-A8A9-68E05EE0A086

请求ID。

PageNumber Integer 1

列表的页码。

TotalCount Integer 2

列表的条目数。

VSwitches Array of VSwitch

交换机信息列表。

VpcId String vpc-bp12ge2tq5gzdc915****

交换机所属的VPC实例ID。

ZoneId String cn-hangzhou-h

交换机所属的可用区ID。

VSwitchId String vsw-bp1194lh263wx1gsk****

交换机实例ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListGrantVSwitchesToCen
&RegionId=cn-hangzhou
&CenId=cen-44m0p68spvlrqq****
&VpcId=vpc-bp12ge2tq5gzdc915****
&PageNumber=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListGrantVSwitchesToCenResponse>
    <TotalCount>2</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>A9288C78-881A-5D30-A8A9-68E05EE0A086</RequestId>
    <PageNumber>1</PageNumber>
    <VSwitches>
        <VpcId>vpc-bp12ge2tq5gzdc915****</VpcId>
        <ZoneId>cn-hangzhou-h</ZoneId>
        <VSwitchId>vsw-bp1194lh263wx1gsk****</VSwitchId>
    </VSwitches>
    <VSwitches>
        <VpcId>vpc-bp12ge2tq5gzdc915****</VpcId>
        <ZoneId>cn-hangzhou-i</ZoneId>
        <VSwitchId>vsw-bp1607g2jc48qanlk****</VSwitchId>
    </VSwitches>
</ListGrantVSwitchesToCenResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 2,
  "PageSize" : 10,
  "RequestId" : "A9288C78-881A-5D30-A8A9-68E05EE0A086",
  "PageNumber" : 1,
  "VSwitches" : [ {
    "VpcId" : "vpc-bp12ge2tq5gzdc915****",
    "ZoneId" : "cn-hangzhou-h",
    "VSwitchId" : "vsw-bp1194lh263wx1gsk****"
  }, {
    "VpcId" : "vpc-bp12ge2tq5gzdc915****",
    "ZoneId" : "cn-hangzhou-i",
    "VSwitchId" : "vsw-bp1607g2jc48qanlk****"
  } ]
}

错误码

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