查询调度域名列表
更新时间：2023-03-28 17:45:03
适用产品
CDN Pro
接口描述
获取调度域名的列表。
- 调用URL： https://open.chinanetcenter.com/cdn/edgeHostnames
- 调用方法：GET
推荐使用 Open API在线调试
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
请求参数
Params 参数
| 参数名称 | 描述 |
|---|---|
searchString | 通过搜索关键字匹配调度域名的前缀和描述进行过滤。 |
offsetInteger | 默认值: 0 取值范围: >= 0
查询起始位置。 |
limitInteger | 默认值: 100 取值范围: <= 200
每次查询的最大条数。 |
sortByString | 取值范围: creationTime,lastUpdateTime
默认值: lastUpdateTime
返回结果的排序依据。支持按创建时间或最后一次更新时间进行排序。 |
sortOrderString | 取值范围: >= 0 字符
取值范围: asc,desc
默认值: desc
返回结果的排序顺序。'asc'表示升序，'desc'表示降序。 |
hasBeianBoolean | 根据是否备案查询调度域名。 |
返回参数
Body 参数
| 参数名称 | 描述 |
|---|---|
edgeHostnamesList | 调度域名列表。 |
edgeHostnameString | 调度域名。 |
descriptionString | 调度域名的描述。 |
lastUpdateTimeString | RFC 3339格式的日期，表示调度域名最后一次更新的时间。 |
creationTimeString | RFC 3339格式的日期，表示调度域名的创建时间。 |
hasBeianBoolean | 是否备案的标记。当值为true时，将使用包括中国大陆的服务器提供内容加速服务。 |
highestServerGroupString | 取值范围: standard,premium,deluxe,ultra
指该调度域名可使用的最高等级的节点组。当您在'创建调度域名'接口中定义访客分区规则时，可指定节点组。 |
countInteger | 取值范围: >= 0
调度域名的总数。 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| InvalidListLimit | The value of limit should be between 1 and 200, inclusive. | 400 | limit参数的取值范围是1-200。 |
| InvalidListLimit | The limit value should be an integer. | 400 | limit参数取值必须是整数。 |
| InvalidSortOrder | The valid sort order values are asc and desc. | 400 | sortOrder参数取值必须是'asc'或'desc'。 |
| InvalidHasBeian | Invalid hasBeian parameter. Only true and false are allowed. | 400 | hasBeian参数取值必须是true或false。 |
示例
200
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://open.chinanetcenter.com/cdn/edgeHostnames" \ -X "GET" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json"
- 返回示例 复制成功
{ "count": 2, "edgeHostnames": [ { "edgeHostname": "ekgggzcmswu4vc.qtlcdn.com", "description": "my edge hostname", "hasBeian": false, "highestServerGroup": "standard", "lastUpdateTime": "2019-12-04T19:44:12Z", "creationTime": "2019-12-04T19:44:12Z" }, { "edgeHostname": "cdn.admtl.com.qtlcdn.com", "description": "", "hasBeian": false, "highestServerGroup": "standard", "lastUpdateTime": "2019-11-21T00:15:35Z", "creationTime": "2019-11-21T00:15:35Z" } ] }
本篇文档内容对您是否有帮助？
有帮助
我要反馈