createAccount
您可以使用此方法创建用户账户并为其分配密码。
参数
|
参数 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
新账户的电子邮箱地址。 |
必填 |
字符串 |
无额外要求。 |
|
|
包含个人资料信息的对象。 |
必填 |
对象 |
参考
|
|
|
包含电话号码信息的对象。 |
可选 |
对象 |
参考
|
|
|
新账户的密码。 若省略此值，系统将生成密码并通过邮件发送给用户 |
可选 |
字符串 |
密码长度至少十二位，必须包含至少一个大写字母、一个小写字母、一个数字、一个特殊字符，且不能与之前使用过的密码相同。 |
|
|
要在其下创建用户的公司ID。 |
可选 |
字符串 |
若未指定，账户将关联至持有用于发送请求的API密钥的公司。 |
|
|
新账户的角色。 有关用户角色及相关权限的更多信息，请参阅 用户角色 |
可选 |
数字 |
可选值：
若将此参数赋值为
默认值：
|
|
|
包含用户账户权限的对象。
仅当
|
可选 |
对象 |
参见
|
|
|
表示用户账户需管理的目标ID列表。 |
可选 |
数组 |
无额外要求。 |
这些是公共API方法中通用的参数。
|
参数 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，将其与对应响应关联。 目标响应中会返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
发起请求所调用的方法名称。 |
必填 |
字符串 |
必须是有效的方法名。 |
|
|
请求与响应使用的JSON-RPC协议版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页上限为100条。
默认值：
|
对象
profile
|
名称 |
描述 |
包含在请求中 |
类型 |
|---|---|---|---|
|
|
用户全名。 |
必填 |
字符串 |
|
|
用户所在时区。 |
可选 |
字符串 |
|
|
在 GravityZone 控制台中显示的语言。 |
可选 |
字符串 |
电话号码
|
名称 |
描述 |
包含在请求中 |
类型 |
|---|---|---|---|
|
|
电话号码所在国家的前缀。 |
必填 |
字符串 |
|
|
不含前缀的电话号码。 |
必填 |
字符串 |
权限
|
名称 |
描述 |
包含在请求中 |
类型 |
|---|---|---|---|
|
|
允许用户创建、删除、暂停、管理客户公司的许可证和安全性。
默认值：
|
可选 |
布尔值 |
|
|
重要提示
该
提供以下网络安全设置的管理权限：
若设置为
如果存在
默认值：
|
可选 |
布尔值 |
|
|
允许用户创建、删除或编辑其所属公司的用户账户。
默认值：
|
可选 |
布尔值 |
|
|
允许用户创建、查看和编辑其所属公司的报告。
默认值：
|
可选 |
布尔值 |
|
|
授予用户编辑其公司资料设置及调整许可证的权限。
默认值：
|
可选 |
布尔值 |
|
|
允许用户在受管目标终端上启动远程Shell会话并执行高级取证操作。
若设置为
默认值：
|
可选 |
布尔值 |
|
|
提供对网络清单、任务、安装包和隔离项目的管理权限。
若请求中包含
默认值：
|
可选 |
布尔值 |
|
|
允许用户查看公司策略。
若请求中包含
默认值：
|
可选 |
布尔型 |
|
|
允许用户创建和编辑公司策略。
若该值设为
若存在
默认值：
|
可选 |
布尔型 |
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
所创建用户账户的ID。 |
示例
请求
{
"id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
"jsonrpc": "2.0",
"method": "createAccount",
"params": {
"email": "client@bitdefender.com",
"profile": {
"fullName": "Bitdefender用户",
"language": "en_US",
"timezone": "Europe/Bucharest"
},
"phoneNumber": {
"countryCode": "+40",
"subscriberNumber": "0000000000"
},
"password": "P@s4w0rd",
"role": 5,
"rights": {"companyManager": true,"manageInventory": true,
"managePoliciesRead": true,
"managePoliciesWrite": true,
"manageReports": true,
"manageUsers": false
},"companyId": "58541613aaed7090058b4567","targetIds": [
"585d2dc9aaed70820e8b45b4",
"585d2dd5aaed70b8048b45ca"
]
}
}
响应
{
"id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
"jsonrpc": "2.0",
"result": "585d2dc9aaed70820abc45b4"
}