Help Center/ Cloud Container Engine/ API Reference/ APIs/ Node Management/ Migrating a Node

Updated on 2025-08-26 GMT+08:00

View PDF

Migrating a Node

Function

This API is used to migrate a node from a specified cluster to another cluster. The node can be migrated only between different clusters in the same VPC and project, and the cluster types before and after the migration must be the same.

BMS nodes in a CCE Turbo cluster cannot be migrated.

The URL for cluster management is in the format of https://Endpoint/uri, where uri indicates the resource path for API access.

Constraints

Nodes can be migrated only between clusters in the same VPC and project.
Nodes cannot be migrated between CCE Turbo clusters and CCE standard clusters.
Nodes cannot be migrated between DeC and non-DeC clusters.
Nodes cannot be migrated between clusters with IPv6 enabled and clusters without IPv6 enabled.
Nodes can be migrated only to the default node pool of the target cluster.
Nodes that have only one system disk attached cannot be migrated.
Physical ECS nodes in a CCE Turbo cluster cannot be migrated.

Calling Method

For details, see Calling APIs.

URI

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/migrateto/{target_cluster_id}

**Table 1** Path Parameters
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
target_cluster_id	Yes	String	Definition Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints N/A Range N/A Default Value N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Details: The request body type or format Constraints: The GET method is not verified. Options: application/json application/json;charset=utf-8 application/x-pem-file multipart/form-data (used when the FormData parameter is present) Default value: N/A
X-Auth-Token	Yes	String	Details: Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. Constraints: None Options: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
apiVersion	No	String	Definition API version Constraints The value is fixed and cannot be changed. Range N/A Default Value v3
kind	No	String	Definition API type Constraints The value is fixed and cannot be changed. Range N/A Default Value MigrateNodesTask
spec	Yes	MigrateNodesSpec object	Definition Configuration information Constraints N/A

**Table 4** MigrateNodesSpec
Parameter	Mandatory	Type	Description
os	Yes	String	Definition OS type, which must be accurate to the version number, for example, Huawei Cloud EulerOS 2.0. For details about the supported OSs, see Node OSs. Constraints If alpha.cce/NodeImageID is specified, the value of os must be the same as the OS of the private image. Range N/A Default Value N/A
extendParam	No	MigrateNodeExtendParam object	Definition Extended parameters for node migration Constraints N/A
login	No	Login object	Definition How to log in to a node. If this parameter is not specified, the password of the selected image will be kept. Ensure that you have set a password for the image. Constraints N/A
runtime	No	Runtime object	Definition Container runtime Constraints N/A
serverConfig	No	MigrateServerConfig object	Definition Server settings Constraints N/A
nodes	Yes	Array of NodeItem objects	Definition List of nodes to be migrated. A maximum of 200 nodes can be migrated at a time. Constraints N/A

**Table 5** MigrateNodeExtendParam
Parameter	Mandatory	Type	Description
maxPods	No	Integer	Definition The maximum number of pods that can be created on a node, including the default system pods. This limit prevents the node from being overloaded with pods. The number of pods that can be created on a node is determined by multiple parameters. For details, see Maximum Number of Pods That Can Be Created on a Node. Constraints N/A Range 16 to 256 Default Value N/A
DockerLVMConfigOverride	No	String	Definition Docker data disk configuration items. The disk type of the node to be migrated must match the disk type specified at node creation (that is, the value of diskType in DockerLVMConfigOverride must be the same as that specified during node creation). Ensure that the disk types of the nodes selected for a single API call are the same as those specified during the node creation. Example of the default configuration: "DockerLVMConfigOverride":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear" Constraints N/A Range The following fields are included: userLV: (Optional) size of the user space, for example, vgpaas/20%VG userPath (Optional): mount path of the user space, for example, /home/wqt-test diskType: disk type. Only evs, hdd, and ssd are supported. lvType: type of a logic volume. The value can be linear or striped. dockerThinpool: Docker space size, for example, vgpaas/60%VG kubernetesLV: kubelet space size, for example, vgpaas/20%VG Default Value N/A
alpha.cce/preInstall	No	String	Definition Pre-installation script Constraints The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. The input value must be encoded using Base64. The method is as follows: echo -n "<content-to-be-encoded>" \| base64 Range N/A Default Value N/A
alpha.cce/postInstall	No	String	Definition Post-installation script Constraints The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. The input value must be encoded using Base64. The method is as follows: echo -n "<content-to-be-encoded>" \| base64 Range N/A Default Value N/A
alpha.cce/NodeImageID	No	String	Definition ID of the user image used by the target OS. NOTE: If alpha.cce/NodeImageID is specified, the value of os must be the same as the OS of the private image. Constraints N/A Range N/A Default Value N/A

