All Products
Search

This Product

    Cloud Firewall:ModifySlsDispatchConfig

    Document Center

    Cloud Firewall:ModifySlsDispatchConfig

    Last Updated:Jul 22, 2026

    Modifies the configurations for log delivery to Simple Log Service (SLS).

    Operation description

    Before calling this operation, call DescribeUserBuyVersion to obtain the LogVersion of the user.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    ModifyType

    string

    No

    The modification type. Valid values:

    • version: The version is changed. For example, the version is changed from 1 (logs are delivered to one Logstore) to 2 (logs are delivered to two Logstores).

    • config: The configuration is changed. For example, the log delivery region or the storage duration of logs is modified.

    Valid values:

    • version :

      Version.

    • config :

      Configuration.

    version
    LogVersion

    integer

    No

    The log version. A value of 1 indicates one Logstore. A value of 2 indicates two Logstores.

    Important If ModifyType is set to version, set LogVersion to the target version. If ModifyType is set to config, set LogVersion to the current version of the user.

    Valid values:

    • 1 :

      Version 1

    • 2 :

      Version 2

    1
    DetailConfig

    string

    No

    The detailed configuration to modify.

    Format for version 1

    {"global":{"slsRegionId":"ap-southeast-1","logTime":180,"logStorage":1000}}

    Format for version 2

    {"cn":{"slsRegionId":"ap-southeast-1","logTime":180,"logStorage":3000},"intl":{"slsRegionId":"ap-southeast-1","logTime":180,"logStorage":2000}}
    The fields are described as follows:

    • slsRegionId: The region ID to which logs are delivered.

    • logTime: The storage duration of logs. Unit: days.

    • logStorage: The log storage capacity. Unit: GB. The total capacity specified must not exceed the total capacity purchased by the user.

    {"global":{"slsRegionId":"cn-hangzhou","logTime":180,"logStorage":1000}}

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    4CD646BA-490F-5584-9272-B6FFE3BB****
    TaskId

    string

    The task ID. Modifying log configurations is an asynchronous task. This field indicates the unique identifier of the task. You can use this ID to query the status of the task.

    d8c995ec-40a5-4382-a3f3-57713096****

    Examples

    Success response

    JSON format

    {
  "RequestId": "4CD646BA-490F-5584-9272-B6FFE3BB****",
  "TaskId": "d8c995ec-40a5-4382-a3f3-57713096****"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalOperation Illegal operation, unable to operate within 5 minutes, please try again in 5 minutes. Illegal operation, unable to operate within 5 minutes, please try again in 5 minutes.
    400 RepeatInFiveMinutes Repeat operation in five minutes, please try later. Repeat operation is not allowed for five minutes. Please try again later.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.