Help Center/ Cloud Search Service/ API Reference (Kuala Lumpur Region)/ API V1/ Intelligent O&M/ Updating Scheduled Intelligent O&M Diagnosis Settings
Updated on 2026-09-02 GMT+08:00

Updating Scheduled Intelligent O&M Diagnosis Settings

Function

CSS provides scheduled diagnostic capabilities as part of intelligent O&M and supports daily diagnosis of potential cluster risks. This API is used to configure scheduled intelligent O&M diagnosis.

Applicable to Elasticsearch and OpenSearch engines.

Calling Method

For details, see Calling APIs.

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/ai-ops/setting

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name.

Constraints

N/A

Range

Project ID of an account. The value contains 32 characters, consisting of lowercase letters and digits.

Default Value

N/A

cluster_id

Yes

String

Definition

Specifies the ID of the cluster to be updated. For details about how to obtain the cluster ID, see Obtaining the Cluster ID.

Constraints

N/A

Range

UUID format, 36 characters.

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

check_type

Yes

String

Definition:

Check type.

Constraints:

N/A

Value range:

  • full_detection: all check items.

  • unavailability_detection: cluster unavailability check items.

  • partial_detection: partial check items, select by setting check_items.

Default value:

N/A

check_items

No

Array of strings

Definition

Select some detection items from the full detection items for detection. Enter a list of detection items.

Constraints

This parameter is valid only when check_type is partial_detection.

period

Yes

String

Definition:

Intelligent O&M automatic check time, in the form of time followed by time zone, for example, 00:00 GMT+08:00.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

Response Parameters

Status code: 200

Request succeeded.

None

Example Requests

Updating Scheduled Check Settings for Intelligent O&M

POST https://{Endpoint}/v1.0/{project_id}/clusters/4f3deec3-efa8-4598-bf91-560aad1377a3/ai-ops/setting

{
  "check_type" : "full_detection",
  "check_items" : [ ],
  "period" : "11:30 GMT+08:00"
}

Example Responses

None

Status Codes

Status Code

Description

200

Request succeeded.

400

Invalid request. Modify the request directly and do not attempt to retry it.

409

The request cannot be processed due to a conflict. This status code indicates that the resource that the client attempts to create already exists, or the request failed to be processed because of the update of the conflict request.

412

The server does not meet one of the preconditions that the client puts on the request.

Error Codes

See Error Codes.