setLocation()

名称

setLocation - 修改节点的位置信息

语法

node.setLocation(<location>)

类别

SdbNode

描述

该函数用于修改当前节点的位置信息。

参数

location（ string，必填 ）

节点位置信息

• 位置信息的最大长度限制为 256 字节。
• 取值为空字符串时，表示删除当前节点的位置信息。

返回值

函数执行成功时，无返回值。

函数执行失败时，将抛异常并输出错误信息。

错误

setLocation() 函数常见异常如下：

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v3.6.1 及以上版本

示例

• 将节点 11820 的位置信息修改为"GuangZhou"

  > var node = db.getRG("group1").getNode("hostname", 11820)
  > node.setLocation("GuangZhou")

• 删除节点的位置信息

  > node.setLocation("")