Binds an input media bucket to the media library.

Usage notes

Before you call this operation to bind a media bucket, you must create a media bucket. For more information, see Library settings.

QPS limit

You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the 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 BindInputBucket

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

Bucket String Yes example-bucket-****

The name of the input media bucket to be bound. The name can be up to 64 bytes in size. To obtain the media bucket name, you can log on to the ApsaraVideo Media Processing (MPS) console and choose Workflows > Media Buckets in the left-side navigation pane.

Note The bucket name can contain lowercase letters, digits, and hyphens (-), and cannot start or end with a hyphen (-).
RoleArn String No acs:ram::174809843091****:role/exampleRoleName

The Alibaba Cloud Resource Name (ARN) of the role used for proxy authorization.

Referer String No http://www.example.com

The settings of Object Storage Service (OSS) hotlink protection. For more information, see Hotlink protection.

Response parameters

Parameter Type Example Description
RequestId String 4AEA0480-32F4-1656-92B3-F4D4CDE6BBB3

The ID of the request.

Examples

Sample requests

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=BindInputBucket
&Bucket=example-bucket-****
&RoleArn=acs:ram::174809843091****:role/exampleRoleName
&Referer=http://www.example.com
&<Common request parameters>

Sample success responses

XML format

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

<BindInputBucketResponse>
    <RequestId>4AEA0480-32F4-1656-92B3-F4D4CDE6BBB3</RequestId>
</BindInputBucketResponse>

JSON format

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

{
  "RequestId" : "4AEA0480-32F4-1656-92B3-F4D4CDE6BBB3"
}

Error codes

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