用於新增即時串流媒體頻道的源站端點設定，支援 HLS、HLS_CMAF 和 DASH 通訊協定及 DRM 加密。
介面說明
請求說明
該介面允許使用者建立一個即時封裝服務的源站端點，主要用於設定頻道的回源、安全性策略（如 IP 白名單與黑名單及授權碼）及時移功能。目前僅支援 HLS 通訊協定播放。建立源站端點前，需先建立好即時封裝頻道群組和頻道。建立成功後，將傳回端點播放位址及其他設定詳情。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| GroupName |
string |
是 |
頻道群組名稱。 |
channel-group-1 |
| ChannelName |
string |
是 |
頻道名稱。 |
channel-1 |
| EndpointName |
string |
是 |
源站端點名稱，字元必須為大小寫英文字母、數字、短橫線、底線。1 ~ 200 個字元。格式：[A-Za-z0-9_-]+。 |
endpoint-1 |
| Protocol |
string |
是 |
分發通訊協定。 |
HLS |
| ManifestName |
string |
否 |
清單名稱，預設為 manifest。 |
manifest |
| Description |
string |
否 |
端點描述。 |
This is an origin endpoint. |
| TimeshiftVision |
integer |
否 |
時移天數，最大 30 天，預設為 0 表示不支援時移。 |
1 |
| AuthorizationCode |
string |
否 |
授權碼，與 IpWhitelist 至少設定一個，最長 200 字元。格式：[A-Za-z0-9-_.]+。 |
AbcDef123 |
| IpWhitelist |
string |
否 |
IP 白名單，支援遮罩，不允許設定 0.0.0.0/0，多個使用逗號分隔，與 AuthorizationCode 至少設定一個，最大 1000 字元。 |
192.168.1.0/24,10.0.0.1/24 |
| IpBlacklist |
string |
否 |
IP 黑名單，支援遮罩，不允許設定 0.0.0.0/0，多個使用逗號分隔，最大 1000 字元。 |
103.21.222.1/32,192.168.100.0/24 |
| ClientToken |
string |
否 |
冪等參數。 |
****0311a423d11a5f7dee713535**** |
| LivePackagingConfig | LivePackagingConfig |
否 |
直播封裝設定。 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| LivePackageOriginEndpoint |
object |
LivePackageOriginEndpoint 類型。 |
|
| AuthorizationCode |
string |
授權碼。 |
Abcded123 |
| ChannelName |
string |
頻道名稱。 |
channel-1 |
| CreateTime |
string |
建立時間。 |
2023-04-01T12:00:00Z |
| Description |
string |
端點描述。 |
This is an origin endpoint. |
| EndpointName |
string |
端點名稱。 |
endpoint-1 |
| EndpointUrl |
string |
端點播放位址。 |
https://xxx.packagepull-abcxxx.ap-southeast-1.aliyuncsiceintl.com/v1/group01/1/ch01/manifest |
| GroupName |
string |
頻道群組名稱。 |
channel-group-1 |
| IpBlacklist |
string |
IP 黑名單。 |
103.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 |
| Protocol |
string |
通訊協定，暫只支援 HLS。 |
HLS |
| TimeshiftVision |
integer |
時移天數，最大 30 天。 |
1 |
| LivePackagingConfig | LivePackagingConfig |
直播封裝設定。 |
|
| RequestId |
string |
請求 ID。 |
******11-DB8D-4A9A-875B-275798****** |
樣本
正常返回樣本
JSON格式
{
"LivePackageOriginEndpoint": {
"AuthorizationCode": "Abcded123",
"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": "103.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": 1,
"LivePackagingConfig": {
"DrmConfig": {
"SystemIds": [
"9a04f079-9840-4286-ab92-e65be0885f95"
],
"EncryptionMethod": "SAMPLE_AES",
"IV": "00000000000000000000000000000000",
"Url": "https://exampledrm.com/path?arg1=xxx",
"RotatePeriod": 0,
"ContentId": "live-axb1-9dd2fa123"
},
"SegmentDuration": 6,
"UseAudioRenditionGroups": true,
"LiveManifestConfigs": [
{
"SegmentCount": 3,
"DateTimeInterval": 5,
"MinUpdatePeriod": 8,
"AdMarkers": "NONE",
"StreamOrder": "ORIGINAL",
"MinVideoBitrate": 1000000,
"MaxVideoBitrate": 8000000,
"MinBufferTime": 8,
"PresentationDelay": 12,
"ManifestDuration": 60,
"SegmentTemplateFormat": "NUMBER_TIMELINE",
"PartHoldBackMs": 0
}
],
"PartDurationMs": 0
}
},
"RequestId": "******11-DB8D-4A9A-875B-275798******"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。