Domain name for API request: cls.tencentcloudapi.com.
This API is used to create a shipping rule. Note: To use this API, you need to check whether you have configured the role and permission for COS shipping tasks. If not, see Viewing and Configuring Shipping Authorization at https://intl.cloud.tencent.com/document/product/614/71623.?from_cn_redirect=1
A maximum of 20 requests can be initiated per second for this API.
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: CreateShipper. |
Version | Yes | String | Common Params. The value used for this API: 2020-10-16. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
TopicId | Yes | String | ID of the log topic to which the shipping rule to be created belongs |
Bucket | Yes | String | Destination bucket in the shipping rule to be created |
Prefix | Yes | String | Prefix of the shipping directory in the shipping rule to be created |
ShipperName | Yes | String | Shipping rule name |
Interval | No | Integer | Interval between shipping tasks (in sec). Default value: 300. Value range: 300-900 |
MaxSize | No | Integer | Maximum size of a file to be shipped, in MB. Default value: 256. Value range: 100-256 |
FilterRules.N | No | Array of FilterRuleInfo | Filter rules for shipped logs. Only logs matching the rules can be shipped. All rules are in the AND relationship, and up to five rules can be added. If the array is empty, no filtering will be performed, and all logs will be shipped. |
Partition | No | String | Rules for partitioning logs to be shipped. strftime can be used to define the presentation of time format. |
Compress | No | CompressInfo | Compression configuration of shipped log |
Content | No | ContentInfo | Format configuration of shipped log content |
Parameter Name | Type | Description |
---|---|---|
ShipperId | String | Shipping rule ID |
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: cls.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateShipper
<Common request parameters>
{
"TopicId": "xxxx-xx-xx-xx-xxxxxxxx",
"Bucket": "test-1250000001",
"Prefix": "test",
"ShipperName": "myname",
"Interval": 300,
"MaxSize": 256,
"Partition": "%Y%m%d",
"Compress": {
"Format": "none"
},
"FilterRules": [
{
"Key": "",
"Regex": "",
"Value": ""
}
]
}
{
"Response": {
"ShipperId": "xxxx-xx-xx-xx-xxxxxxxx",
"RequestId": "6ef60bec-0242-43af-bb20-270359fb54a7"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
AuthFailure | CAM signature/authentication error. |
FailedOperation | Operation failed. |
InternalError | Internal error. |
InvalidParameter | Incorrect parameter. |
InvalidParameter.ShipperConflict | Shipping rule naming conflict. |
InvalidParameterValue | Incorrect parameter value. |
LimitExceeded.Shipper | The number of shipping rules exceeds the limit. |
MissingParameter | Missing parameter. |
OperationDenied | Operation denied. |
OperationDenied.ACLFailed | ACL verification failed. |
OperationDenied.AccountDestroy | The account has been terminated. |
OperationDenied.AccountIsolate | The account has overdue payments. |
OperationDenied.AccountNotExists | The account does not exist. |
ResourceNotFound.TopicNotExist | The log topic does not exist. |
Was this page helpful?