列举上行域名
描述
列举指定直播空间的所有上行域名(推流域名)
接口信息
- 请求方法:
GET - 请求地址:
<bucket>.mls.cn-east-1.qiniumiku.com - 请求路径:
/
请求参数
Query 参数
| 参数名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| pushDomain | string | 是 | pushDomain | 域名配置 |
Header 参数
| 参数名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| Host | string | 是 | <bucket>.mls.cn-east-1.qiniumiku.com |
请求的服务域名 |
| Authorization | string | 是 | <QiniuToken> |
管理凭证 QiniuToken,生成规则 |
请求示例
GET /?pushDomain HTTP/1.1
Host: test.mls.cn-east-1.qiniumiku.com
Authorization: <QiniuToken>
Content-Type: application/json
{}
返回响应
响应状态码
- 请查阅: 这里
响应示例
{
"connectId": "YmgAAB4oE2XSFXkY",
"domains": [
{
"enable": true,
"domain": "test-bucket-publish.com",
"cname": "test-bucket-publish.com.publish.mikudns.com",
"type": "pushRtmp",
"auth": {
"type": "",
"enable": false,
"primaryKey": "",
"secondaryKey": "",
"expireSeconds": 0
},
"certificateID": "",
"creationDate": "2019-01-01T00:00:00.000+08:00",
"lastModified": "2019-01-01T00:00:00.000+08:00",
"httpsEnable": true
}
]
}
响应参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| connectId | string | 请求连接的唯一标识符 |
| domains | []object | 域名配置列表,详见 domain 对象 |
domain 对象
| 参数名称 | 类型 | 说明 |
|---|---|---|
| enable | boolean | 域名是否启用 |
| domain | string | 域名地址 |
| cname | string | CNAME 域名别名 |
| type | string | 域名类型(pushRtmp:rtmp 推流域名;whip:whip 推流域名;pushSrt:srt 推流域名) |
| auth | object | 防盗链配置,详见 auth 对象 |
| certificateID | string | HTTPS 证书 ID,只支持 whip 协议域名 |
| creationDate | string | 域名创建时间,遵循 ISO 8601格式 |
| lastModified | string | 最后修改时间,遵循 ISO 8601格式 |
| httpsEnable | boolean | 是否启用 HTTPS 协议,只支持 whip 协议域名 |
auth对 象
| 参数名称 | 类型 | 说明 |
|---|---|---|
| type | string | 防盗链类型 |
| enable | boolean | 是否启用防盗链功能 |
| primaryKey | string | 防盗链主密钥 |
| secondaryKey | string | 防盗链从密钥(备用) |
| expireSeconds | integer | 防盗链链接的有效期,单位为 s |
文档反馈
(如有产品使用问题,请 提交工单)