Help Center/ Data Warehouse Service/ API Reference/ API Description/ Intelligent O&M/ Modifying Common Configurations of Scheduling O&M Tasks
Updated on 2026-11-11 GMT+08:00

Modifying Common Configurations of Scheduling O&M Tasks

Function

Modify the common configuration of scheduling O&M tasks.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    dws:cluster:updateOperationalTaskConfig

    Write

    cluster *

    • g:ResourceTag/<tag-key>

    • g:EnterpriseProjectId

    dws:operationalTask:operate

    -

URI

PUT /v1/{project_id}/clusters/{cluster_id}/operational-tasks/configuration

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition:

Project ID. For details about how to obtain the project ID,see Obtaining a Project ID.

Constraints:

None

Range:

None

Default Value:

None

cluster_id

Yes

String

Definition:

Cluster ID For details about how to obtain the cluster ID, see Obtaining the Cluster ID.

Constraints:

None

Range:

None

Default Value:

None

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

parallel_min

No

Integer

Definition

Minimum number of concurrent VACUUM FULL tasks for user tables.

Constraints

N/A

Range

1 to 24

Default Value

N/A

parallel_max

No

Integer

Definition

Maximum number of concurrent VACUUM FULL tasks for user tables.

Constraints

N/A

Range

1 to 24

Default Value

N/A

small_cu_rows_limit

No

Integer

Definition

Small CU threshold.

Constraints

N/A

Range

0 to 1000

Default Value

N/A

small_cu_percentage

No

Double

Definition

Proportion of small CUs.

Constraints

N/A

Range

0.01 to 99.99

Default Value

N/A

Response Parameters

Status code: 200

Request succeeded.

None

Example Requests

Modify related configurations.

put https://{Endpoint}/v1/169439ece752470aa5171633e9d3e47f/clusters/50aee999-9215-4dd0-a142-254ac6bf80e7/operational-tasks/configuration

{
  "parallel_min" : 1,
  "parallel_max" : 20,
  "small_cu_rows_limit" : 1000,
  "small_cu_percentage" : 55
}

Example Responses

Status code: 200

{ }

Status Codes

Status Code

Description

200

Request succeeded.

400

Request error.

401

Authentication failed.

403

No operation permissions.

404

No resources found.

500

Internal service error.

503

Service unavailable.