创建用户

此命令使用三种形式：

• 创建新本地用户－创建新的本地用户

• 克隆现有用户－通过现有用户克隆新用户

• 添加管理员－需要使用网络用户名称设置 netuser 属性

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

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

表 14-5  创建新用户属性

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

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

表 14-6  克隆用户属性

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

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

表 14-7  网络用户属性

类型 属性名称 描述 字符串 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": {}
        }
    }
}