UpdateHCI - 更新节点信息--边缘智能-火山引擎

文档中心

立即注册

导航

UpdateHCI - 更新节点信息

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

调用本接口更新节点信息，包括别名、描述、监控状态、标签等。

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateHCI	要执行的操作，取值：UpdateHCI。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
name	String	否	sxn012-bdvbaz	要操作的节点ID。
sn	String	否	L4V5********7SC1	要操作的节点序列号。
alias	String	否	nodeA	为节点设置别名。在同一个边缘智能项目下，节点别名不允许重复。
description	String	否	节点A	为节点添加描述。
monitor_status	Integer	否	1	为节点设置监控状态。该参数有以下取值： 0：关闭 1：开启 2：未就绪 3：已就绪
tags	Array of Object	否		为节点绑定标签。

返回参数

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

请求示例

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

{
  "name": "sxn012-bdvbaz",
  "sn": "L4V5********7SC1",
  "alias": "nodeA",
  "description": "节点A",
  "monitor_status": 1,
  "tags": [
    {
      "key": "env",
      "value": "test"
    }
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202504021046581621750640135613D1",
    "Action": "UpdateHCI",
    "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	50030015	the HCI account does not match	该节点不属于此账号。
400	50030003	alias already exists in the current project	当前边缘智能项目下已存在同名节点。
500	90000009	Internal service errors	服务内部错误。