You need to enable JavaScript to run this app.
边缘智能

边缘智能

Copy page
节点管理
CreateNodeGroup - 创建节点组
Copy page
CreateNodeGroup - 创建节点组

调用本接口在指定边缘智能空间下创建一个节点组。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

CreateNodeGroup

要执行的操作,取值:CreateNodeGroup。

Version
String

2022-01-01

API的版本,取值:2022-01-01。

nodeGroupName
String

groupA

为节点组设置名称。
在同一个边缘智能空间下,节点组名称不允许重复。

projectID
String

p-2100001281-zf9ll

节点组所属边缘智能空间ID。

您可以调用ListProject接口获取所有边缘智能空间ID。

tags
Array of Object

为节点组绑定标签。

description
String

节点组A

为节点组添加描述信息。

返回参数

本接口无特有的返回参数。更多信息请见返回结构

请求示例

POST /?Action=CreateNodeGroup&Version=2022-01-01 HTTP/1.1
Host: vei-api.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250401T062527Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250401/cn-beijing/vei_api/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "nodeGroupName": "groupA",
  "projectID": "p-2100001281-zf9ll",
  "tags": [
    {
      "key": "env",
      "value": "test"
    }
  ],
  "description": "节点组A"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202504011424080211330891669D60F6",
    "Action": "CreateNodeGroup",
    "Version": "2022-01-01",
    "Service": "vei_api",
    "Region": "cn-beijing"
  },
  "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
90000015

The account is not authenticated by real name

账号未实名认证。

400
50010006

description is illegal

描述信息不正确。

500
90000009

Internal service errors

服务内部错误。

Last updated: 2025.10.23 10:47:27