创建用户

语言：

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

此命令使用三种形式：

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

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

创建新用户属性

表 110 创建新用户属性

类型	属性名称	描述
string	logname	新用户的登录名（必需）
number	uid	可选用户 ID
string	fullname	新用户的全名（必需）
string	type	“本地”、“数据”、“禁止登录”（默认为“本地”）
string	initial_password	初始用户密码（仅“本地”和“数据”）
boolean	require_annotation	需要会话注释的可选标志（仅“本地”）

克隆用户属性

表 111 克隆用户属性

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

添加管理员属性

表 112 添加管理员属性

类型	属性名称	描述
string	type	目录用户
string	logname	目录用户登录名

示例 1 创建本地用户

请求示例：

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

{
    "type": "local",
    "logname": "john",
    "initial_password": "DummyPassword",
    "fullname": "John Doe"
}

结果示例：

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

示例 2 创建目录用户

请求示例：

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

结果示例：

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

示例 3 创建仅数据用户

请求示例：

POST /api/user/v1/users
{
    "type": "data",
    "logname": "john",
    "initial_password": "password",
    "fullname": "John Doe",
    "uid": 5000000
}

结果示例：

{
    "user": 
    {
        "href": "/api/user/v1/users/data",
        "logname": "john",
        "type": "data",
        "uid": 5000000,
        "fullname": "John Doe",
        "initial_password": "DummyPassword"
    }
}

示例 4 创建禁止登录用户

请求示例：

 
POST /api/user/v1/users
{
    "type": "nologin",
    "logname": "john",
    "fullname": "John Doe",
    "uid": 5000001
}

结果示例：

{
    "user": 
    {
        "href": "/api/user/v1/users/john",
        "logname": "john",
        "type": "nologin",
        "uid": 5000001,
        "fullname": "John Doe"
    }
}