调用GetVSwitchCidrReservationUsage接口查询已分配使用的交换机预留网段。

调试

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

请求参数

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

系统规定参数。取值：GetVSwitchCidrReservationUsage。
VSwitchCidrReservationId String 是 vcr-bp1m12saqteraw3rp****

要查询的交换机预留网段的实例ID。
NextToken String 否 FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
MaxResults Long 否 10

分批次查询时每次显示的条目数。取值范围：1~100，默认值为10。
RegionId String 是 cn-hangzhou

交换机所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

请求ID。
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌（Token）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
TotalCount Long 10

列表条目数。
MaxResults Long 10

分批次查询时每次显示的条目数。
CidrReservationUsages Array of VSwitchCidrReservationUsage

已分配使用的交换机预留网段列表。
VSwitchCidrReservationId String vcr-bp1m12saqteraw3rp****

交换机预留网段的实例ID。
VSwitchId String vsw-25navfgbue4g****

预留网段所属的交换机ID。
ResourceId String eni-bp14v2sdd3v8htln****

从预留网段分配使用的弹性网卡的实例ID。
ResourceType String NetworkInterface

预留网段分配使用的实例类型。取值：NetworkInterface，弹性网卡类型。
IpPrefixId String vcr-bp1m12saqteraw3rp****

按段分配的预留网段实例ID。
IpPrefixCidr String 192.168.1.64/28

从当前预留网段中已分配给弹性网卡使用的前缀网段（prefix）。

示例

请求示例

http(s)://[Endpoint]/?Action=GetVSwitchCidrReservationUsage
&VSwitchCidrReservationId=vcr-bp1m12saqteraw3rp****
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=10
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<GetVSwitchCidrReservationUsageResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TotalCount>10</TotalCount>
    <MaxResults>10</MaxResults>
    <CidrReservationUsages>
        <VSwitchCidrReservationId>vcr-bp1m12saqteraw3rp****</VSwitchCidrReservationId>
        <VSwitchId>vsw-25navfgbue4g****</VSwitchId>
        <ResourceId>eni-bp14v2sdd3v8htln****</ResourceId>
        <ResourceType>NetworkInterface</ResourceType>
        <IpPrefixId>vcr-bp1m12saqteraw3rp****</IpPrefixId>
        <IpPrefixCidr>192.168.1.64/28</IpPrefixCidr>
    </CidrReservationUsages>
</GetVSwitchCidrReservationUsageResponse>

JSON格式

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount" : 10,
  "MaxResults" : 10,
  "CidrReservationUsages" : [ {
    "VSwitchCidrReservationId" : "vcr-bp1m12saqteraw3rp****",
    "VSwitchId" : "vsw-25navfgbue4g****",
    "ResourceId" : "eni-bp14v2sdd3v8htln****",
    "ResourceType" : "NetworkInterface",
    "IpPrefixId" : "vcr-bp1m12saqteraw3rp****",
    "IpPrefixCidr" : "192.168.1.64/28"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalParam.NextToken The specified NextToken is invalid. 指定的NextToken参数不合法，请检查该参数是否正确。

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