调用DescribeIpInfo验证指定的IP是否为阿里云CDN节点的IP地址。

单用户调用频率：50次/秒。

调试

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

请求参数

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

操作接口名，系统规定参数，取值：DescribeIpInfo。

IP String 是 1.2.3.4

指定IP地址，不支持批量。

返回数据

名称 类型 示例值 描述
RequestId String 123847FA-9A00-4426-83B8-B4B45D475930

请求ID。
CdnIp String True

是否属于阿里云CDN节点。

  • True：属于。
  • False：不属于。
ISP String 电信

所属运营商中文名称。
Region String 中国-贵州省-贵阳市

所属地域中文名称。
IspEname String telecom

所属运营商英文名称。
RegionEname String China-Guizhou-guiyang

所属地域英文名称。

示例

请求示例

http://cdn.aliyuncs.com/?Action=DescribeIpInfo
&IP=1.2.3.4
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeIpInfoResponse>
  <RegionEname>China-Guizhou-guiyang</RegionEname>
  <Region>中国-贵州省-贵阳市</Region>
  <IspEname>telecom</IspEname>
  <RequestId>1B1D0EE7-9559-489D-BC4E-279495EB8FB8</RequestId>
  <ISP>电信</ISP>
  <CdnIp>True</CdnIp>
</DescribeIpInfoResponse>

JSON 格式 

{
    "RegionEname": "China-Guizhou-guiyang",
    "Region": "中国-贵州省-贵阳市",
    "IspEname": "telecom",
    "RequestId": "1B1D0EE7-9559-489D-BC4E-279495EB8FB8",
    "ISP": "电信",
    "CdnIp": "True"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidIP.ValueNotSupported The specified value of parameter IP is not supported. 不支持该IP地址，请检查更新后重试。
400 MissingParameter The specified value of parameter "IP" is not valid. 参数“IP”的值无效。

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