功能介绍
该API用于在指定集群下移除节点。

集群管理的URL格式为:https://Endpoint/uri。其中uri为资源路径,也即API访问的路径。
调用方法
请参见如何调用API。
URI
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/remove
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见如何获取接口URI中参数。 |
cluster_id |
是 |
String |
集群ID,获取方式请参见如何获取接口URI中参数。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式) |
X-Auth-Token |
是 |
String |
调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
apiVersion |
否 |
String |
API版本,固定值“v3”。 |
kind |
否 |
String |
API类型,固定值“RemoveNodesTask”。 |
spec |
是 |
配置信息 |
|
status |
否 |
任务状态 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
sshKey |
否 |
String |
选择密钥对方式登录时的密钥对名称。 |
userPassword |
否 |
选择密码方式登录时的帐号密码信息,之后可通过此帐号密码登录节点。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
username |
否 |
String |
登录帐号,默认为“root” |
password |
是 |
String |
登录密码,若创建节点通过用户名密码方式,即使用该字段,则响应体中该字段作屏蔽展示。 密码复杂度要求:
|
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
apiVersion |
String |
API版本,固定值“v3”。 |
kind |
String |
API类型,固定值“RemoveNodesTask”。 |
spec |
配置信息 |
|
status |
任务状态 |
参数 |
参数类型 |
描述 |
---|---|---|
username |
String |
登录帐号,默认为“root” |
password |
String |
登录密码,若创建节点通过用户名密码方式,即使用该字段,则响应体中该字段作屏蔽展示。 密码复杂度要求:
|
请求示例
移除节点
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodes/operation/remove
{
"spec" : {
"login" : {
"sshKey" : "KeyPair-001"
},
"nodes" : [ {
"uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}, {
"uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
} ]
}
}
响应示例
状态码: 200
表示在指定集群下移除节点的作业下发成功。
{
"spec" : {
"login" : {
"sshKey" : "KeyPair-001"
},
"nodes" : [ {
"uid" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}, {
"uid" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
} ]
},
"status" : {
"jobID" : "2ec9b78d-9368-46f3-8f29-d1a95622a568"
}
}
SDK代码示例
SDK代码示例如下。
移除节点
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 RemoveNodeSolution {
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();
RemoveNodeRequest request = new RemoveNodeRequest();
request.withClusterId("<cluster_id>");
RemoveNodesTask body = new RemoveNodesTask();
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");
RemoveNodesSpec specbody = new RemoveNodesSpec();
specbody.withLogin(loginSpec)
.withNodes(listSpecNodes);
body.withSpec(specbody);
request.withBody(body);
try {
RemoveNodeResponse response = client.removeNode(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());
}
}
}
移除节点
# 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 = RemoveNodeRequest()
request.cluster_id = "<cluster_id>"
listNodesSpec = [
NodeItem(
uid="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
),
NodeItem(
uid="yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
)
]
loginSpec = Login(
ssh_key="KeyPair-001"
)
specbody = RemoveNodesSpec(
login=loginSpec,
nodes=listNodesSpec
)
request.body = RemoveNodesTask(
spec=specbody
)
response = client.remove_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)
移除节点
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.RemoveNodeRequest{}
request.ClusterId = "<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.RemoveNodesSpec{
Login: loginSpec,
Nodes: listNodesSpec,
}
request.Body = &model.RemoveNodesTask{
Spec: specbody,
}
response, err := client.RemoveNode(request)
if err == nil {
fmt.Printf("%+v\n", response)
} else {
fmt.Println(err)
}
}
更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。
状态码
状态码 |
描述 |
---|---|
200 |
表示在指定集群下移除节点的作业下发成功。 |
错误码
请参见错误码。