节点迁移MigrateNode_节点管理_云容器引擎API-华为云

华为云计算云知识节点迁移MigrateNode

普惠上云 2核2G2M云服务器

38元/年

云服务器秒杀 X实例-4核8G5M

338元/年

Flexus L实例 2核2G3M云服务器

68元/年

网站搭建买3年送2年

1元/天

节点迁移MigrateNode

时间: 2023-11-22 16:49:28

猜你想看：

实时语音识别云服务器配置 CDN是什么意思视频点播加速什么是云桌面

功能介绍

该API用于在指定集群下迁移节点到另一集群（仅支持在同一VPC、同一项目下的不同集群之间进行迁移，且迁移前后的集群类型需相同）。 CCE Turbo集群下弹性云服务 -物理机类型节点不支持迁移。

集群管理的URL格式为：https://Endpoint/uri。其中uri为资源路径，也即API访问的路径。

调用方法

请参见如何调用API。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方式请参见如何获取接口URI中参数。
cluster_id	是	String	集群ID，获取方式请参见如何获取接口URI中参数。
target_cluster_id	是	String	集群ID，获取方式请参见如何获取接口URI中参数。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	消息体的类型（格式）
X-Auth-Token	是	String	调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见获取token。

表3 请求Body参数
参数	是否必选	参数类型	描述
apiVersion	否	String	API版本，固定值“v3”。
kind	否	String	API类型，固定值“MigrateNodesTask”。
spec	是	MigrateNodesSpec object	配置信息
status	否	TaskStatus object	任务状态

表4 MigrateNodesSpec
参数	是否必选	参数类型	描述
os	是	String	操作系统类型，须精确到版本号。当指定“alpha.cce/NodeImageID”参数时，“os”参数必须和用户自定义镜像的操作系统一致。
extendParam	否	MigrateNodeExtendParam object	迁移节点时的扩展参数
login	是	Login object	节点的登录方式。密钥对和密码登录方式二者必选其一。
runtime	否	Runtime object	容器运行时
nodes	是	Array of NodeItem objects	待操作节点列表

表5 MigrateNodeExtendParam
参数	是否必选	参数类型
maxPods	否	Integer
DockerLVMConfigOverride	否	String
alpha.cce/preInstall	否	String
alpha.cce/postInstall	否	String
alpha.cce/NodeImageID	否	String

表6 Login
参数	是否必选	参数类型	描述
sshKey	否	String	选择密钥对方式登录时的密钥对名称。
userPassword	否	UserPassword object	选择密码方式登录时的帐号密码信息，之后可通过此帐号密码登录节点。

表7 UserPassword
参数	是否必选	参数类型	描述
username	否	String	登录帐号，默认为“root”
password	是	String	登录密码，若创建节点通过用户名密码方式，即使用该字段，则响应体中该字段作屏蔽展示。密码复杂度要求：长度为8-26位。密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三种。密码不能包含用户名或用户名的逆序。创建节点时password字段需要加盐加密，具体方法请参见创建节点时password字段加盐加密。

表8 Runtime
参数	是否必选	参数类型	描述
name	否	String	容器运行时，默认场景： v1.25以下集群：默认为" docker " v1.25及以上集群，随操作系统变化，默认的容器运行时不同：操作系统为EulerOS 2.5、EulerOS 2.8的节点默认为"docker"，其余操作系统的节点默认为"containerd"

表9 NodeItem
参数	是否必选	参数类型	描述
uid	是	String	节点ID

**表10** TaskStatus
参数	是否必选	参数类型	描述
jobID	否	String	任务ID，供调用者查询任务进度。

响应参数

状态码： 200

**表11** 响应Body参数
参数	参数类型	描述
apiVersion	String	API版本，固定值“v3”。
kind	String	API类型，固定值“MigrateNodesTask”。
spec	MigrateNodesSpec object	配置信息
status	TaskStatus object	任务状态

**表12** MigrateNodesSpec
参数	参数类型	描述
os	String	操作系统类型，须精确到版本号。当指定“alpha.cce/NodeImageID”参数时，“os”参数必须和用户自定义镜像的操作系统一致。
extendParam	MigrateNodeExtendParam object	迁移节点时的扩展参数
login	Login object	节点的登录方式。密钥对和密码登录方式二者必选其一。
runtime	Runtime object	容器运行时
nodes	Array of NodeItem objects	待操作节点列表

