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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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:

  • PrePaid: subscription.
  • PostPaid: pay-as-you-go.
    Note Only the pay-as-you-go billing method is supported now.
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:

  • 0: the playlist mode (deprecated version).
  • 1: the studio mode.
  • 6: the playlist mode (new version).
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:

  • lp_ld: The production studio plays videos in the low definition.
  • lp_sd: The production studio plays videos in the standard definition.
  • lp_hd: The production studio plays videos in the high definition.
  • lp_ud: The production studio plays videos in the ultra high definition.

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.