跳至主内容

更新账户

此方法通过账户ID更新指定用户账户。

参数

参数	描述	包含于请求中	类型	取值
`accountId`	目标用户账户的ID。	必填	字符串	无额外要求。示例 "accountId" : "585d3d3faaed70970e8b45ed"
`email`	账户的电子邮件地址。	可选	字符串	必须符合有效电子邮件格式。示例 "email": "client@bitdefender.com"
`authenticationMethod`	用户登录所需的认证方式。	可选	整数	可选值： `0` - GravityZone 凭证 `1` - 身份提供者 `2` - GravityZone身份提供者示例 "email": "client@bitdefender.com"
`password`	账户密码。	可选	字符串	密码长度至少为十二个字符，且必须包含至少一个大写字母、一个小写字母、一个数字、一个特殊字符，并且不能与之前使用过的密码相同。示例 "password": "P@s4w0rd"
`profile`	包含个人资料信息的对象： `fullName` , `timezone` 和 `language` .	可选	对象	更多信息请参考 `profile` . 示例 "profile": { "fullName": "Bitdefender用户", "language": "en_US", "timezone": "Europe/Bucharest" }
`phoneNumber`	包含电话号码信息的对象	可选	对象	更多信息请参考 `phoneNumber` . 示例 "phoneNumber": { "countryCode": "+40", "subscriberNumber": "0000000000" }
`role`	用户的新角色。	可选	整数	以下是可用角色： `1` - 公司管理员。 `2` - 网络管理员。 `3` - 报告员。 `5` - 自定义。对于此角色，必须指定权限。示例 "role": 5
`rights`	包含用户账户权限的对象。仅当 `role` 参数值为 `5` - 自定义时，才应设置此对象。为其他角色设置时，这些值将被忽略，并替换为该角色特定的权限。	可选	对象	更多信息，请参考 `rights` . 示例 "权限": { "管理库存": true, "读取策略管理": true, "写入策略管理": true, "管理报告": true, "管理用户": false }
`目标ID`	表示用户账户需管理目标对象的ID列表。	可选	数组	无额外要求。示例 "目标ID": [ "585d2dc9aaed70820e8b45b4", "585d2dd5aaed70b8048b45ca" ]

对象

`个人资料`

参数	描述	请求包含项	类型	取值
全名	用户的姓名。	必填	字符串	无额外要求
语言	控制中心显示的语言。	必填	字符串	无额外要求
时区	用户所在的工作时区。	必填	字符串	无额外要求

`phoneNumber`

参数	描述	包含在请求中	类型	取值
`countryCode`	电话号码所属国家的前缀。	必填	整数	必须是有效的国家代码前缀。
`subscriberNumber`	不含前缀的电话号码。	必填	整数	必须是有效的电话号码格式。

`rights`

参数	描述	包含在请求中	类型	取值
`manageNetworks`	提供对网络安全设置的管理权限：网络清单策略任务安装包隔离区提示该 `manageNetworks` 属性已弃用。建议改用 `manageInventory` , `managePoliciesRead` 和 `managePoliciesWrite` 属性替代。若设为 `true` ，则 `manageReports` 权限会自动被赋予相同值。重要提示若存在 `manageNetworks` 属性，其值将自动赋给 `manageInventory` , `managePoliciesRead` 及 `managePoliciesWrite` 属性。若在同一请求中尝试为这三个键分配不同值将导致错误。	可选	布尔型	默认值： `false` .
`manageUsers`	允许用户为其所属公司创建、删除或编辑用户账户。	可选	布尔值	默认值： `false` .
`manageReports`	允许用户为其所属公司创建、查看和编辑报告。	可选	布尔值	默认值： `false` .
`companyManager`	允许用户编辑其公司资料设置并更改许可信息。	可选	布尔值	默认值： `false` .
`manageRemoteShell`	允许用户在管理的目标终端上启动远程Shell会话并执行高级取证操作。若设置为 `true` ，则 `manageNetworks` 属性将自动设为true。	可选	布尔值	默认值： `false` .
`manageInventory`	提供对网络清单、任务、安装包和隔离项目的管理权限。注意若请求中包含 `manageNetworks` 则不可包含此参数。	可选	布尔值	默认值： `false` .
`managePoliciesRead`	允许用户查看公司策略。注意若请求中包含 `manageNetworks` 则不可包含此参数。	可选	布尔值	默认值： `false` .
`managePoliciesWrite`	允许用户创建和编辑公司策略。若该值设为 `true` ，则必须同时将 `managePoliciesRead` 参数也必须设置为 `true` 。若未包含 `managePoliciesRead` 属性或为其分配其他值将导致错误。注意若存在 `manageNetworks` 则不得包含在请求中。	可选	布尔值	默认值： `false` .

返回值

此方法返回一个布尔值，当用户账户成功更新时为True。

示例

请求

{
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
       "jsonrpc": "2.0",
       "method": "updateAccount",
       "params": {
           "accountId" : "585d3d3faaed70970e8b45ed",
           "email": "client@bitdefender.com",
           "authenticationMethod" : 2,
           "profile": {
               "fullName":  "Bitdefender用户",
               "language": "en_US",
               "timezone": "Europe/Bucharest"
           },
           "phoneNumber": {
               "countryCode": "+40",
               "subscriberNumber": "0000000000"
           },
           "password": "P@s4w0rd",
           "role": 5,
           "rights": {
               
               "manageInventory": true,
               "managePoliciesRead": true,
               "managePoliciesWrite": true,
               "manageReports": true,
               "manageUsers": false
           },
           "targetIds": [
               "585d2dc9aaed70820e8b45b4",
               "585d2dd5aaed70b8048b45ca"
           ]
       }
  }

响应

{
   "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
   "jsonrpc": "2.0",
   "result": true
   }

本节内容 :

这有帮助吗？

您想提供反馈吗？点击此处即可建议修改。