域名配置查询(域名)

最近更新时间:2019-12-02 12:02:03

接口描述

GetHostInfoByHost 查询域名的详细配置信息。

请求域名:cdn.api.qcloud.com

注意:

  • 支持一次查询多个域名的详细信息。
  • 调用频率限制为1000次/分钟。
  • 接口已支持子账号调用,权限配置可参考权限 配置示例

查看调用示例

入参说明

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 GetHostInfoByHost。

参数名称 是否必选 类型 描述
hosts.n String 查询的 host,支持查询一个或多个 host。

详细说明

支持查询一个或多个 域名,查询多个域名时,参数传入方式可参考:

hosts.0=www.test1.com&hosts.1=www.test2.com

出参说明

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。
详见错误码页面 公共错误码
message String 模块错误信息描述,与接口相关。
codeDesc String 英文错误信息,或业务侧错误码。
data Object 结果数据,详细说明见下文。
详见错误码页面 业务错误码

详细说明

data

参数名称 类型 描述
hosts Array 域名详细配置信息,见下文 hosts 基本配置。
total Int 域名总数。

hosts 基本配置

参数名称 类型 描述
id Int 域名接入 CDN 后的标识 ID。
app_id Int 域名所属账号的 AppID。
owner_uin Int 域名所属账号。
project_id Int 域名所属项目 ID。
host String 域名。
cname String CDN 分配的 .cdn.dnsv1.com 后缀加速域名 。
host_type String 接入方式:
"cos":表示域名接入时使用的托管源为 COS 源。
"cname":表示域名接入时使用的是自有源站。
"ftp":表示该域名接入时使用了 CDN 提供的 FTP 托管源。
service_type String 域名业务类型:
"web":静态内容加速。
"download":文件下载加速。
"media":流媒体点播加速。
"live":流媒体直播加速。
origin String 域名源站配置。
fwd_host_type String 回源设置类型:
"default":表示接入的域名即回源地址。
"custom":该域名使用了自定义的回源 host。
fwd_host String 回源 host。
bucket_name String COS 源时,对应的 bucket 名称。
cache Object 缓存规则设置,详细说明见下文。
status Int 域名加速状态:
1:域名审核中。
2:域名审核未通过。
3:域名审核通过处于部署中。
4:域名部署中。
5:域名已启动。
6:域名已关闭。
disabled Int 域名封禁状态:
0:表示域名未被封禁,其他均为已封禁。
message String 域名状态信息:
"已关闭"、"已启动"、"部署中"。
create_time String 域名接入时间。
update_time String 更新时间。
deleted String 是否删除:
"no":表示域名未删除。
"yes":表示域名已删除。
middle_resource Int 中间源开关:
-1:表示该域名关闭了中间源服务。
0:表示该域名开启了中间源服务。
refer Object 防盗链设置,详细说明见下文。
cache_mode String 缓存规则类型:
"simple":表示缓存完全依赖控制台设置。
"custom":则表示缓存依赖控制台设置的缓存时间和源站吐出的 max-age 的最小值。
furl_cache String 过滤参数:
"on":开启全路径缓存,关闭过滤参数。
"off":关闭全路径缓存,开启过滤参数。
http2 Int 是否开启 HTTP2.0:
"1":表示已开启 http2.0 。
ssl_type Int 是否开通 HTTPS:
"0":未开通 HTTPS 配置。
若为其他,则表示已开通 HTTPS 配置。
ssl_deploy_time String SSL 部署时间。
ssl_expire_time String SSL 过期时间。
ssl_cert_name String 证书备注名。
ssl_cert_id String 托管证书 ID。
seo String 是否开启 SEO 优化:
"off":表示未开启。
"on":表示开启。
capping Object 带宽上限设置:
"bandwidth":设置的带宽封顶阈值。
"uint":设置带宽封顶阈值的单位。
"hy":yes 表示设置为请求回源。
"active":yes 表示开启带宽封顶。
status_code_cache Object 状态码缓存设置:
"404":404状态码缓存过期时间,单位为秒,设置为0表示不缓存。
safety_chain Object 时间戳鉴权设置:
"switch":开关,on - 开启,off - 关闭。
"key":鉴权 key。
"time_format":时间戳格式,10 - 十进制,16 - 16进制。
"ttl_time":过期时间。
更多配置说明可查看 鉴权配置
host_config Object 其他高级配置项,具体见下文 host_config 高级配置。
host_config 高级配置
参数名称 类型 描述
backup_origin Object 备用源站设置。
https_switch Object HTTPS 强制跳转设置:
"on":表示开启 HTTPS 强制跳转,默认跳转方式为302。
"off":表示未开启。
follow302_switch Object 302跟随配置:
"on":表示开启302跳转跟随。
"off":表示关闭302跳转跟随。
ip_cc Object IP 黑白名单配置:
"type":2表示白名单,1表示黑名单。
"list":具体的 IP/IP 段清单。
ip_freq_limit Object IP 访问限频配置:
"type":1表示开启,0表示关闭。
"limit_count":设置的 QPS 阈值。
rsp_header Object response-header 配置。
video_switch Object 视频拖拽配置:
"on":开启视频拖拽。
"off":关闭视频拖拽。
chunkFd_switch Object 分片回源配置:
"on":开启分片回源。
"off":关闭分片回源。
cache
参数名称 类型 描述
type Int 缓存配置类型:
"0":所有文件。
"1":文件类型。
"2":文件夹类型。
"3":全路径文件。
rule String 匹配规则,与上述 type 相对应。
time Int 缓存时间,单位为秒 。
unit String 设置缓存时间时所用单位:
"d":表示天。
"h":表示小时。
"m":表示分钟。
"s":表示秒。
refer
参数名称 类型 描述
type Int 防盗链类型:
"0":未配置防盗链。
"1":黑名单。
"2":白名单。
null_flag Int 防盗链是否为空,若为1,则表示防盗链为空。
list Array 配置的防盗链名单。
注意:

  • 未在上述文档中说明的字段为无效字段内部标识字段,可直接忽略。

调用案例

示例参数

hosts.0www.test.com

GET 请求

GET 请求需要将所有参数都加在 URL 后:

https://cdn.api.qcloud.com/v2/index.php?
Action=GetHostInfoByHost
&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXX
&Timestamp=1462434613
&Nonce=123456789
&Signature=XXXXXXXXXXXXXXXXXXX
&hosts.0=www.test.com

POST 请求

POST 请求时,参数填充在 HTTP Request-body 中,请求地址:

https://cdn.api.qcloud.com/v2/index.php

参数支持 form-data、x-www-form-urlencoded 等格式,参数数组如下:

array (
  'Action' => 'GetHostInfoByHost',
  'SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX',
  'Timestamp' => 1462782282,
  'Nonce' => 123456789,
  'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX',
  'hosts.0' => 'www.test.com'
)

结果示例

{
{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "hosts": [{
            "id": 123456,
            "app_id": 12345678,
            "owner_uin": 87654321,
            "project_id": 0,
            "host": "www.test.com",
            "host_type": "cname",
            "service_type": "web",
            "origin": "2.2.2.2",
            "cache": [{
                    "type": 0,
                    "rule": "all",
                    "time": 2592000,
                    "unit": "d"
                },
                {
                    "type": 1,
                    "rule": ".php;.jsp;.asp;.aspx",
                    "time": 0,
                    "unit": "s"
                }
            ],
            "status": 4,
            "disabled": 0,
            "message": "部署中",
            ......
}