Use ListOperationPlansForRegion to Retrieve O&M Plans - ACK Serverless

Queries the 100 most recent execution plans for automated operations and maintenance (O&M) in a specified region. When you enable features such as intelligent cluster management in Auto Mode, automatic cluster upgrades, and automated O&M for node pools, you can call this operation to query system-generated O&M plans and their execution status. Examples of these plans include cluster upgrades and node pool CVE fixes.

Debug

You can run this operation directly in OpenAPI Explorer. This saves you the effort of calculating signatures. After a successful call, OpenAPI Explorer automatically generates SDK code examples.

Test

Authorization information

The following table lists the authorization information for this API. You can use this information in the Action element of a Resource Access Management (RAM) policy statement to grant a RAM user or RAM role the permissions to call this API. The columns are described as follows:

Operation: The specific permission point.
Access level: The access level of each operation. Valid values are Write, Read, and List.
Resource type: The type of resource for which permissions can be granted for the operation. The following rules apply:
- An asterisk ( * ) is prefixed to a required resource type.
- If the operation does not support resource-level authorization, All Resources is specified.
Condition key: The condition keys defined by the cloud product.
Associated operation: Other permissions that are required to perform the operation. To perform the operation, you must have the permissions for the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
cs:ListOperationPlansForRegion	none	All Resources ``	None	None

Request syntax

<p>GET /regions/{region_id}/operation/plans HTTP/1.1</p>

Request parameters

Name	Type	Required	Description	Example
region_id	string	Yes	The region ID.	cn-beijing
cluster_id	string	No	Filters the plans by cluster ID.	c02b3e03be10643e8a644a843ffcb****
type	string	No	Filters the plans by execution plan type. Valid values: CVE_FIX CONTAINERD_UPGRADE CLUSTER_UPGRADE_MASTER CLUSTER_UPGRADE_ADDON NODEPOOL_CONFIG KUBELET_UPGRADE NODEPOOL_UPDATE_OS IMAGE_UPGRADE	CLUSTER_UPGRADE_MASTER
state	string	No	Filters the plans by execution plan state. Valid values: Scheduled: The plan is scheduled. Failed: The execution failed. ValidatingFailed: The pre-check failed. Executing: The plan is being executed. Canceled: The plan is canceled. Executed: The plan is executed.	Scheduled

Response parameters

Name	Type	Description	Example
	object	The response schema.
plans	array<object>	The list of execution plans.
plans	object	The execution plan.
plan_id	string	The execution plan ID.	P-655c9c127e0e6603ef00****
cluster_id	string	The cluster ID.	c29ced64b3dfe4f33b57ca0aa9f68****
created	string	The time when the execution plan was created.	2023-11-21T20:01:22+08:00
start_time	string	The expected start time of the execution.	2023-11-22T15:18:00+08:00
end_time	string	The expected end time of the execution.	2023-11-22T18:00:00+08:00
state	string	The state. Valid values: Scheduled: The plan is scheduled. Failed: The execution failed. ValidatingFailed: The pre-check failed. Executing: The plan is being executed. Canceled: The plan is canceled. Executed: The plan is executed.	Scheduled
state_reason	object	The reason for the state.
code	string	The code.	CanceledByUser
message	string	The message.	plan has been canceled by user
type	string	The type. Valid values: CVE_FIX CONTAINERD_UPGRADE CLUSTER_UPGRADE_MASTER CLUSTER_UPGRADE_ADDON NODEPOOL_CONFIG KUBELET_UPGRADE NODEPOOL_UPDATE_OS IMAGE_UPGRADE	CLUSTER_UPGRADE_MASTER
target_type	string	The type of the execution target. Valid values: cluster nodepool addon	cluster
target_id	string	The ID of the execution target.	c29ced64b3dfe4f33b57ca0aa9f68****
task_id	string	The ID of the job that is generated from the execution plan.	T-681ac448b23ced010600****

Examples

Sample successful response

Format: JSON

{
  "plans": [
    {
      "plan_id": "P-655c9c127e0e6603ef00****",
      "cluster_id": "c29ced64b3dfe4f33b57ca0aa9f68****",
      "created": "2023-11-21T20:01:22+08:00",
      "start_time": "2023-11-22T15:18:00+08:00",
      "end_time": "2023-11-22T18:00:00+08:00",
      "state": "Scheduled",
      "state_reason": {
        "code": "CanceledByUser",
        "message": "plan has been canceled by user"
      },
      "type": "CLUSTER_UPGRADE_MASTER",
      "target_type": "cluster",
      "target_id": "c29ced64b3dfe4f33b57ca0aa9f68****",
      "task_id": "T-681ac448b23ced010600****"
    }
  ]
}

Error codes

For a list of error codes, see the API Error Center.

Change history

Change date	Description	Operation
2025-11-25	The API response structure is changed.	View Details
2025-11-04	The API is added.	View Details