通過API更新直播源端點 - 智能媒體服務

更新頻道組的即時打包來源站點端點配置，支援協議、時移設定及存取控制。

介面說明

請求說明

本介面用於修改指定頻道組下即時打包服務的來源站點端點配置。您可以通過此介面調整回源協議、設定時移天數、定義播放清單名稱以及配置 IP 黑白名單等，以實現對即時資料流媒體分發的精細化管理。請注意，部分參數為必填項，且 IP 白名單與回源要求標頭需至少提供一個。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

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	否	端點描述	這是一個來源站點端點
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	端點描述	這是一個來源站點端點
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": "這是一個來源站點端點",
    "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"
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。