Queries the 100 most recent automated O&M execution plans in a specified region. If you enable features such as cluster hosting in Auto Mode, automatic cluster upgrades, and automated O&M for node pools, you can call this operation to query the system-generated O&M plans and their execution status. Examples of these plans include cluster upgrades and CVE fixes for node pools.
Debugging
Authorization information
The following table lists the authorization information for this operation. To grant a Resource Access Management (RAM) user or RAM role the permissions to call this operation, add the required permission to the Action element of a RAM access policy. The following list describes the items in the table:
- Operation: The specific permission.
- Access level: The access level of each operation. Valid values: Write, Read, and List.
- Resource type: The resource type that an operation can access.
- Required resource types are marked with an asterisk ( * ).
- For operations that do not support resource-level authorization,
All resourcesis displayed for this item.
- Condition key: The condition keys that are defined by the cloud product.
- Associated operation: Other operations that you must also be authorized to perform to successfully call this operation.
| 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 | Filters the results by cluster ID. | c02b3e03be10643e8a644a843ffcb**** |
| type | string | No | Filters the results by execution plan type. Valid values:
| CLUSTER_UPGRADE_MASTER |
| state | string | No | Filters the results by execution plan state. Valid values:
| Scheduled |
Response parameters
Examples
Successful response example
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 a list of error codes, see the API Error Center.
Change history
| Change time | Description | Actions |
|---|---|---|
| 2025-11-25 | The OpenAPI response structure is changed. | View Details |
| 2025-11-04 | The OpenAPI is added. | View Details |
