You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /
  • 内容分发网络

查询单个 IP 是否归属 CDN

最近更新时间：2024.01.25 20:28:20

首次发布时间：2021.11.11 17:41:21

我的收藏

通过 API 请求查询指定 IP 是否归属于火山引擎的 CDN 服务。

使用限制

节流限制：您每秒最多可以发送 20 个请求。

请求说明

  • 请求方式：POST
  • 请求地址：https://cdn.volcengineapi.com/?Action=DescribeIPInfo&Version=2021-03-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
是
接口名称。当前 API 的名称为 DescribeIPInfo。
Version
String
是
接口版本。当前 API 的版本为 2021-03-01。

Body

参数名称
数据类型
是否必选
参数说明
示例
IP
String
是
指定一个查询的 IP 地址
8.8.8.8

响应正文

参数名称
数据类型
参数说明
示例
IP
String
请求时指定的 IP 地址。
8.8.8.8
Location
String
IP 归属地区。
中国-山东-青岛市
ISP
String
IP 归属运营商信息。
电信
CdnIp
Boolean
是否归属于火山引擎 CDN 服务：
true：属于火山引擎 CDN 的节点 IP。
false：不属于火山引擎 CDN 的节点 IP。
false

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeIPInfo&Version=2021-03-01
{
  "IP": "8.8.8.8"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202109181438380101940990351D01315C",
    "Action": "DescribeIPInfo",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  },
  "Result": {
    "IP": "8.8.8.8",
    "Location": "-",
    "ISP": "-",
    "CdnIp": false
  }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。