创建用户

语言：

此命令使用三种形式：

创建新本地用户－创建新的本地用户
克隆现有用户－通过现有用户克隆新用户
添加管理员－需要使用网络用户名称设置 netuser 属性

在上述三种情况中，都会向用户发送 POST 请求，此请求的正文中包括 JSON 格式的属性。

“创建新本地用户”命令具有以下属性：

表 107 创建新用户属性

类型	属性名称	描述
字符串	logname	新用户的登录名（必需）
字符串	fullname	新用户的全名（必需）
字符串	initial_password	初始用户密码（必需）
布尔型	require_annotation	需要会话注释的可选标志

“克隆现有用户”命令具有以下必需的属性：

表 108 克隆用户属性

类型	属性名称	描述
字符串	user	源用户名
字符串	clonename	新的克隆登录名
字符串	fullname	新克隆用户的全名（仅本地）
布尔型	password	新克隆用户密码（仅本地）

“添加管理员”命令具有以下属性：

表 109 网络用户属性

类型	属性名称	描述
字符串	netuser	网络用户登录名

请求示例（创建本地用户）：

POST /api/user/v1/users HTTP/1.1
Authorization: Basic abcefgMWE=
Host: zfssa.example.com:215
Accept: application/json
Content-Type: application/json
Content-Length: 71

{"logname":"joe", "fullname":"Joe Admin", "initial_password":"letmein"}

结果示例：

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 386
Location: /api/user/v1/users/joe

{
    "user": {
        "href": "/api/user/v1/users",
        "logname": "joe",
        "fullname": "Joe Admin",
        "initial_password": "DummyPassword",
        "require_annotation": false,
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "roles": ["basic"],
        "exceptions": {},
        "preferences": {
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": {}
        }
    }
}