更新时间:2022-04-11 GMT+08:00
分享

修改直播域名

功能介绍

修改直播播放、RTMP推流加速域名相关信息

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/{project_id}/domain

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。。

表3 请求Body参数

参数

是否必选

参数类型

描述

domain

String

直播域名,不允许修改

status

String

直播域名状态,通过修改此字段,实现域名的启用和停用;域名处于“配置中”状态时,不允许对该域名执行启停操作

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

domain

String

直播域名

domain_type

String

域名类型

  • pull表示播放域名

  • push表示推流域名

domain_cname

String

直播域名的CNAME

region

String

直播所属直播中心

status

String

直播域名的状态

create_time

String

域名创建时间,格式:yyyy-mm-ddThh:mm:ssZ,UTC时间

status_describe

String

状态描述

service_area

String

域名应用区域

  • mainland_china表示中国大陆区域

  • outside_mainland_china表示中国大陆以外区域

  • global表示全球区域

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

PUT https://{endpoint}/v1/{project_id}/domain

{
  "domain" : "play.example.huawei.com",
  "status" : "off"
}

响应示例

状态码: 200

直播域名修改成功

{
  "domain" : "play.example.huawei.com",
  "domain_type" : "pull",
  "domain_cname" : "play.example.huawei.com.c.cdnhwc3.com",
  "region" : "cn-north-1",
  "status" : "off",
  "create_time" : "2020-01-19T02:57:00Z",
  "domain_source" : {
    "protocol" : "rtmp",
    "source_type" : "huawei",
    "sources_priority" : "first",
    "sources" : [ "play.example.huawei.com.o.hwcloudlive.com" ]
  }
}

状态码: 400

参数错误

{
  "error_code" : "LIVE.100011001",
  "error_msg" : "Request Illegal"
}

状态码

状态码

描述

200

直播域名修改成功

400

参数错误

错误码

请参见错误码

分享:

    相关文档

    相关产品

close