更新频道组的实时打包源站端点配置,支持协议、时移设置及访问控制。
接口说明
请求说明
本接口用于修改指定频道组下实时打包服务的源站端点配置。您可以通过此接口调整回源协议、设定时移天数、定义播放列表名称以及配置 IP 黑白名单等,以实现对实时流媒体分发的精细化管理。请注意,部分参数为必填项,且 IP 白名单与回源请求头需至少提供一个。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:UpdateLivePackageOriginEndpoint |
update |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| GroupName |
string |
是 |
已创建的频道组名称。 |
channel-group-1 |
| ChannelName |
string |
是 |
已创建的频道名称。 |
channel-1 |
| EndpointName |
string |
是 |
源站端点名称,字符必须为大小写英文字母、数字、短横线、下划线。1 ~ 200 个字符。格式:[A-Za-z0-9_-]+ |
endpoint-1 |
| Protocol |
string |
是 |
协议,暂只支持 HLS |
HLS |
| ManifestName |
string |
否 |
播放列表名,缺省为 manifest |
manifest |
| Description |
string |
否 |
端点描述 |
This is an origin endpoint. |
| TimeshiftVision |
integer |
否 |
时移天数,最大 30 天 |
5 |
| AuthorizationCode |
string |
否 |
授权码,与 IpWhitelist 至少设置一个,最长 200 字符。格式:[A-Za-z0-9-_.]+ |
Abc123Def456 |
| IpWhitelist |
string |
否 |
IP 白名单,支持掩码,不允许配置 0.0.0.0/0,多个使用逗号分隔,与 AuthorizationCode 至少设置一个,最大 1000 字符 |
192.168.1.0/24,10.0.0.1 |
| IpBlacklist |
string |
否 |
IP 黑名单,支持掩码,逗号分隔 |
103.0.0.0/8 |
| LivePackagingConfig | LivePackagingConfig |
否 |
直播封装配置 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| LivePackageOriginEndpoint |
object |
源站端点类型 |
|
| AuthorizationCode |
string |
授权码 |
Abc123Def456 |
| ChannelName |
string |
频道名称 |
channel-1 |
| CreateTime |
string |
创建时间 |
2023-04-01T12:00:00Z |
| Description |
string |
端点描述 |
This is an origin endpoint. |
| EndpointName |
string |
端点名称 |
endpoint-1 |
| EndpointUrl |
string |
端点 URL |
https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest |
| GroupName |
string |
频道组名称 |
channel-group-1 |
| IpBlacklist |
string |
IP 黑名单,支持掩码,逗号分隔 |
10.21.222.1/32,192.168.100.0/24 |
| IpWhitelist |
string |
IP 白名单,支持掩码,逗号分隔 |
192.168.1.0/24,10.0.0.1/24 |
| LastModified |
string |
最后修改时间 |
2023-04-01T12:00:00Z |
| ManifestName |
string |
播放列表名,缺省为 manifest |
manifest |
| Protocol |
string |
协议,暂只支持 HLS |
HLS |
| TimeshiftVision |
integer |
时移天数,最大 30 天 |
5 |
| LivePackagingConfig | LivePackagingConfig |
直播封装配置 |
|
| RequestId |
string |
请求 ID |
5D87B753-0250-5D9D-B248-D40C3271F864 |
示例
正常返回示例
JSON格式
{
"LivePackageOriginEndpoint": {
"AuthorizationCode": "Abc123Def456",
"ChannelName": "channel-1",
"CreateTime": "2023-04-01T12:00:00Z",
"Description": "This is an origin endpoint.",
"EndpointName": "endpoint-1",
"EndpointUrl": "https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest",
"GroupName": "channel-group-1",
"IpBlacklist": "10.21.222.1/32,192.168.100.0/24",
"IpWhitelist": "192.168.1.0/24,10.0.0.1/24",
"LastModified": "2023-04-01T12:00:00Z",
"ManifestName": "manifest",
"Protocol": "HLS",
"TimeshiftVision": 5,
"LivePackagingConfig": {
"LiveManifestConfigs": [
{
"SegmentCount": 3,
"AdMarkers": "NONE",
"MinVideoBitrate": 1000000,
"MinBufferTime": 8,
"PresentationDelay": 12,
"StreamOrder": "ORIGINAL",
"MaxVideoBitrate": 8000000,
"DateTimeInterval": 5,
"SegmentTemplateFormat": "NUMBER_TIMELINE",
"MinUpdatePeriod": 8,
"ManifestDuration": 60
}
],
"UseAudioRenditionGroups": true,
"DrmConfig": {
"SystemIds": [
"9a04f079-9840-4286-ab92-e65be0885f95"
],
"RotatePeriod": 0,
"ContentId": "live-axb1-9dd2fa123",
"EncryptionMethod": "SAMPLE_AES",
"IV": "00000000000000000000000000000000",
"Url": "https://exampledrm.com/path?arg1=xxx"
},
"SegmentDuration": 6
}
},
"RequestId": "5D87B753-0250-5D9D-B248-D40C3271F864"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。