全部產品
Search
文件中心

Intelligent Media Services:CreateLivePackageOriginEndpoint - 建立即時打包來源站點端點

更新時間:Mar 21, 2026

用於添加即時資料流媒體頻道的來源站點端點配置,支援HLS、HLS_CMAF和DASH協議及DRM加密。

介面說明

請求說明

該介面允許使用者建立一個即時打包服務的來源站點端點,主要用於配置頻道的回源、安全性原則(如 IP 黑白名單及授權碼)及時移功能。目前僅支援 HLS 協議播放。建立來源站點端點前,需先建立好即時打包頻道組和頻道。建立成功後,將返回端點播放地址及其他配置詳情。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:CreateLivePackageOriginEndpoint

create

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

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

端點描述

這是一個來源站點端點

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

端點描述

這是一個來源站點端點

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": "這是一個來源站點端點",
    "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": {
      "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": "******11-DB8D-4A9A-875B-275798******"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情