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

查询多个 IP 是否归属 CDN

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

首次发布时间：2022.03.30 11:45:28

我的收藏

通过 API 请求查询多个 IP 是否归属于火山引擎的 CDN 服务，最多可一次性查询 50 个 IP 归属信息。

使用限制

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

请求说明

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

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
IpList
String
是

指定一个或多个 IP 地址，查询其是否归属于火山引擎 CDN 服务。

多个 IP 之间以英文逗号, 分隔，最多可一次性查询50个。
8.8.8.8,1.1.1.1

响应正文

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

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeIPListInfo&Version=2021-03-01
{
  "IpList": "1.1.1.1,8.8.8.8"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202203301127050102121450320B1DE80E",
    "Action": "DescribeIPListInfo",
    "Version": "2021-03-01",
    "Service": "CDN",
    "Region": "cn-north-1"
  },
  "Result": [
    {
      "CdnIp": false,
      "IP": "1.1.1.1",
      "ISP": "",
      "Location": ""
    },
    {
      "CdnIp": false,
      "IP": "8.8.8.8",
      "ISP": "",
      "Location": ""
    }
  ]
}

错误码

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