ModifyAccount

您可以使用 ModifyAccount 方法修改现有帐户。

当您锁定某个帐户时,来自该帐户的所有现有连接都将立即终止。当您更改某个帐户的 CHAP 设置时,所有现有连接都将保持活动状态,而后续连接或重新连接将使用新的 CHAP 设置。要清除帐户的属性,请为属性参数指定 {}。

参数

此方法具有以下输入参数:

名称 说明 类型 默认值 必需
accountID 要修改的帐户的帐户 ID。 整型
status

帐户状态:

active:帐户处于活动状态,允许连接。

locked:帐户处于锁定状态,拒绝连接。

字符串
initiatorSecret 用于启动程序的 CHAP 密钥。此密钥的长度必须为 12-16 个字符,且不可破解。启动程序 CHAP 密钥必须唯一,且不得与目标 CHAP 密钥相同。 字符串
targetSecret 用于目标的 CHAP 密钥(相互 CHAP 身份验证)。此密钥的长度必须为 12-16 个字符,且不可破解。目标 CHAP 密钥必须唯一,且不得与启动程序 CHAP 密钥相同。 字符串
attributes 名称-值对的列表,采用 JSON 对象格式。 JSON 对象
username 用于更改与帐户关联的用户名。(长度必须是 1 到 64 个字符。) 字符串

返回值

此方法没有返回值。

请求示例

此方法的请求类似于以下示例。在此示例中,通过为属性指定 {} 将其清除:

{
   "method": "ModifyAccount",
   "params": {
     "accountID" : 25,
     "status"   : "locked",
     "attributes" : {}
   },
   "id" : 1
}

响应示例

此方法返回类似于以下示例的响应:

{
 "id" : 1, 
 "result" : { }
}