全部產品
Search
文件中心

ApsaraVideo Live:GetEdgeTranscodeTemplate

更新時間:Jul 16, 2026

查詢邊緣轉碼範本詳情。

介面說明

  • 本介面用於查詢邊緣轉碼範本詳情。

  • 使用者需要具有存取邊緣轉碼服務的權限,才能正常呼叫本介面。

QPS 限制

本介面的單一使用者 QPS 限制為 6000 次/分鐘。超過限制,API 呼叫會被限流,這可能會影響您的業務,請合理呼叫。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

live:GetEdgeTranscodeTemplate

get

*Domain

acs:live:*:{#accountId}:domain/{#DomainName}

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

地域 ID。

cn-shanghai

ClusterId

string

機房 ID。

******3b-4d18-395c-8106-ff21a6******

TemplateId

string

範本 ID。

****a046-263c-3560-978a-fb287666****

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

******3B-0E1A-586A-AC29-742247******

Template

object

邊緣轉碼範本。

Bitrate

string

位元率設定,有固定位元率、位元率隨源(ws)2 種。

3000

Codec

string

影片編碼格式,列舉:

  • H.264。

  • H.265。

H.264

CreateTime

string

範本建立時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2023-07-25T02:48:58Z

Fps

string

幀率設定,有固定幀率、幀率隨源(ws)2 種。

30

Gop

string

關鍵幀設定,有按幀設定、按秒設定、關鍵幀隨源(ws)3 種。

2s

Name

string

範本名稱。

my_template

Resolution

string

解析度設定,有固定解析度、解析度隨源(ws)2 種。

說明

當使用固定解析度,width/height 取值為 -1/-2 時,則表示寬/高自適應。

1920*1080

TemplateId

string

範本 ID。

9b1571b513cb44f7a1ba6ae561ff****

Type

string

邊緣轉碼類型。

common

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Template": {
    "Bitrate": "3000",
    "Codec": "H.264",
    "CreateTime": "2023-07-25T02:48:58Z",
    "Fps": "30",
    "Gop": "2s",
    "Name": "my_template",
    "Resolution": "1920*1080",
    "TemplateId": "9b1571b513cb44f7a1ba6ae561ff****",
    "Type": "common"
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 MissingParameter %s. 參數缺失。
403 OperationDenied %s, please check and try again later. 操作拒絕,請檢查後重試。
404 TemplateNotFound %s, please check and try again later. 範本不存在,請檢查後重試。

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

變更歷史

更多資訊,參考變更詳情