All Products
Search
Document Center

Security Center:ResetLogShipper

Last Updated:Mar 20, 2026

Resets and upgrades the log analysis feature. You can call this operation only when the log analysis feature uses the pay-as-you-go billing method.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TtlintegerNo

The global log retention period.

Note This parameter is supported only when the log analysis feature uses the pay-as-you-go billing method.
180
HotTtlintegerNo

The global retention period of hot data.

Note The value of this parameter must be at least 7 and smaller than the log retention period. Unit: days.
7
LogMetaListarray<object>No

The settings of the log analysis feature.

objectNo

The setting of the log analysis feature.

ConfigLogStorestringNo

The Logstore that you want to configure.

Note You can call the DescribeLogMeta operation to query the Logstore.
sas-security-log
StatusstringNo

The status of the log analysis feature. Valid values:

  • disabled
  • enabled
enabled
TtlintegerNo

The log retention period of the Logstore.

Note If you specify this parameter for the Logstore, the global log retention period specified by the Ttl parameter is overwritten.
60
HotTtlintegerNo

The retention period of hot data in the Logstore.

Note The value of this parameter must be at least 7 and smaller than the log retention period. Unit: days. If you specify this parameter for the Logstore, the global retention period of hot data specified by the HotTtl parameter is overwritten.
7

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

D2E31293-DAAC-574B-B816-A18EA0A6****

Examples

Sample success responses

JSONformat

{
  "RequestId": "D2E31293-DAAC-574B-B816-A18EA0A6****"
}

Error codes

HTTP status codeError codeError messageDescription
400IllegalHotTTLThe hot storage TTL is invalid.The hot storage data must be stored for at least 7 days and must be less than the data storage time.
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history