1. API Description
Domain name for API request: vod.intl.tencentcloudapi.com.
Create an incremental migration strategy for the storage of the professional application.
A maximum of 20 requests can be initiated per second for this API.
We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name |
Required |
Type |
Description |
| Action |
Yes |
String |
Common Params. The value used for this API: CreateIncrementalMigrationStrategy. |
| Version |
Yes |
String |
Common Params. The value used for this API: 2024-07-18. |
| Region |
No |
String |
Common Params. This parameter is not required. |
| SubAppId |
Yes |
Integer |
The ID of VOD Professional Application. |
| BucketId |
Yes |
String |
The bucket ID where the strategy takes effect. |
| StrategyName |
Yes |
String |
Incremental migration strategy name. The name length should not exceed 100 characters. Allowed characters include: Chinese characters, English characters, 0-9,_ and -. |
| OriginType |
Yes |
String |
Source type. Valid values: HTTP: the source type is HTTP. |
| HttpOriginConfig |
No |
IncrementalMigrationHttpOriginConfig |
Incremental migration HTTP origin source configuration. This field is required when the OriginType value is HTTP. |
3. Output Parameters
| Parameter Name |
Type |
Description |
| StrategyId |
String |
The ID of the incremental migration strategy. |
| RequestId |
String |
The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
4. Example
Example1 Create an incremental migration strategy.
Create an incremental migration strategy.
{
"SubAppId": 1020304056,
"BucketId": "bucketid1",
"StrategyName": "strategy_name",
"OriginType": "HTTP",
"HttpOriginConfig": {
"OriginInfo": {
"EndpointInfo": {
"Endpoint": "example.com:8080"
}
},
"OriginParameter": {
"HttpHeaderInfo": {
"HeaderFollowMode": "FOLLOW_ALL"
}
}
}
}
Output Example
{
"Response": {
"RequestId": "83bb5dcc-reqid-demo-a891-9ceeed3bb173",
"StrategyId": "im-123-demoid"
}
}
5. Developer Resources
SDK
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
Command Line Interface
6. Error Code
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code |
Description |
| FailedOperation.BucketIdNotMatch |
The application ID does not match the bucket ID. |
| FailedOperation.BucketIncrementalMigrationStrategyDeploying |
The incremental migration strategy for the bucket is currently being deployed. |
| FailedOperation.IncrementalMigrationStrategyOverLimit |
The number of incremental migration strategies for the bucket is over the limit. |
| InvalidParameter |
Invalid parameter. |
| InvalidParameterValue |
Incorrect parameter value. |
| InvalidParameterValue.UnsupportedStorageRegion |
Unsupported storage region. |
| UnauthorizedOperation.SubApp |
Application is unauthorized. |