**Table 6** Login
Parameter	Mandatory	Type	Description
sshKey	No	String	Details: Name of the key pair used for login Constraints: None Options: N/A Default value: N/A
userPassword	No	UserPassword object	Details: Password used for node login Constraints: None
removeUserPassword	No	Boolean	Definition Whether to remove the password login setting of a node pool during the node pool update Constraints This parameter is supported only during node pool updates. If it is set to true, no user password can be specified. Range N/A Default Value false
removeSSHKey	No	Boolean	Definition Whether to remove the key pair login setting of a node pool during the node pool update Constraints This parameter is supported only during node pool updates. If it is set to true, no SSH key can be specified. Range N/A Default Value false

**Table 7** UserPassword
Parameter	Mandatory	Type	Description
username	No	String	Details: Login account. The default value is root. Constraints: None Options: N/A Default value: root
password	Yes	String	Details: Login password. If a username and password are used when a node is created, this field is shielded in the response body. Constraints: The password field must be salted during node creation. For details, see Adding a Salt in the password Field When Creating a Node. Options: A password must: Contain 8 to 26 characters. Contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters !@$%^-_=+[{}]:,./? Not contain the username or the username spelled backwards. Default value: N/A

**Table 8** Runtime
Parameter	Mandatory	Type	Description
name	No	String	Details: Container runtime Constraints: None Options: N/A Default value: Clusters earlier than v1.25: The default value is docker. Clusters of v1.25 or later: The default value varies with the OSs. For nodes running EulerOS 2.5 or EulerOS 2.8, the default value is docker. For nodes running other OSs, the default value is containerd.

**Table 9** MigrateServerConfig
Parameter	Mandatory	Type	Description
rootVolume	No	MigrateVolumeSpec object	Definition System disk reinstallation settings Constraints N/A

**Table 10** MigrateVolumeSpec
Parameter	Mandatory	Type	Description
cmkID	No	String	Details: User master key ID. NOTE: For details about how to obtain the key ID, see Querying the Key List. Constraints: None Options: N/A Default value: It is left empty by default, which indicates that the EVS disks are not encrypted.

**Table 11** NodeItem
Parameter	Mandatory	Type	Description
uid	Yes	String	Definition Node ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 12** Response body parameters
Parameter	Type	Description
apiVersion	String	Definition API version Constraints The value is fixed and cannot be changed. Range N/A Default Value v3
kind	String	Definition API type Constraints The value is fixed and cannot be changed. Range N/A Default Value MigrateNodesTask
spec	MigrateNodesSpec object	Definition Configuration information Constraints N/A
status	TaskStatus object	Definition Task status Constraints N/A

**Table 13** MigrateNodesSpec
Parameter	Type	Description
os	String	Definition OS type, which must be accurate to the version number, for example, Huawei Cloud EulerOS 2.0. For details about the supported OSs, see Node OSs. Constraints If alpha.cce/NodeImageID is specified, the value of os must be the same as the OS of the private image. Range N/A Default Value N/A
extendParam	MigrateNodeExtendParam object	Definition Extended parameters for node migration Constraints N/A
login	Login object	Definition How to log in to a node. If this parameter is not specified, the password of the selected image will be kept. Ensure that you have set a password for the image. Constraints N/A
runtime	Runtime object	Definition Container runtime Constraints N/A
serverConfig	MigrateServerConfig object	Definition Server settings Constraints N/A
nodes	Array of NodeItem objects	Definition List of nodes to be migrated. A maximum of 200 nodes can be migrated at a time. Constraints N/A

