You need to enable JavaScript to run this app.
导航
DescribeCdnRegionAndIsp - 获取支持的区域和 ISP 列表
最近更新时间:2025.09.19 17:51:30首次发布时间:2025.09.19 17:51:30
复制全文
我的收藏
有用
有用
无用
无用

调用 DescribeCdnRegionAndIsp 接口获取获取火山引擎 IP 地址数据库所覆盖的中国省级行政区、全球的国家和地区、以及中国大陆网络运营商的名称和代码。

注意事项

  • 本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见 QPS 限制

请求说明

请求地址:https://vod.volcengineapi.com?Action=DescribeCdnRegionAndIsp&Version=2023-07-01

调试

请求参数

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

参数
类型
是否必选
示例值
描述
Action
String
DescribeCdnRegionAndIsp
接口名称。当前 API 的名称为 DescribeCdnRegionAndIsp
Version
String
2023-07-01
接口版本。当前 API 的版本为 2023-07-01
Area
String
China

查询的范围。该参数有以下取值:

  • China:表示中国省级行政区和中国内地网络运营商的代码和名称。
  • Global:表示全球国家和地区、以及中国内地网络运营商的代码和名称。
该参数的默认值是 China

返回参数

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

参数
类型
示例值
描述
Isps
Object[]
-
中国内地的网络运营商列表。
Code
String
BJ
国家、地区、或中国省级行政区的代码。
Name
String
Beijing
区域名称。
Regions
Object[]
-

区域列表,根据 Area 参数的不同返回不同范围的区域信息。

  • AreaGlobal 时,返回全球各国家和地区的列表。
  • AreaChina时,返回中国各省级行政区的列表。
Code
String
BJ
国家、地区、或中国省级行政区的代码。
Name
String
Beijing
区域名称。

请求示例

https://vod.volcengineapi.com?Action=DescribeCdnRegionAndIsp&Version=2023-07-01&Area=China

返回示例

{
  "Result": {
    "Isps": [
      {
        "Code": "BJ",
        "Name": "Beijing"
      }
    ],
    "Regions": [
      {
        "Code": "BJ",
        "Name": "Beijing"
      }
    ]
  },
  "ResponseMetadata": {
    "Action": "DescribeCdnRegionAndIsp",
    "Region": "cn-north-1",
    "Service": "vod",
    "Version": "2023-07-01",
    "RequestId": "20230604110420****100232280022D31"
  }
}

错误码

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

SDK

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