Creates a production studio.
Usage note
- You must activate the production studio service before calling this API. For instructions, see Activate production studio.
- This operation only supports creating a production studio in the playlist mode (deprecated version), the studio mode, and the playlist mode (new version).
QPS limit
A single user can perform a maximum of 10 queries per second (QPS). Throttling is triggered when the number of calls per second exceeds the QPS limit. The throttling may affect your business. Thus, we recommend that you observe the QPS limit on this operation. For more information about what a single user means and the QPS details, see QPS limit on an API operation in ApsaraVideo Live.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | CreateCaster |
The operation that you want to perform. Set the value to CreateCaster. |
ChargeType | String | Yes | PostPaid |
The billing method of the production studio. Valid values:
|
ClientToken | String | Yes | 53200b81-b761-4c10-842a-a0726d97**** |
The client token that is used to ensure the idempotence of the request. You can use the client to generate a token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. |
NormType | Integer | Yes | 1 |
The type of the production studio. Valid values:
|
RegionId | String | No | cn-shanghai |
The ID of the region. |
CasterName | String | No | liveCaster**** |
The name of the production studio. |
PurchaseTime | String | No | 2017-08-20T12:10:10Z |
The time when the production studio was purchased. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
ExpireTime | String | No | 2017-08-22T12:10:10Z |
The expiration time of the production studio. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
CasterTemplate | String | No | lp_sd |
The preset resolution of the production studio. When the billing method is subscription, this parameter supports the following valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
The ID of the request. |
CasterId | String | a2b8e671-2fe5-4642-a2ec-bf93880e**** |
The ID of the production studio. |
Examples
Sample requests
http(s)://live.aliyuncs.com/?Action=CreateCaster
&ChargeType=PostPaid
&ClientToken=53200b81-b761-4c10-842a-a0726d97****
&NormType=1
&<Common request parameters>
Sample success responses
XML
format
<CreateCasterResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
<CasterId>a2b8e671-2fe5-4642-a2ec-bf93880e1****</CasterId>
</CreateCasterResponse>
JSON
format
{
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
"CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e1****"
}
Error codes
For a list of error codes, visit the API Error Center.