**Table 14** MigrateNodeExtendParam
Parameter	Type	Description
maxPods	Integer	Definition The maximum number of pods that can be created on a node, including the default system pods. This limit prevents the node from being overloaded with pods. The number of pods that can be created on a node is determined by multiple parameters. For details, see Maximum Number of Pods That Can Be Created on a Node. Constraints N/A Range 16 to 256 Default Value N/A
DockerLVMConfigOverride	String	Definition Docker data disk configuration items. The disk type of the node to be migrated must match the disk type specified at node creation (that is, the value of diskType in DockerLVMConfigOverride must be the same as that specified during node creation). Ensure that the disk types of the nodes selected for a single API call are the same as those specified during the node creation. Example of the default configuration: "DockerLVMConfigOverride":"dockerThinpool=vgpaas/90%VG;kubernetesLV=vgpaas/10%VG;diskType=evs;lvType=linear" Constraints N/A Range The following fields are included: userLV: (Optional) size of the user space, for example, vgpaas/20%VG userPath (Optional): mount path of the user space, for example, /home/wqt-test diskType: disk type. Only evs, hdd, and ssd are supported. lvType: type of a logic volume. The value can be linear or striped. dockerThinpool: Docker space size, for example, vgpaas/60%VG kubernetesLV: kubelet space size, for example, vgpaas/20%VG Default Value N/A
alpha.cce/preInstall	String	Definition Pre-installation script Constraints The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. The input value must be encoded using Base64. The method is as follows: echo -n "<content-to-be-encoded>" \| base64 Range N/A Default Value N/A
alpha.cce/postInstall	String	Definition Post-installation script Constraints The characters of both the pre-installation and post-installation scripts are centrally calculated, and the total number of characters after transcoding cannot exceed 10,240. The input value must be encoded using Base64. The method is as follows: echo -n "<content-to-be-encoded>" \| base64 Range N/A Default Value N/A
alpha.cce/NodeImageID	String	Definition ID of the user image used by the target OS. NOTE: If alpha.cce/NodeImageID is specified, the value of os must be the same as the OS of the private image. Constraints N/A Range N/A Default Value N/A

**Table 15** Login
Parameter	Type	Description
sshKey	String	Details: Name of the key pair used for login Constraints: None Options: N/A Default value: N/A
userPassword	UserPassword object	Details: Password used for node login Constraints: None
removeUserPassword	Boolean	Definition Whether to remove the password login setting of a node pool during the node pool update Constraints This parameter is supported only during node pool updates. If it is set to true, no user password can be specified. Range N/A Default Value false
removeSSHKey	Boolean	Definition Whether to remove the key pair login setting of a node pool during the node pool update Constraints This parameter is supported only during node pool updates. If it is set to true, no SSH key can be specified. Range N/A Default Value false

**Table 16** UserPassword
Parameter	Type	Description
username	String	Details: Login account. The default value is root. Constraints: None Options: N/A Default value: root
password	String	Details: Login password. If a username and password are used when a node is created, this field is shielded in the response body. Constraints: The password field must be salted during node creation. For details, see Adding a Salt in the password Field When Creating a Node. Options: A password must: Contain 8 to 26 characters. Contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters !@$%^-_=+[{}]:,./? Not contain the username or the username spelled backwards. Default value: N/A

**Table 17** Runtime
Parameter	Type	Description
name	String	Details: Container runtime Constraints: None Options: N/A Default value: Clusters earlier than v1.25: The default value is docker. Clusters of v1.25 or later: The default value varies with the OSs. For nodes running EulerOS 2.5 or EulerOS 2.8, the default value is docker. For nodes running other OSs, the default value is containerd.

**Table 18** MigrateServerConfig
Parameter	Type	Description
rootVolume	MigrateVolumeSpec object	Definition System disk reinstallation settings Constraints N/A

