CopyCaster - ApsaraVideo Live

Usage notes

You can call this operation to duplicate a production studio. This way, a new, identical production studio is created.

QPS limit

You can call this operation up to 10 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

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	CopyCaster	The operation that you want to perform. Set the value to CopyCaster.
CasterName	String	Yes	caster001	The name of the new production studio.
SrcCasterId	String	Yes	a2b8e671-2fe5-4642-a2ec-bf93880e****	The ID of the original production studio. If the production studio was created by calling the CreateCaster operation, check the value of the response parameter CasterId to obtain the ID. If the production studio was created by using the ApsaraVideo Live console, obtain the ID on the Production Studio Management page. To go to the page, log on to the ApsaraVideo Live console and click Production Studios in the left-side navigation pane. Note You can find the ID of the production studio in the Instance Name column.
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 the 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.

Response parameters

Parameter	Type	Example	Description
CasterId	String	1909f043-e3d3-49e9-82d6-4329ec4a****	The ID of the new production studio.
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	The request ID.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=CopyCaster
&CasterName=caster001
&ClientToken=53200b81-b761-4c10-842a-a0726d97****
&SrcCasterId=a2b8e671-2fe5-4642-a2ec-bf93880e****
&<Common request parameters>

Sample success responses

XML format

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

<CopyCasterResponse>
    <CasterId>1909f043-e3d3-49e9-82d6-4329ec4a****</CasterId>
    <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</CopyCasterResponse>

JSON format

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

{
  "CasterId" : "1909f043-e3d3-49e9-82d6-4329ec4a****",
  "RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

For a list of error codes, see Service error codes.