All Products
Search

This Product

    ApsaraVideo Live:CopyCaster

    Document Center

    ApsaraVideo Live:CopyCaster

    Last Updated:May 08, 2024

    Duplicates a production studio.

    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.