**Table 19** MigrateVolumeSpec
Parameter	Type	Description
cmkID	String	Details: User master key ID. NOTE: For details about how to obtain the key ID, see Querying the Key List. Constraints: None Options: N/A Default value: It is left empty by default, which indicates that the EVS disks are not encrypted.

**Table 20** NodeItem
Parameter	Type	Description
uid	String	Definition Node ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints N/A Range N/A Default Value N/A

**Table 21** TaskStatus
Parameter	Type	Description
jobID	String	Definition Job ID, which is used by the caller to query the job progress. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints N/A Range N/A Default Value N/A

Example Requests

Migrate a node running EulerOS 2.5 to another cluster.

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/migrateto/{target_cluster_id}

{
  "spec" : {
    "os" : "EulerOS 2.5",
    "login" : {
      "sshKey" : "KeyPair-001"
    },
    "nodes" : [ {
      "uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }, {
      "uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    } ]
  }
}

Migrate a node running EulerOS 2.5 and created using a specified image ID to another cluster.

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/migrateto/{target_cluster_id}

{
  "spec" : {
    "os" : "EulerOS 2.5",
    "extendParam" : {
      "alpha.cce/NodeImageID" : "cc697ad7-9563-11e8-8ea7-0255ac106311"
    },
    "login" : {
      "sshKey" : "KeyPair-001"
    },
    "nodes" : [ {
      "uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }, {
      "uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    } ]
  }
}

Example Responses

Status code: 200

The job for migrating a node from a specified cluster to another cluster is successfully delivered.

{
  "spec" : {
    "os" : "EulerOS 2.5",
    "login" : {
      "sshKey" : "KeyPair-001"
    },
    "runtime" : {
      "name" : "docker"
    },
    "nodes" : [ {
      "uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }, {
      "uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    } ],
    "serverConfig" : {
      "rootVolume" : {
        "cmkID" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  },
  "status" : {
    "jobID" : "2ec9b78d-9368-46f3-8f29-d1a95622a568"
  }
}

SDK Sample Code

The SDK sample code is as follows.

Migrate a node running EulerOS 2.5 to another cluster.

        
         
           
           
             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.*;

import java.util.List;
import java.util.ArrayList;

public class MigrateNodeSolution {

    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();
        MigrateNodeRequest request = new MigrateNodeRequest();
        request.withClusterId("{cluster_id}");
        request.withTargetClusterId("{target_cluster_id}");
        MigrateNodesTask body = new MigrateNodesTask();
        List<NodeItem> listSpecNodes = new ArrayList<>();
        listSpecNodes.add(
            new NodeItem()
                .withUid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
        );
        listSpecNodes.add(
            new NodeItem()
                .withUid("yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy")
        );
        Login loginSpec = new Login();
        loginSpec.withSshKey("KeyPair-001");
        MigrateNodesSpec specbody = new MigrateNodesSpec();
        specbody.withOs("EulerOS 2.5")
            .withLogin(loginSpec)
            .withNodes(listSpecNodes);
        body.withSpec(specbody);
        request.withBody(body);
        try {
            MigrateNodeResponse response = client.migrateNode(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());
        }
    }
}

            

          

        
       

Migrate a node running EulerOS 2.5 and created using a specified image ID to another cluster.

        
         
           
           
             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.*;

import java.util.List;
import java.util.ArrayList;

public class MigrateNodeSolution {

    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();
        MigrateNodeRequest request = new MigrateNodeRequest();
        request.withClusterId("{cluster_id}");
        request.withTargetClusterId("{target_cluster_id}");
        MigrateNodesTask body = new MigrateNodesTask();
        List<NodeItem> listSpecNodes = new ArrayList<>();
        listSpecNodes.add(
            new NodeItem()
                .withUid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
        );
        listSpecNodes.add(
            new NodeItem()
                .withUid("yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy")
        );
        Login loginSpec = new Login();
        loginSpec.withSshKey("KeyPair-001");
        MigrateNodeExtendParam extendParamSpec = new MigrateNodeExtendParam();
        extendParamSpec.withAlphaCceNodeImageID("cc697ad7-9563-11e8-8ea7-0255ac106311");
        MigrateNodesSpec specbody = new MigrateNodesSpec();
        specbody.withOs("EulerOS 2.5")
            .withExtendParam(extendParamSpec)
            .withLogin(loginSpec)
            .withNodes(listSpecNodes);
        body.withSpec(specbody);
        request.withBody(body);
        try {
            MigrateNodeResponse response = client.migrateNode(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());
        }
    }
}

            

          

        
       

Migrate a node running EulerOS 2.5 to another cluster.

        
         
           
           
             # 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 = MigrateNodeRequest()
        request.cluster_id = "{cluster_id}"
        request.target_cluster_id = "{target_cluster_id}"
        listNodesSpec = [
            NodeItem(
                uid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
            ),
            NodeItem(
                uid="yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
            )
        ]
        loginSpec = Login(
            ssh_key="KeyPair-001"
        )
        specbody = MigrateNodesSpec(
            os="EulerOS 2.5",
            login=loginSpec,
            nodes=listNodesSpec
        )
        request.body = MigrateNodesTask(
            spec=specbody
        )
        response = client.migrate_node(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

            

          

        
       

Migrate a node running EulerOS 2.5 and created using a specified image ID to another cluster.

        
         
           
           
             # 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 = MigrateNodeRequest()
        request.cluster_id = "{cluster_id}"
        request.target_cluster_id = "{target_cluster_id}"
        listNodesSpec = [
            NodeItem(
                uid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
            ),
            NodeItem(
                uid="yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
            )
        ]
        loginSpec = Login(
            ssh_key="KeyPair-001"
        )
        extendParamSpec = MigrateNodeExtendParam(
            alpha_cce_node_image_id="cc697ad7-9563-11e8-8ea7-0255ac106311"
        )
        specbody = MigrateNodesSpec(
            os="EulerOS 2.5",
            extend_param=extendParamSpec,
            login=loginSpec,
            nodes=listNodesSpec
        )
        request.body = MigrateNodesTask(
            spec=specbody
        )
        response = client.migrate_node(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

            

          

        
       

Migrate a node running EulerOS 2.5 to another cluster.

        
         
           
           
             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.MigrateNodeRequest{}
	request.ClusterId = "{cluster_id}"
	request.TargetClusterId = "{target_cluster_id}"
	var listNodesSpec = []model.NodeItem{
        {
            Uid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        },
        {
            Uid: "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
        },
    }
	sshKeyLogin:= "KeyPair-001"
	loginSpec := &model.Login{
		SshKey: &sshKeyLogin,
	}
	specbody := &model.MigrateNodesSpec{
		Os: "EulerOS 2.5",
		Login: loginSpec,
		Nodes: listNodesSpec,
	}
	request.Body = &model.MigrateNodesTask{
		Spec: specbody,
	}
	response, err := client.MigrateNode(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

            

          

        
       

Migrate a node running EulerOS 2.5 and created using a specified image ID to another cluster.

        
         
           
           
             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.MigrateNodeRequest{}
	request.ClusterId = "{cluster_id}"
	request.TargetClusterId = "{target_cluster_id}"
	var listNodesSpec = []model.NodeItem{
        {
            Uid: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        },
        {
            Uid: "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
        },
    }
	sshKeyLogin:= "KeyPair-001"
	loginSpec := &model.Login{
		SshKey: &sshKeyLogin,
	}
	alphaCceNodeImageIDExtendParam:= "cc697ad7-9563-11e8-8ea7-0255ac106311"
	extendParamSpec := &model.MigrateNodeExtendParam{
		AlphaCceNodeImageID: &alphaCceNodeImageIDExtendParam,
	}
	specbody := &model.MigrateNodesSpec{
		Os: "EulerOS 2.5",
		ExtendParam: extendParamSpec,
		Login: loginSpec,
		Nodes: listNodesSpec,
	}
	request.Body = &model.MigrateNodesTask{
		Spec: specbody,
	}
	response, err := client.MigrateNode(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

            

          

        
       