Modifies a video resource of a production studio.

Usage note

The video resource must have been added to the production studio before it can be modified using this operation.

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 ModifyCasterVideoResource

The operation that you want to perform. Set the value to ModifyCasterVideoResource.

CasterId String Yes 9ff2d96b-37ef-40a3-8cb0-4c7b1e2e****

The ID of the production studio.

If you create a production studio through the CreateCaster interface, check the value of the CasterId parameter in the response.

If you create a production studio through the ApsaraVideo Live Console, log in to the console, then check the ID of the production studio through the following path:

Production Studios > Production Studio Management

Note The CasterId is reflected in the Name column on the Production Studio Management page.
ResourceId String Yes 05ab713c-676e-49c0-96ce-cc408da1****

The ID of the video resource. It is reflected in the ResourceId parameter when you call the AddCasterVideoResource operation.

RegionId String No cn-shanghai

The ID of the region.
ResourceName String No test001

The name of the video resource.
LiveStreamUrl String No rtmp://****.aliyundoc.com/caster/4a82a3d1b7f0462ea37348366201****? auth_key=1608953344-0-0-ac8c628078541d7055a170ec59a5****

The URL of the live stream.

This parameter takes effect and is required only when the video resource is a live stream.

MaterialId String No f080575eb5f4427684fc0715159a****

The ID of the material.
VodUrl String No http://developer.aliyundoc.com/AppName/StreamName.flv

The URL of the video-on-demand (VOD) file. This parameter takes effect only when the video resource is a video file that is not from the media library.

Note The VOD file must be in the MP4, FLV, or TS format.
BeginOffset Integer No 0

The offset of the position where the system starts to read the video resource.

This parameter takes effect only when the video resource is a video file. Unit: milliseconds.

Note A value greater than 0 indicates an offset from the first frame.
EndOffset Integer No 10000

This parameter takes effect only when the video resource is a video file. Unit: milliseconds.

  • A value greater than 0 indicates an offset from the first frame.
  • A value smaller than 0 indicates an offset from the last frame.
RepeatNum Integer No 0

The number of playback times after the first playback is complete. This parameter takes effect only when the video resource is a file. Valid values:

  • 0: indicates that the video is played only once. This is the default value.
  • -1: indicates that the video is played in loop mode.
PtsCallbackInterval Integer No 2000

The interval between presentation timestamp (PTS) callbacks. Unit: milliseconds. This parameter takes effect only when the video resource is a VOD file.

Response parameters

Parameter Type Example Description
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

The ID of the request.
CasterId String 9ff2d96b-37ef-40a3-8cb0-4c7b1e2e****

The ID of the production studio.
ResourceId String 98461064-1c94-4dc1-85ce-94098764****

The ID of the video resource.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=ModifyCasterVideoResource
&CasterId=9ff2d96b-37ef-40a3-8cb0-4c7b1e2e****
&ResourceId=05ab713c-676e-49c0-96ce-cc408da1****
&<Common request parameters>

Sample success responses

XML format 

<ModifyCasterVideoResourceResponse>
      <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
      <CasterId>9ff2d96b-37ef-40a3-8cb0-4c7b1e2e****</CasterId>
      <ResourceId>98461064-1c94-4dc1-85ce-94098764****</ResourceId>
</ModifyCasterVideoResourceResponse>

JSON format 

{
    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
    "CasterId": "9ff2d96b-37ef-40a3-8cb0-4c7b1e2e****",
    "ResourceId": "98461064-1c94-4dc1-85ce-94098764****"
}

Error codes

For a list of error codes, visit the API Error Center.