Obtaining a List of Pre-upgrade Check Tasks of a Cluster
Function
This API is used to obtain a list of pre-upgrade check tasks of a cluster.
Calling Method
For details, see Calling APIs.
URI
GET /autopilot/v3/projects/{project_id}/clusters/{cluster_id}/operation/precheck/tasks
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Details: Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Project IDs of the account Default value: N/A |
cluster_id |
Yes |
String |
Details: Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A |
Request Parameters
None
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
apiVersion |
String |
API version, which defaults to v3 |
kind |
String |
Type |
metadata |
Metadata object |
Basic information about the object. Metadata is a collection of attributes. |
items |
Array of PrecheckClusterTask objects |
Cluster check tasks |
Parameter |
Type |
Description |
---|---|---|
uid |
String |
Unique ID. |
name |
String |
Resource name |
labels |
Map<String,String> |
Resource labels in key-value pairs. This is a reserved field and does not take effect. |
annotations |
Map<String,String> |
Resource annotations in the format of key-value pairs. |
updateTimestamp |
String |
Update time. |
creationTimestamp |
String |
Creation time. |
Parameter |
Type |
Description |
---|---|---|
apiVersion |
String |
API version, which defaults to v3 |
kind |
String |
Resource type, which defaults to PreCheckTask |
metadata |
PrecheckTaskMetadata object |
Metadata of a pre-upgrade check task |
spec |
PrecheckCluserResponseSpec object |
Information of a pre-upgrade check task |
status |
PrecheckStatus object |
Status of a pre-upgrade check task |
Parameter |
Type |
Description |
---|---|---|
uid |
String |
Task ID |
creationTimestamp |
String |
Time when the task was created |
updateTimestamp |
String |
Time when the task was updated |
Parameter |
Type |
Description |
---|---|---|
clusterID |
String |
Cluster ID |
clusterVersion |
String |
Current cluster version |
targetVersion |
String |
Target version |
skippedCheckItemList |
Array of skippedCheckItemListResponse objects |
Skipped check items |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Name of the item that is skipped to be checked |
resourceSelector |
resourceSelectorResponse object |
Resource tag selector. This parameter is available only for node check, but not for cluster check or add-on check. |
Parameter |
Type |
Description |
---|---|---|
key |
String |
Tag key |
values |
Array of strings |
Tag value list |
operator |
String |
Tag value |
Parameter |
Type |
Description |
---|---|---|
phase |
String |
Status. Options:
|
expireTimeStamp |
String |
Check result expiration time |
message |
String |
Information, which typically indicates the log for execution errors |
clusterCheckStatus |
clusterCheckStatus object |
Status of a cluster restrictions check |
addonCheckStatus |
addonCheckStatus object |
Status of an add-on check |
nodeCheckStatus |
nodeCheckStatus object |
Node check status |
Parameter |
Type |
Description |
---|---|---|
phase |
String |
Status. Options:
|
itemsStatus |
Array of PreCheckItemStatus objects |
Compliance set by check item |
Parameter |
Type |
Description |
---|---|---|
phase |
String |
Status. Options:
|
itemsStatus |
Array of PreCheckItemStatus objects |
Compliance set by check item |
Parameter |
Type |
Description |
---|---|---|
phase |
String |
Status. Options:
|
nodeStageStatus |
Array of NodeStageStatus objects |
Node check status |
Parameter |
Type |
Description |
---|---|---|
nodeInfo |
NodeInfo object |
Node information |
itemsStatus |
Array of PreCheckItemStatus objects |
Compliance set by check item |
Parameter |
Type |
Description |
---|---|---|
uid |
String |
Node UID |
name |
String |
Node name |
status |
String |
Status |
nodeType |
String |
Node type |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Check item |
kind |
String |
Check item type. Options:
|
group |
String |
Check item group. Options:
|
level |
String |
Check item severity. Options:
|
phase |
String |
Status. Options:
|
message |
String |
Information |
riskSource |
riskSource object |
Risk item |
errorCodes |
Array of strings |
Error code set |
Parameter |
Type |
Description |
---|---|---|
configurationRisks |
Array of configurationRisks objects |
Configuration risk |
deprecatedAPIRisks |
Array of deprecatedAPIRisks objects |
Deprecated API risk |
nodeRisks |
Array of nodeRisks objects |
Node risk |
addonRisks |
Array of addonRisks objects |
Add-on risk |
Parameter |
Type |
Description |
---|---|---|
package |
String |
Component |
sourceFile |
String |
How to Obtain |
nodeMsg |
String |
Node information |
field |
String |
Parameter Value |
operation |
String |
Change an operation type. |
originalValue |
String |
Original Value |
value |
String |
Current Value |
Example Requests
None
Example Responses
Status code: 200
The list of pre-upgrade check tasks of a cluster is obtained.
{ "kind" : "List", "apiVersion" : "v3", "metadata" : { }, "items" : [ { "kind" : "PreCheckTask", "apiVersion" : "v3", "metadata" : { "uid" : "10b52d23-080a-4b7d-bf83-64b4687ca786", "creationTimestamp" : "2023-12-16 07:07:11.099111 +0000 UTC", "updateTimestamp" : "2023-12-16 07:09:10.425622 +0000 UTC" }, "spec" : { "clusterVersion" : "v1.23.5-r0", "targetVersion" : "v1.23.11-r0" }, "status" : { "phase" : "Failed", "clusterCheckStatus" : { "phase" : "Success", "itemsStatus" : [ { "name" : "DeprecatedApiCheck", "kind" : "Risk", "group" : "LimitCheck", "level" : "Info", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } }, { "name" : "BlackLimit", "kind" : "Exception", "group" : "LimitCheck", "level" : "Fatal", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } }, { "name" : "MasterSSH", "kind" : "Exception", "group" : "LimitCheck", "level" : "Fatal", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } }, { "name" : "ReleaseLimit", "kind" : "Exception", "group" : "LimitCheck", "level" : "Warning", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } }, { "name" : "ClusterNoArm", "kind" : "Exception", "group" : "LimitCheck", "level" : "Warning", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } } ] }, "addonCheckStatus" : { "phase" : "Failed", "itemsStatus" : [ { "name" : "AddonLimit", "kind" : "Exception", "group" : "AddonCheck", "level" : "Warning", "phase" : "Failed", "message" : "addon [ CoreDNS ] status is abnormal, check and try again", "riskSource" : { "addonRisks" : [ { "addonTemplateName" : "coredns", "alias" : "CoreDNS" } ] } }, { "name" : "CoreDNSConfLimit", "kind" : "Exception", "group" : "AddonCheck", "level" : "Fatal", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } }, { "name" : "EverestLimitHungVersion", "kind" : "Risk", "group" : "AddonCheck", "level" : "Fatal", "phase" : "Success", "message" : "check item succeed", "riskSource" : { } } ] }, "nodeCheckStatus" : { "phase" : "Success" } } } ] }
SDK Sample Code
The SDK sample code is as follows.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 |
package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.cce.v3.region.CceRegion; import com.huaweicloud.sdk.cce.v3.*; import com.huaweicloud.sdk.cce.v3.model.*; public class ListAutopilotPreCheckTasksSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); String projectId = "{project_id}"; ICredential auth = new BasicCredentials() .withProjectId(projectId) .withAk(ak) .withSk(sk); CceClient client = CceClient.newBuilder() .withCredential(auth) .withRegion(CceRegion.valueOf("<YOUR REGION>")) .build(); ListAutopilotPreCheckTasksRequest request = new ListAutopilotPreCheckTasksRequest(); request.withClusterId("{cluster_id}"); try { ListAutopilotPreCheckTasksResponse response = client.listAutopilotPreCheckTasks(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
# coding: utf-8 import os from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcce.v3.region.cce_region import CceRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcce.v3 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.environ["CLOUD_SDK_AK"] sk = os.environ["CLOUD_SDK_SK"] projectId = "{project_id}" credentials = BasicCredentials(ak, sk, projectId) client = CceClient.new_builder() \ .with_credentials(credentials) \ .with_region(CceRegion.value_of("<YOUR REGION>")) \ .build() try: request = ListAutopilotPreCheckTasksRequest() request.cluster_id = "{cluster_id}" response = client.list_autopilot_pre_check_tasks(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") projectId := "{project_id}" auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). WithProjectId(projectId). Build() client := cce.NewCceClient( cce.CceClientBuilder(). WithRegion(region.ValueOf("<YOUR REGION>")). WithCredential(auth). Build()) request := &model.ListAutopilotPreCheckTasksRequest{} request.ClusterId = "{cluster_id}" response, err := client.ListAutopilotPreCheckTasks(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } |
For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.
Status Codes
Status Code |
Description |
---|---|
200 |
The list of pre-upgrade check tasks of a cluster is obtained. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot