Queries the 100 most recent execution plans for automated Operations and Maintenance (O&M) in a specified region. After you enable features such as intelligent cluster hosting in Auto Mode, automatic cluster upgrades, and automated O&M for node pools, you can call this operation to query the automatically generated O&M plans and check their execution status. Examples include cluster upgrades and node pool CVE fixes.
Debug
Authorization information
The following table describes the authorization information that is required to call this operation. You can add this information to the Action element of a Resource Access Management (RAM) policy to grant a RAM user or RAM role the permissions to call this operation. The columns are described as follows:
- Operation: The specific permission.
- Access level: The access level of each operation. Valid values: Write, Read, and List.
- Resource type: The type of resource on which the permission can be granted. The following rules apply:
- An asterisk ( * ) indicates a required resource type.
- If an operation does not support resource-level authorization,
All Resourcesis used.
- Condition key: The condition keys defined by the cloud product.
- Associated operation: Other required operations. To call this operation, you must also have the permissions to call the associated operations.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| cs:ListOperationPlansForRegion | none | *All Resources * |
| 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 | Filter by cluster ID. | c02b3e03be10643e8a644a843ffcb**** |
| type | string | No | Filter by execution plan type. Valid values:
| CLUSTER_UPGRADE_MASTER |
| state | string | No | Filter by execution plan status. Valid values:
| Scheduled |
Response parameters
Examples
Sample success response
JSON format
{
"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 more information about error codes, see the Error Center.
Change history
| Change time | Change summary | Action |
|---|---|---|
| 2025-11-25 | The OpenAPI response structure is changed. | View change details |
| 2025-11-04 | A new OpenAPI operation is added. | View change details |
