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

获取回源层节点的所有 IP

最近更新时间：2024.03.06 15:19:22

首次发布时间：2021.09.23 14:12:35

我的收藏

查询指定加速域名在回源层所有节点的 IP 地址。

说明

如果您需要使用该 API，请 提交工单。

使用限制

节流限制：您每秒最多可以发送 20 个请求。
数据延时：如果加速域名的回源层节点发生了变化，可能需要 10-15 分钟才会体现在该接口返回的 IP 列表中。

请求说明

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

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
Domain
String
是
指定一个域名
www.example.com
IpVersion
String
否

指定一个 IP 的网络层协议。该参数的可用值如下：
ipv4：查询网络层协议是 ipv4 的 IP；
ipv6：查询网络层协议是 ipv6 的 IP。

如果不指定该参数，表示查询全部 IP。
ipv4

响应正文

参数名称
数据类型
参数说明
示例
CdnIpv4
String[]
Ipv4 列表。
["192.168.0.1","192.168.0.2"]
CdnIpv6
String[]
Ipv6 列表。
["240e:b1:e401:4::13","240e:b1:e401:4::14"]

请求示例

POST https://cdn.volcengineapi.com/?Action=DescribeCdnUpperIp&Version=2021-03-01
{
  "Domain": "www.example.com"
}

返回示例

{
	"ResponseMetadata": {
		"RequestId": "202109181438380101940990351D01315C",
		"Action": "DescribeCdnUpperIp",
		"Version": "2021-03-01",
		"Service": "CDN",
		"Region": "cn-north-1"
	},
	"Result": {
        "CdnIpv4": [
            "192.168.0.1",
            "192.168.0.2"
        ],
        "CdnIpv6": null
    }
}

错误码

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