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

文档中心

立即注册

导航

查询 IP 是否归属 CDN

最近更新时间：2024.10.10 14:20:47首次发布时间：2024.10.10 14:20:47

查询指定的一个或者多个 IP 地址是否是 CDN 节点的 IP 地址。

使用限制

节流限制：您每秒最多可以提交 20 个 API 请求。

请求说明

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

请求参数

Query

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

Body

参数名称	数据类型	是否必选	参数说明	示例
IPs	String[]	是	表示待查询的 IP 地址列表。列表中最多可以包含 50 个 IP 地址。	`["xx.xxx.xxx.102", "xxx.xxx.234.67"]`

返回参数

由于该 API 没有响应参数，响应正文只有包含请求元数据的 ResponseMetadata 结构体，没有 Result 结构体。

参数名称	数据类型	参数说明	示例
IPs	Object[]	表示请求参数中的 IP 地址列表。

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeCdnIP&Version=2021-03-01
{
    "IPs": [
        "xxx.xxx.xx.139",
        "xxx.xx.xx.34"
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2024101011033668CF51ECED9C5477E3C6",
        "Action": "DescribeCdnIP",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-01"
    },
    "Result": {
        "IPs": [
            {
                "CdnIp": true,
                "IP": "xxx.xxx.xx.139",
                "ISP": "移动",
                "Location": "中国-上海-宝山区"
            },
            {
                "CdnIp": false,
                "IP": "xxx.xx.xx.34",
                "ISP": "",
                "Location": ""
            }
        ]
    }
}

错误码

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