功能介绍
该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 |
表示在指定集群下移除节点的作业下发成功。 |
错误码
请参见错误码。