UpdateNodeGroup - 更新节点组--边缘智能-火山引擎

文档中心

立即注册

导航

UpdateNodeGroup - 更新节点组

最近更新时间：2025.04.22 15:34:59首次发布时间：2025.04.22 11:47:45

调用本接口更新节点组的信息，包括基本信息（如名称、标签、所属项目）、绑定的节点。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateNodeGroup	要执行的操作，取值：UpdateNodeGroup。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
nodeGroupID	String	否	ng-2100001281-rslq9	要操作的节点组ID。您可以调用ListNodeGroup接口获取所有节点组ID。
tags	Array of Object	否		为节点组绑定标签。
nodeNames	Array of String	否	["sxn012-bdvbaz"]	节点ID列表。若 `patchNode` 为 true，则指定的节点将被移入节点组。您可以调用ListHCINew接口获取指定边缘智能项目下的所有节点ID。
nodeGroupName	String	否	groupA	为节点组设置名称。在同一个边缘智能项目下，节点组名称不允许重复。
description	String	否	节点组A	为节点组添加描述信息。
projectID	String	否	p-2100001281-zf9ll	节点组所属边缘智能项目ID。您可以调用ListProject接口获取所有边缘智能项目ID。
patchNode	Boolean	否	true	是否将节点移入该节点组。默认值：false。

返回参数

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

请求示例

POST /?Action=UpdateNodeGroup&Version=2022-01-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250401T064704Z
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

{
  "nodeGroupID": "ng-2100001281-rslq9",
  "tags": [
    {
      "key": "env",
      "value": "test"
    }
  ],
  "nodeNames": [
    "sxn012-bdvbaz"
  ],
  "nodeGroupName": "groupA",
  "description": "节点组A",
  "projectID": "ng-2100001281-rslq9",
  "patchNode": true
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202504011448591450742510998656F4",
    "Action": "UpdateNodeGroup",
    "Version": "2022-01-01",
    "Service": "vei_api",
    "Region": "cn-beijing"
  },
  "Result": {}
}

错误码

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

状态码	错误码	错误信息	说明
400	90000015	The account is not authenticated by real name	账号未实名认证。
400	90000021	The account is not authorized to access project	越权访问其他账号下的项目。
400	90000025	The AI Gateway API Key is only allowed for verified enterprise account	仅支持企业认证账号创建边缘大模型网关密钥。
400	50030019	the tag invalid	标签不合法。
400	50030016	the tag key already exists	该标签键已存在。
500	90000009	Internal service errors	服务内部错误。