You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /
  • 视频点播

获取 IP 归属信息

最近更新时间：2024.01.08 17:26:44

首次发布时间：2022.06.21 20:11:03

我的收藏

此接口用于查询指定的 IP 是否为火山引擎 CDN 节点的 IP 地址。

请求说明

请求地址：https://vod.volcengineapi.com?Action=DescribeIpInfo&Version=2022-01-01

调试

API Explorer
您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数类型是否必选示例值描述
ActionString是DescribeIpInfo接口名称。当前 API 的名称为 DescribeIpInfo。
VersionString是2022-01-01接口版本。当前 API 的版本为 2022-01-01。
IpsString是1.1.1.1查询 IP 列表。多个 IP 换行或者英文逗号分割。最多支持 50 个 IP 地址。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数类型示例值描述
IpString1.1.1.1查询 IP。

CdnIp

Boolean

true

是否归属于火山引擎 CDN 服务。取值如下：

  • true：属于火山引擎 CDN 的节点 IP。
  • false：不属于火山引擎 CDN 的节点 IP。
LocationString中国-山东省-青岛市IP 所属地区。非火山引擎 CDN，则返回 "-"。
IspString电信IP 所属运营商。非火山引擎 CDN，则返回 "-"。

请求示例

https://vod.volcengineapi.com?Action=DescribeIpInfo&Version=2022-01-01

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20221102110******0621303DE51",
        "Action": "DescribeIpInfo",
        "Version": "2022-01-01",
        "Service": "vod",
        "Region": "cn-north-1"
    },
    "Result": [
        {
        "Ip": "1.1.1.1",                //查询ip
        "CdnIp": true,                  //是否是火山cdn的ip
        "Location": "中国-山东省-青岛市",  //IP所属地区,非火山cdn返回"-"
        "Isp" : "电信"                   //IP所属运营商,非火山cdn返回"-"
        }
    ]
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API，此 API 各语言调用的示例代码，请参考如下：