tencent cloud

Enable Media Processing Service
Download PDF
Last updated:2025-09-08 17:59:38
Enable Media Processing Service
Last updated: 2025-09-08 17:59:38
Download PDF

Feature Description

This API is used to enable the media processing service and generate a queue.

Authorization Description

When used by a sub-account, the ci:CreateMediaBucket permission must be granted. For details, see Cloud Infinite actions.

Activating a Service

Using this feature requires enabling Cloud Infinite in advance and binding a bucket. For details, see Binding a Bucket.

Use Limits

When using this API, please first confirm the relevant restrictions. For details, see Usage Limits.

Request

Request sample:

POST /mediabucket HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml
Note:
Authorization: Auth String. For details, see Request Signature document.

Request header.

This API only uses common request headers. For details, see Common Request Headers documentation.

Request body.

The request does not have a request body.

Response

Response Headers

This API only returns common response headers. For details, please refer to the Public Response Headers document.

Response Body

The response body is returned as application/xml. An example including the complete node data is shown below:
<Response>
    <RequestId>NjJmNDczY2RfOTBmYTUwNjRfNTA4ZV85</RequestId>
    <MediaBucket>
        <BucketId>examplebucket-1250000000</BucketId>
        <Name>examplebucket-1250000000</Name>
        <Region>ap-beijing</Region>
        <CreateTime>2019-11-15T12:12:12+0800</CreateTime>
        <PlayKeyList>
            <MasterPlayKey>d93bfe5e82ae4995xxxxxxxxxxxxxxxx</MasterPlayKey>
            <BackupPlayKey>b47d30a0863a4884xxxxxxxxxxxxxxxx</BackupPlayKey>
        </PlayKeyList>
    </MediaBucket>
</Response>
The data are as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None.
Container for saving results
Container
Container node Response content:
Node Name (Keyword)
Parent Node
Description
Type
RequestId
Response
unique request ID
String
MediaBucket
Response
Media Bucket details
Container
Container node MediaBucket content:
Node Name (Keyword)
Parent Node
Description
Type
BucketId
Response.MediaBucket
bucket ID
String
Name
Response.MediaBucket
bucket name, same as BucketId
String
Region
Response.MediaBucket
region
String
CreateTime
Response.MediaBucket
Creation time
String
PlayKeyList
Response.MediaBucket
Playback Key List
Container
Container node PlayKeyList content:
Node Name (Keyword)
Parent Node
Description
Type
MasterPlayKey
Response.MediaBucket.PlayKeyList
Primary Playback Key
String
BackupPlayKey
Response.MediaBucket.PlayKeyList
Secondary Playback Key
String

Error Codes

This request has no specific error messages. For common error information, please refer to the Error Codes document.

Examples

Request

POST /mediabucket HTTP/1.1
Authorization:q-sign-algorithm=sha1&q-ak=**********************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=**********************************************
Host:examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Content-Length: 0
Content-Type: application/xml


Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 09 Aug 2022 16:23:12 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
    <RequestId>NjJmNDczY2RfOTBmYTUwNjRfNTA4ZV85</RequestId>
    <MediaBucket>
        <BucketId>examplebucket-1250000000</BucketId>
        <Name>examplebucket-1250000000</Name>
        <Region>ap-beijing</Region>
        <CreateTime>2019-11-15T12:12:12+0800</CreateTime>
        <PlayKeyList>
            <MasterPlayKey>d93bfe5e82ae4995xxxxxxxxxxxxxxxx</MasterPlayKey>
            <BackupPlayKey>b47d30a0863a4884xxxxxxxxxxxxxxxx</BackupPlayKey>
        </PlayKeyList>
    </MediaBucket>
</Response>

Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback