创建用户

语言：

要了解用户和用户类型的更多信息，请参见Oracle ZFS Storage Appliance 管理指南，发行版 OS8.8.0 中的了解用户和角色。

此命令使用三种形式：

创建新用户－创建新用户
克隆现有用户－通过现有用户克隆新用户
添加管理员－允许企业目录中定义的用户管理设备。

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

表 92 创建新用户属性

属性	类型	说明
`logname`	string	新用户的登录名（必需）
`uid`	number	可选用户 ID
`fullname`	string	新用户的全名（必需）
`type`	string	"local"、"data"、"nologin"（默认为 "local"）
`initial_password`	string	初始用户密码（仅 "local" 和 "data"）
`require_annotation`	boolean	需要会话注释的可选标志（仅 "local"）

表 93 克隆用户属性

属性	类型	说明
`user`	string	源用户名
`uid`	number	用户 ID，未为目录用户启用
`clonename`	string	新的克隆登录名
`fullname`	string	新克隆用户的全名（不适用于目录用户）
`password`	string	新克隆用户的密码（不适用于目录用户或禁止登录用户）

表 94 添加管理员属性

属性	类型	说明
`type`	string	目录用户
`logname`	string	目录用户登录名

示例 1 创建本地用户

请求示例：

POST /api/user/v1/users HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic abcdefghijklmnop
Content-type: application/json

{
    "type": "local",
    "logname": "admin3",
    "initial_password": "password",
    "fullname": "Administrator"
}

结果示例：

{
    "user":
    {
        "href": "/api/user/v1/users/admin3",
        "logname": "admin3",
        "type": "local",
        "uid": 2000000002,
        "fullname": "Administrator",
        "initial_password": "password",
        "require_annotation": false,
        "roles": [
            "basic"
        ],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [
        ],
        "preferences": {
            "href": "/api/user/v1/users/admin3/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": [
            ]
        }
    }
}

示例 2 创建目录用户

请求示例：

POST /api/user/v1/users
{
    "type": "directory",    
    "logname": "admin3" 
}

结果示例：

{
    "user":
    {
        "href": "/api/user/v1/users/admin3",
        "logname": "admin3",
        "type": "directory",
        "uid": 26718,
        "fullname": "Administrator",
        "require_annotation": false,
        "roles": [
            "basic"
        ],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [
        ],
        "preferences": {
            "href": "/api/user/v1/users/admin3/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": [
            ]
        }
    }
}

示例 3 创建仅数据用户

请求示例：

POST /api/user/v1/users
{
    "type": "data",
    "logname": "admin3",
    "initial_password": "password",
    "fullname": "Administrator",
    "uid": 5000000
}

结果示例：

{
    "user": 
    {
        "href": "/api/user/v1/users/data",
        "logname": "admin3",
        "type": "data",
        "uid": 5000000,
        "fullname": "Administrator",
        "initial_password": "password"
    }
}

示例 4 创建禁止登录用户

请求示例：

POST /api/user/v1/users
{
    "type": "nologin",
    "logname": "admin3",
    "fullname": "Administrator",
    "uid": 5000001
}

结果示例：

{
    "user": 
    {
        "href": "/api/user/v1/users/admin3",
        "logname": "admin3",
        "type": "nologin",
        "uid": 5000001,
        "fullname": "Administrator"
    }
}