# API概览 视频直播服务对应的接口列表如下所示，在调用视频直播API前，您需要先获取用户Token，Token可以用于调用其他API时鉴权，具体如何调用直播API请参考[应用示例](https://support.huaweicloud.com/api-live/live_03_0026.html)。 #### 域名管理接口 表1域名管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/domain | [创建直播域名](https://support.huaweicloud.com/api-live/CreateDomain.html) | | DELETE /v1/{project_id}/domain | [删除直播域名](https://support.huaweicloud.com/api-live/DeleteDomain.html) | | PUT /v1/{project_id}/domain | [修改直播域名](https://support.huaweicloud.com/api-live/UpdateDomain.html) | | GET /v1/{project_id}/domain | [查询直播域名](https://support.huaweicloud.com/api-live/ShowDomain.html) | | PUT /v1/{project_id}/domains_mapping | [域名映射](https://support.huaweicloud.com/api-live/CreateDomainMapping.html) | | DELETE /v1/{project_id}/domains_mapping | [删除直播域名映射关系](https://support.huaweicloud.com/api-live/DeleteDomainMapping.html) | | PUT /v1/{project_id}/domain/ipv6-switch | [配置域名IPV6开关](https://support.huaweicloud.com/api-live/UpdateDomainIpv6Switch.html) | | GET /v1/{project_id}/cdn/ip-info | [查询IP归属信息](https://support.huaweicloud.com/api-live/BatchShowIpBelongs.html) | | PUT /v1/{project_id}/domain/delay | [修改播放域名延时配置](https://support.huaweicloud.com/api-live/UpdateDelayConfig.html) | | GET /v1/{project_id}/domain/delay | [查询播放域名延时配置](https://support.huaweicloud.com/api-live/ListDelayConfig.html) | | PUT /v1/{project_id}/domain/hls | [修改域名HLS配置](https://support.huaweicloud.com/api-live/UpdateHlsConfig.html) | | GET /v1/{project_id}/domain/hls | [查询域名HLS配置](https://support.huaweicloud.com/api-live/ListHlsConfig.html) | | PUT /v1/{project_id}/domain/pull-sources | [修改直播拉流回源配置](https://support.huaweicloud.com/api-live/UpdatePullSourcesConfig.html) | | GET /v1/{project_id}/domain/pull-sources | [查询直播拉流回源配置](https://support.huaweicloud.com/api-live/ShowPullSourcesConfig.html) | #### 转码模板管理接口 表2转码模板管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/template/transcodings | [创建直播转码模板](https://support.huaweicloud.com/api-live/live_03_0007.html) | | DELETE /v1/{project_id}/template/transcodings | [删除直播转码模板](https://support.huaweicloud.com/api-live/live_03_0008.html) | | PUT /v1/{project_id}/template/transcodings | [修改直播转码模板](https://support.huaweicloud.com/api-live/live_03_0006.html) | | GET /v1/{project_id}/template/transcodings | [查询直播转码模板](https://support.huaweicloud.com/api-live/topic_retrieveTranscodingsTemplate.html) | #### 流管理接口 表3流管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/stream/blocks | [禁止直播推流](https://support.huaweicloud.com/api-live/live_03_0010.html) | | GET /v1/{project_id}/stream/blocks | [查询禁止直播推流列表](https://support.huaweicloud.com/api-live/topic_retrieveStreamForbidden.html) | | DELETE /v1/{project_id}/stream/blocks | [禁推恢复](https://support.huaweicloud.com/api-live/live_03_0011.html) | | PUT /v1/{project_id}/stream/blocks | [修改禁推属性](https://support.huaweicloud.com/api-live/topic_updateStreamForbidden.html) | | POST /v1/{project_id}/stream/block-once | [禁推闪断](https://support.huaweicloud.com/api-live/CreateStreamForbiddenOnce.html) | #### 通知管理接口 表4通知管理接口 | 接口 | 说明 | |:---|:---| | PUT /v1/{project_id}/notifications/publish | [新增、修改直播推流通知配置](https://support.huaweicloud.com/api-live/UpdatePublishTemplate.html) | | GET /v1/{project_id}/notifications/publish | [查询直播推流通知配置](https://support.huaweicloud.com/api-live/ListPublishTemplate.html) | | DELETE /v1/{project_id}/notifications/publish | [删除直播推流通知配置](https://support.huaweicloud.com/api-live/DeletePublishTemplate.html) | #### 鉴权管理接口 表5鉴权管理接口 | 接口 | 说明 | |:---|:---| | PUT /v1/{project_id}/guard/referer-chain | [设置Referer防盗链黑白名单](https://support.huaweicloud.com/api-live/SetRefererChain.html) | | DELETE /v1/{project_id}/guard/referer-chain | [删除Referer防盗链黑白名单](https://support.huaweicloud.com/api-live/DelRefererChain.html) | | GET /v1/{project_id}/guard/referer-chain | [查询Referer防盗链黑白名单](https://support.huaweicloud.com/api-live/GetRefererChain.html) | | GET /v1/{project_id}/guard/ip | [查询IP黑/白名单](https://support.huaweicloud.com/api-live/ListIPAuthList.html) | | PUT /v1/{project_id}/guard/ip | [修改IP黑/白名单](https://support.huaweicloud.com/api-live/UpdateIPAuthList.html) | | POST /v1/{project_id}/auth/chain | [生成URL鉴权串](https://support.huaweicloud.com/api-live/CreateUrlAuthchain.html) | | GET /v1/{project_id}/domain/geo-blocking | [查询播放域名的地域限制列表](https://support.huaweicloud.com/api-live/ListGeoBlockingConfig.html) | | PUT /v1/{project_id}/domain/geo-blocking | [修改播放域名的地域限制配置](https://support.huaweicloud.com/api-live/UpdateGeoBlockingConfig.html) | | GET /v1/{project_id}/guard/key-chain | [查询指定域名的Key防盗链配置](https://support.huaweicloud.com/api-live/ShowDomainKeyChain.html) | | PUT /v1/{project_id}/guard/key-chain | [更新指定域名的Key防盗链配置](https://support.huaweicloud.com/api-live/UpdateDomainKeyChain.html) | | DELETE /v1/{project_id}/guard/key-chain | [删除指定域名的Key防盗链配置](https://support.huaweicloud.com/api-live/DeleteDomainKeyChain.html) | #### 截图管理接口 表6截图管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/stream/snapshot | [创建直播截图配置](https://support.huaweicloud.com/api-live/CreateSnapshotConfig.html) | | PUT /v1/{project_id}/stream/snapshot | [修改直播截图配置](https://support.huaweicloud.com/api-live/UpdateSnapshotConfig.html) | | GET /v1/{project_id}/stream/snapshot | [查询直播截图配置](https://support.huaweicloud.com/api-live/ListSnapshotConfigs.html) | | DELETE /v1/{project_id}/stream/snapshot | [删除直播截图配置](https://support.huaweicloud.com/api-live/DeleteSnapshotConfig.html) | #### 拉流管理接口 表7拉流管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/pull/stream/task | [创建直播拉流转推任务](https://support.huaweicloud.com/api-live/CreatePullTask.html) | | DELETE /v1/{project_id}/pull/stream/task | [删除直播拉流转推任务](https://support.huaweicloud.com/api-live/DeletePullTask.html) | | GET /v1/{project_id}/pull/stream/task | [查询直播拉流转推任务](https://support.huaweicloud.com/api-live/ListPullTasks.html) | | PUT /v1/{project_id}/pull/stream/task | [修改直播拉流转推任务](https://support.huaweicloud.com/api-live/ModifyPullTask.html) | #### 日志管理接口 表8日志管理接口 | 接口 | 说明 | |:---|:---| | GET /v1/{project_id}/logs | [获取直播播放日志](https://support.huaweicloud.com/api-live/ListLiveSampleLogs.html) | #### 录制管理接口 表9录制管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/record/rules | [创建录制规则](https://support.huaweicloud.com/api-live/CreateRecordRule.html) | | GET /v1/{project_id}/record/rules | [查询录制规则列表](https://support.huaweicloud.com/api-live/ListRecordRules.html) | | PUT /v1/{project_id}/record/rules/{id} | [修改录制规则](https://support.huaweicloud.com/api-live/UpdateRecordRule.html) | | DELETE /v1/{project_id}/record/rules/{id} | [删除录制规则](https://support.huaweicloud.com/api-live/DeleteRecordRule.html) | | GET /v1/{project_id}/record/rules/{id} | [查询录制规则配置](https://support.huaweicloud.com/api-live/ShowRecordRule.html) | | POST /v1/{project_id}/record/control | [提交录制控制命令](https://support.huaweicloud.com/api-live/RunRecord.html) | | POST /v1/{project_id}/record/indexes | [创建录制视频索引文件](https://support.huaweicloud.com/api-live/CreateRecordIndex.html) | #### 录制回调管理接口 表10录制回调管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/record/callbacks | [创建录制回调配置](https://support.huaweicloud.com/api-live/CreateRecordCallbackConfig.html) | | GET /v1/{project_id}/record/callbacks | [查询录制回调配置列表](https://support.huaweicloud.com/api-live/ListRecordCallbackConfigs.html) | | PUT /v1/{project_id}/record/callbacks/{id} | [修改录制回调配置](https://support.huaweicloud.com/api-live/UpdateRecordCallbackConfig.html) | | GET /v1/{project_id}/record/callbacks/{id} | [查询录制回调配置](https://support.huaweicloud.com/api-live/ShowRecordCallbackConfig.html) | | DELETE /v1/{project_id}/record/callbacks/{id} | [删除录制回调配置](https://support.huaweicloud.com/api-live/DeleteRecordCallbackConfig.html) | #### HTTPS证书管理接口 表11HTTPS证书管理接口 | 接口 | 说明 | |:---|:---| | GET /v2/{project_id}/certificates | [查询HTTPS证书信息](https://support.huaweicloud.com/api-live/ShowCertificateInfo.html) | | PUT /v1/{project_id}/guard/https-cert | [修改指定域名的HTTPS证书配置](https://support.huaweicloud.com/api-live/UpdateDomainHttpsCert.html) | | GET /v1/{project_id}/guard/https-cert | [查询指定域名的HTTPS证书配置](https://support.huaweicloud.com/api-live/ShowDomainHttpsCert.html) | | DELETE /v1/{project_id}/guard/https-cert | [删除指定域名的HTTPS证书配置](https://support.huaweicloud.com/api-live/DeleteDomainHttpsCert.html) | #### OBS桶管理接口 表12OBS桶管理接口 | 接口 | 说明 | |:---|:---| | PUT /v1/{project_id}/obs/authority | [OBS桶授权及取消授权](https://support.huaweicloud.com/api-live/UpdateOBSBucketAuthorityPublic.html) | #### 直播水印管理接口 表13直播水印管理接口 | 接口 | 说明 | |:---|:---| | POST /v1/{project_id}/watermark/templates | [创建水印模板](https://support.huaweicloud.com/api-live/CreateWatermarkTemplate.html) | | GET /v1/{project_id}/watermark/templates | [查询水印模板列表](https://support.huaweicloud.com/api-live/ListWatermarkTemplate.html) | | PUT /v1/{project_id}/watermark/templates/{id} | [修改水印模板](https://support.huaweicloud.com/api-live/UpdateWatermarkTemplate.html) | | DELETE /v1/{project_id}/watermark/templates/{id} | [删除水印模板](https://support.huaweicloud.com/api-live/DeleteWatermarkTemplate.html) | | GET /v1/{project_id}/watermark/templates/{id} | [查询水印模板配置](https://support.huaweicloud.com/api-live/ShowWatermarkTemplate.html) | | POST /v1/{project_id}/watermark/rules | [创建水印规则](https://support.huaweicloud.com/api-live/CreateWatermarkRule.html) | | GET /v1/{project_id}/watermark/rules | [查询水印规则列表](https://support.huaweicloud.com/api-live/ListWatermarkRule.html) | | PUT /v1/{project_id}/watermark/rules/{id} | [修改水印规则](https://support.huaweicloud.com/api-live/UpdateWatermarkRule.html) | | DELETE /v1/{project_id}/watermark/rules/{id} | [删除水印规则](https://support.huaweicloud.com/api-live/DeleteWatermarkRule.html) | | GET /v1/{project_id}/watermark/rules/{id} | [查询水印规则配置](https://support.huaweicloud.com/api-live/ShowWatermarkRule.html) | #### 数据统计分析接口 表14数据统计分析接口 | 接口 | 说明 | |:---|:---| | GET /v2/{project_id}/stats/bandwidth/detail | [查询播放带宽趋势](https://support.huaweicloud.com/api-live/ListBandwidthDetail.html) | | GET /v2/{project_id}/stats/traffic/detail | [查询播放流量趋势](https://support.huaweicloud.com/api-live/ListDomainTrafficDetail.html) | | GET /v2/{project_id}/stats/bandwidth/peak | [查询播放带宽峰值](https://support.huaweicloud.com/api-live/ListDomainBandwidthPeak.html) | | GET /v2/{project_id}/stats/traffic/summary | [查询播放流量汇总](https://support.huaweicloud.com/api-live/ListDomainTrafficSummary.html) | | GET /v2/{project_id}/stats/user | [查询观众趋势](https://support.huaweicloud.com/api-live/ListUsersOfStream.html) | | GET /v2/{project_id}/stats/httpcodes | [查询直播拉流HTTP状态码](https://support.huaweicloud.com/api-live/ListQueryHttpCode.html) | | GET /v2/{project_id}/stats/transcode | [查询转码用量](https://support.huaweicloud.com/api-live/ListTranscodeData.html) | | GET /v2/{project_id}/stats/record | [查询录制用量](https://support.huaweicloud.com/api-live/ListRecordData.html) | | GET /v2/{project_id}/stats/snapshot | [查询截图用量](https://support.huaweicloud.com/api-live/ListSnapshotData.html) | | GET /v2/{project_id}/stats/up-bandwidth/detail | [查询上行带宽数据](https://support.huaweicloud.com/api-live/ShowUpBandwidth.html) | | GET /v2/{project_id}/stats/stream-count | [查询域名维度推流路数](https://support.huaweicloud.com/api-live/ShowStreamCount.html) | | GET /v2/{project_id}/stats/history/streams | [查询历史推流列表](https://support.huaweicloud.com/api-live/ListHistoryStreams.html) | | GET /v2/{project_id}/stats/stream-portraits | [查询播放画像信息](https://support.huaweicloud.com/api-live/ShowStreamPortrait.html) | | GET /v2/{project_id}/stats/area/detail | [查询直播各区域指标分布](https://support.huaweicloud.com/api-live/ListAreaDetail.html) | | GET /v2/{project_id}/stats/stream/play-info | [查询播放域名下的流数据](https://support.huaweicloud.com/api-live/ListPlayDomainStreamInfo.html) | | GET /v2/{project_id}/stats/transcode/concurrency | [查询推流域名转码路数](https://support.huaweicloud.com/api-live/ListTranscodeConcurrencyNum.html) | | GET /v2/{project_id}/stats/transcode/detail | [查询转码明细](https://support.huaweicloud.com/api-live/ListTranscodeTaskDetail.html) | #### 流监控接口 表15流监控接口 | 接口 | 说明 | |:---|:---| | GET /v2/{project_id}/stats/stream/framerate | [查询推流帧率数据](https://support.huaweicloud.com/api-live/ListSingleStreamFramerate.html) | | GET /v2/{project_id}/stats/stream/bitrate | [查询推流码率数据](https://support.huaweicloud.com/api-live/ListSingleStreamBitrate.html) | | GET /v2/{project_id}/stats/stream-detail | [查询推流监控数据](https://support.huaweicloud.com/api-live/ListSingleStreamDetail.html) | | GET /v2/{project_id}/stats/up-stream/detail | [查询CDN上行推流质量数据](https://support.huaweicloud.com/api-live/ListUpStreamDetail.html) | | GET /v1/{project_id}/realtime/streams | [查询直播中的流信息](https://support.huaweicloud.com/api-live/ListLiveStreamsOnline.html) | #### 流管理历史接口 表16流管理历史接口 | 接口 | 说明 | |:---|:---| | GET /v1/{project_id}/stream/bandwidth | [查询直播加速的带宽数据](https://support.huaweicloud.com/api-live/live_03_0014.html) | | GET /v1/{project_id}/stream/traffic | [查询直播加速的流量数据](https://support.huaweicloud.com/api-live/live_03_0015.html) | | GET /v1/{project_id}/stream/users | [查询直播播放在线人数](https://support.huaweicloud.com/api-live/live_03_0016.html) |