调用DescribePublicIpAddress查询指定地域中位于专有网络的公网IP地址的范围。

API描述

您不能通过DescribePublicIpAddress接口查询位于经典网络中的公网IP的范围。

注意 目前,本API仅供白名单中的阿里云合作伙伴调用。调用本API前,请联系您的阿里云销售经理或商业经理将您的帐户加入到白名单中。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribePublicIpAddress 要执行的操作,取值:DescribePublicIpAddress
RegionId String cn-qingdao-cm5-a01 指定查询的地域,取值:
  • cn-qingdao-cm5-a01:华北1(青岛)。
  • cn-beijing-btc-a01:华北2(北京)。
  • cn-zhangjiakou-na62-a01:华北3(张家口)。
  • cn-huhehaote-nt12-a01:华北5(呼和浩特)。
  • cn-hangzhou-dg-a01:华东1(杭州)。
  • cn-shanghai-eu13-a01:华东2(上海)。
  • cn-shenzhen-st3-a01:华南1(深圳)。
  • cn-chengdu-wt97-a01:西南1(成都)。
  • cn-hongkong-am4-c04:中国香港。
  • ap-northeast-jp59-a01:日本(东京)。
  • ap-southeast-os30-a01:新加坡。
  • ap-southeast-au49-a01:澳大利亚(悉尼)。
  • ap-southeast-my88-a01:马来西亚(吉隆坡)。
  • ap-southeast-id35-a01:印度尼西亚(雅加达)。
  • ap-south-in73-a01:印度(孟买)。
  • us-east-us44-a01:美国(弗吉尼亚)。
  • us-west-ot7-a01:美国(硅谷)。
  • me-east-db47-a01:阿联酋(迪拜)。
  • eu-central-de46-a01:德国(法兰克福)。
  • eu-west-1-gb33-a01:英国(伦敦)。
PageNumber Integer 1 列表的页码,默认值为1
PageSize Integer 10 分页查询时每页的行数,默认值为100

返回参数

名称 类型 示例值 描述
PublicIpAddress String 110.11.1.0/24 指定地域的公网IP地址范围。
TotalCount String 100 列表条目数。
PageNumber Integer 1 当前页码。
PageSize Integer 10 分页包含的条目数。
RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710 请求ID。

示例

请求示例


https://vpc.aliyuncs.com/?Action=DescribePublicIpAddress
&RegionId=cn-qingdao-cm5-a01
&<公共请求参数>

正常返回示例

XML 格式

<DescribePublicIpAddressResponse>
<RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
<PublicIpAddress>110.11.1.0/24</PublicIpAddress>
<PageNumber>1</PageNumber>
<PageSize>100</PageSize>
<TotalCount>100</TotalCount>
</DescribePublicIpAddressResponse>

JSON 格式

{
  "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
  "PublicIpAddress":[
    "110.11.1.0/24"
  ],
  "PageNumber":"1",
  "PageSize":"100",
  "TotalCount":"100"
}

错误码

HttpCode 错误码 错误信息 描述
403 Forbidden. User not authorized to operate on the specified resource. 指定的地域不存在。
404 Forbidden.RegionNotFound Specified region is not found during access authentication. 您没有操作指定资源的权限。获取权限,请参见使用RAM对VPC进行权限管理