查询多个 IP 是否归属 CDN--内容分发网络-火山引擎

文档中心

立即注册

导航

查询多个 IP 是否归属 CDN

最近更新时间：2024.06.28 19:18:53首次发布时间：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 请求失败。更多关于错误码的信息，参见错误码。