文档首页/ 安全云脑 SecMaster/ API参考/ 安全云脑 API V1/ 节点管理/ 通过节点id删除节点 - DeleteNode
更新时间:2026-01-29 GMT+08:00
分享

通过节点id删除节点 - DeleteNode

功能介绍

删除节点

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

DELETE /v1/{project_id}/workspaces/{workspace_id}/nodes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

workspace_id

String

工作空间ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。获取用户Token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

delete_ids

Array of strings

节点ID列表

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

delete_fail_list

Array of Node objects

删除失败列表

delete_success_list

Array of Node objects

删除成功列表

表5 Node

参数

参数类型

描述

create_by

String

Iam用户ID

create_time

Integer

毫秒时间戳

description

IsapErrorRsp object

失败时返回的错误对象

device_type

String

设备类型

ip_address

String

IP地址

monitor

Monitor object

监视器

node_expansion

IsapNodeExpansion object

节点扩展信息

node_id

String

UUID

node_name

String

所属租户名称

os_type

String

操作系统类型

private_ip_address

String

IP地址

region

String

区域

specification

String

规格

subnet_id

String

子网ID

update_time

Integer

毫秒时间戳

vpc_endpoint_address

String

Vpc 端点地址

vpc_endpoint_id

String

Vpc 端点ID

vpc_id

String

UUID

vpcep_service_ip

String

IP地址

表6 IsapErrorRsp

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

表7 Monitor

参数

参数类型

描述

cpu_idle

String

CPU 空闲时间的百分比

cpu_usage

String

CPU 当前的使用率

disk_count

String

系统中磁盘设备的数量

disk_usage

String

当前磁盘空间使用量

down_pps

String

下载数据包每秒数量

health_status

String

参数解释:

节点的健康状态

  • NORMAL 正常

  • ANOMALIES 异常

  • FAULTS 故障

  • LOST_CONTACT 失联

约束限制

不涉及

取值范围:

  • NORMAL

  • ANOMALIES

  • FAULTS

  • LOST_CONTACT

默认值

不涉及

heart_beat

String

参数解释:

节点是否成功收到心跳信号

  • ONLINE 在线

  • OFFLINE 离线

约束限制

不涉及

取值范围:

  • ONLINE

  • OFFLINE

默认值

不涉及

heart_beat_time

Long

最后一次接收到心跳信号的时间

memory_cache

String

缓存数据的内存大小

memory_count

String

物理内存条数量

memory_free

String

当前空闲的物理内存量

memory_shared

String

多个进程共享使用的内存总量

memory_usage

String

已使用的物理内存量

mini_on_online

String

是否在线

read_rate

String

磁盘读取速率

up_pps

String

上传数据包每秒数量

write_rate

String

磁盘写入速率

表8 IsapNodeExpansion

参数

参数类型

描述

custom_label

String

自定义标签

data_center

String

数据中心

description

String

描述信息

maintainer

String

维护人

network_plane

String

网络平面

node_id

String

UUID

状态码:400

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

响应示例

SDK代码示例

SDK代码示例如下。

 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.secmaster.v1.region.SecMasterRegion;
import com.huaweicloud.sdk.secmaster.v1.*;
import com.huaweicloud.sdk.secmaster.v1.model.*;


public class DeleteNodeSolution {

    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);

        SecMasterClient client = SecMasterClient.newBuilder()
                .withCredential(auth)
                .withRegion(SecMasterRegion.valueOf("<YOUR REGION>"))
                .build();
        DeleteNodeRequest request = new DeleteNodeRequest();
        request.withWorkspaceId("{workspace_id}");
        try {
            DeleteNodeResponse response = client.deleteNode(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 huaweicloudsdksecmaster.v1.region.secmaster_region import SecMasterRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdksecmaster.v1 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 = SecMasterClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(SecMasterRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = DeleteNodeRequest()
        request.workspace_id = "{workspace_id}"
        response = client.delete_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)
 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"
    secmaster "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/secmaster/v1/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 := secmaster.NewSecMasterClient(
        secmaster.SecMasterClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.DeleteNodeRequest{}
	request.WorkspaceId = "{workspace_id}"
	response, err := client.DeleteNode(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

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

状态码

状态码

描述

200

成功

400

错误响应

错误码

请参见错误码

相关文档