**表13** MigrateNodeExtendParam
参数	参数类型
maxPods	Integer
DockerLVMConfigOverride	String
alpha.cce/preInstall	String
alpha.cce/postInstall	String
alpha.cce/NodeImageID	String

**表14** Login
参数	参数类型	描述
sshKey	String	选择密钥对方式登录时的密钥对名称。
userPassword	UserPassword object	选择密码方式登录时的帐号密码信息，之后可通过此帐号密码登录节点。

**表15** UserPassword
参数	参数类型	描述
username	String	登录帐号，默认为“root”
password	String	登录密码，若创建节点通过用户名密码方式，即使用该字段，则响应体中该字段作屏蔽展示。密码复杂度要求：长度为8-26位。密码至少必须包含大写字母、小写字母、数字和特殊字符（!@$%^-_=+[{}]:,./?~#*）中的三种。密码不能包含用户名或用户名的逆序。创建节点时password字段需要加盐加密，具体方法请参见创建节点时password字段加盐加密。

**表16** Runtime
参数	参数类型	描述
name	String	容器运行时，默认场景： v1.25以下集群：默认为"docker" v1.25及以上集群，随操作系统变化，默认的容器运行时不同：操作系统为EulerOS 2.5、EulerOS 2.8的节点默认为"docker"，其余操作系统的节点默认为"containerd"

**表17** NodeItem
参数	参数类型	描述
uid	String	节点ID

**表18** TaskStatus
参数	参数类型	描述
jobID	String	任务ID，供调用者查询任务进度。

请求示例

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5。

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"
    } ]
  }
}

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5，并指定用户镜像ID。

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"
    } ]
  }
}

响应示例

状态码： 200

表示在指定集群下迁移节点至另一集群的作业下发成功。

{
  "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"
    } ]
  },
  "status" : {
    "jobID" : "2ec9b78d-9368-46f3-8f29-d1a95622a568"
  }
}

SDK代码示例

SDK代码示例如下。

Java
Python
Go
更多

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5。

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) {
        String ak = "<YOUR AK>";
        String sk = "<YOUR SK>";
        String projectId = "<project_id>";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        CceClient client = CceClient.newBuilder()
                .withCredential(auth)
                .withRegion(CceRegion.valueOf("cn-north-4"))
                .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());
        }
    }
}

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5，并指定用户镜像ID。

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) {
        String ak = "<YOUR AK>";
        String sk = "<YOUR SK>";
        String projectId = "<project_id>";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        CceClient client = CceClient.newBuilder()
                .withCredential(auth)
                .withRegion(CceRegion.valueOf("cn-north-4"))
                .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());
        }
    }
}

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5。

# coding: utf-8

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__":
    ak = "<YOUR AK>"
    sk = "<YOUR SK>"
    projectId = "<project_id>"

    credentials = BasicCredentials(ak, sk, projectId) \

    client = CceClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CceRegion.value_of("cn-north-4")) \
        .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)

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5，并指定用户镜像ID。

# coding: utf-8

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__":
    ak = "<YOUR AK>"
    sk = "<YOUR SK>"
    projectId = "<project_id>"

    credentials = BasicCredentials(ak, sk, projectId) \

    client = CceClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CceRegion.value_of("cn-north-4")) \
        .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)

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5。

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() {
    ak := "<YOUR AK>"
    sk := "<YOUR SK>"
    projectId := "<project_id>"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := cce.NewCceClient(
        cce.CceClientBuilder().
            WithRegion(region.ValueOf("cn-north-4")).
            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)
    }
}

迁移一个节点到另一个集群中，且节点操作系统为EulerOS 2.5，并指定用户镜像ID。

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() {
    ak := "<YOUR AK>"
    sk := "<YOUR SK>"
    projectId := "<project_id>"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := cce.NewCceClient(
        cce.CceClientBuilder().
            WithRegion(region.ValueOf("cn-north-4")).
            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)
    }
}

更多编程语言的SDK代码示例，请参见API Explorer的代码示例页签，可生成自动对应的SDK代码示例。

状态码

状态码	描述
200	表示在指定集群下迁移节点至另一集群的作业下发成功。

错误码

请参见错误码。

上一篇：查询失败任务列表ListFailureJobs 下一篇：路网数字化服务的功能

功能介绍

调用方法

URI

请求参数

响应参数

请求示例

响应示例

SDK代码示例

状态码

错误码

最新文章

更多内容

7*24

备案

专业服务

退订

建议反馈

售前咨询热线