最近更新时间:2023.10.12 17:39:59
首次发布时间:2023.03.07 16:55:56
本接口用于查询指定 IP 地址是否属于火山引擎 CDN 节点。
说明
该接口属于历史版本 API,我们计划于 2023 年 12 月 25 日停止对其进行维护,并于 2024 年 3 月 25 日下线文档,建议您使用新版查询 IP 地址归属的 CDN 节点接口。
请求频率:单用户请求频率限制为 10QPS。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeIpInfo | 接口名称。当前 API 的名称为 DescribeIpInfo 。 |
Version | String | 是 | 2020-08-01 | 接口版本。当前 API 的版本为 2020-08-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Ips | Array of String | 是 | ["186.199.***.1"] | 待查询的 IP 地址列表。支持 IPv4 和 IPv6 地址,一次最多查询 50 个 IP 地址 |
下表仅列出本接口特有的返回参数。更多信息请见返回结构。
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
List | Array of LiveIpInfo | - | IP 详情列表 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Ip | String | 186.199.***.1 | IP 地址 |
LiveCdnIp | Boolean |
| 是否归属于火山引擎 CDN 节点。
|
Location | String | 中国 | IP 所属国家或地区。非归属火山引擎视频直播的 IP,返回“-”。 |
Province | String | 河北 | IP 所属省。非归属火山引擎视频直播的 IP,返回“-”。 |
City | String | 廊坊 | IP 所属地区。非归属火山引擎视频直播的 IP,返回“-”。 |
Isp | String |
| IP 所属运营商。非归属火山引擎视频直播的 IP,返回”-“。
|
POST https://live.volcengineapi.com?Action=DescribeIpInfo&Version=2020-08-01 { "Ips": [ "186.199.***.1" ] }
{ "ResponseMetadata": { "RequestID": "2021072818053901022706413520787", "Action": "DescribeIpInfo", "Version": "2020-08-01", "Service": "live", "Region": "cn-north-1" }, "Result": { "List": [ { "Ip": "186.199.***.1", "LiveCdnIp": "false", "Location":"中国", "Province":"河北", "City": "廊坊", "Isp": "telecom" } ] }
访问公共错误码获取详细信息。