DescribePublicIpAddress - API参考| 阿里云

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.XX.XX/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.XX.XX/24</PublicIpAddress>
<PageNumber>1</PageNumber>
<PageSize>100</PageSize>
<TotalCount>100</TotalCount>
</DescribePublicIpAddressResponse>

JSON 格式

{
  "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
  "PublicIpAddress":[
    "110.11.XX.XX/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进行权限管理。