調(diào)用CreateCaster創(chuàng)建導(dǎo)播臺(tái)。

使用說(shuō)明

您已開(kāi)通云導(dǎo)播服務(wù)再調(diào)用本接口創(chuàng)建導(dǎo)播臺(tái)。開(kāi)通指引，請(qǐng)參見(jiàn)開(kāi)通服務(wù)。

本接口目前支持的導(dǎo)播臺(tái)規(guī)格類型為通用型、輕量級(jí)輪播型、虛擬演播廳型和新播單型（輪播臺(tái)）。

QPS限制

本接口的單用戶QPS限制為10次/秒。超過(guò)限制，API調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見(jiàn)QPS限制。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 CreateCaster

系統(tǒng)規(guī)定參數(shù)。取值：CreateCaster。

CasterName String 否 liveCaster****

導(dǎo)播臺(tái)名稱。
ClientToken String 是 53200b81-b761-4c10-842a-a0726d97****

用戶生成的請(qǐng)求token。用于保證請(qǐng)求的冪等性。

該參數(shù)值可自定義，但是要保證在不同請(qǐng)求間唯一，最大值不超過(guò)64個(gè)ASCII字符。
NormType Integer 是 1

導(dǎo)播臺(tái)規(guī)格類型。取值：

  • 1：通用型。
  • 3：輕量級(jí)輪播型。
  • 4：虛擬演播廳型。
  • 6：輪播臺(tái)（新播單型導(dǎo)播臺(tái)）。
ChargeType String 是 PostPaid

付費(fèi)方式。 目前只支持PostPaid。取值：

  • PrePaid：預(yù)付費(fèi)（暫不支持）。
  • PostPaid：后付費(fèi)。
PurchaseTime String 否 2017-08-20T12:10:10Z

導(dǎo)播臺(tái)購(gòu)買時(shí)間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時(shí)間）。

說(shuō)明 當(dāng)ChargeType為PrePaid時(shí)，此參數(shù)才可設(shè)置。
ExpireTime String 否 2017-08-22T12:10:10Z

導(dǎo)播臺(tái)過(guò)期時(shí)間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC時(shí)間）。

說(shuō)明 當(dāng)ChargeType為PrePaid時(shí)，此參數(shù)才可設(shè)置。
CasterTemplate String 否 lp_sd

導(dǎo)播臺(tái)預(yù)設(shè)分辨率。采用預(yù)付費(fèi)方式時(shí)，取值：

  • lp_ld：流暢。
  • lp_sd：標(biāo)清。
  • lp_hd：高清。
  • lp_ud：超清。
  • lp_ld_v：豎屏流暢。
  • lp_sd_v：豎屏標(biāo)清。
  • lp_hd_v：豎屏高清。
  • lp_ud_v：豎屏超清。
說(shuō)明 后付費(fèi)場(chǎng)景下，需要設(shè)置分辨率，請(qǐng)調(diào)用SetCasterConfig接口進(jìn)行操作。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
CasterId String a2b8e671-2fe5-4642-a2ec-bf93880e****

導(dǎo)播臺(tái)ID。可作為查詢導(dǎo)播臺(tái)流地址、啟動(dòng)導(dǎo)播臺(tái)、添加導(dǎo)播臺(tái)視頻資源、添加導(dǎo)播臺(tái)布局、查詢導(dǎo)播臺(tái)布局列表、添加導(dǎo)播臺(tái)組件和添加導(dǎo)播臺(tái)節(jié)目單的請(qǐng)求參數(shù)。
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

請(qǐng)求ID。

示例

請(qǐng)求示例

http(s)://live.aliyuncs.com/?Action=CreateCaster
&ChargeType=PostPaid
&ClientToken=53200b81-b761-4c10-842a-a0726d97****
&NormType=1
&<公共請(qǐng)求參數(shù)>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<CreateCasterResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<CasterId>a2b8e671-2fe5-4642-a2ec-bf93880e1****</CasterId>
</CreateCasterResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CreateCasterResponse" : {
    "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
    "CasterId" : "a2b8e671-2fe5-4642-a2ec-bf93880e1****"
  }
}

錯(cuò)誤碼

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。