更新时间:2023-10-26 GMT+08:00

查询IP归属信息

功能介绍

查询IP归属信息。

URI

GET /v1.0/cdn/ip-info

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

当用户开启企业项目功能时,该参数生效,表示查询资源所属项目,"all"表示所有项目。注意:当使用子帐号调用接口时,该参数必传。

您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id。

ips

String

IP地址列表,以“,”分割,最多20个。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

cdn_ips

Array of CdnIps objects

IP归属信息列表。

表4 CdnIps

参数

参数类型

描述

ip

String

需查询的IP地址。

belongs

Boolean

是否是华为云CDN节点。(true:是华为云CDN节点,false:不是华为云CDN节点)

region

String

IP归属地省份。(Unknown:表示未知归属地)

isp

String

运营商名称。如果IP归属地未知,该字段返回null。

platform

String

平台。如果IP归属地未知,该字段返回null。

请求示例

GET https://cdn.myhuaweicloud.com/v1.0/cdn/ip-info?ips=192.168.1.1,192.168.1.2&enterprise_project_id=0

响应示例

状态码: 200

OK

{
  "cdn_ips" : [ {
    "ip" : "192.168.1.1",
    "region" : "Sichuan",
    "platform" : null,
    "isp" : "Dianxin",
    "belongs" : true
  }, {
    "ip" : "192.168.1.2",
    "region" : "Unknown",
    "platform" : null,
    "isp" : null,
    "belongs" : false
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码