Go to main content

Oracle® ZFS Storage Appliance RESTful API 指南,发行版 OS8.8.x

退出打印视图

更新时间: 2021 年 8 月
 
 

创建用户

要创建新用户,必须至少提供一个用户名 (logname)。如果您未指定类型,则新用户的类型将为 local。其他属性是必需的(具体取决于用户的类型),如下面的用户类型列表中所述:

  • directory-用户名必须是现有的 NIS、LDAP 或 AD 用户。UID、密码和完整名称是从 NIS、LDAP 或 AD 拉取的。

  • localdata-指定用户名和密码。您可以指定 UID,否则系统将自动分配一个 UID。

  • nologin-指定用户名。您可以指定 UID,否则系统将自动分配一个 UID。

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

示例 1  创建本地用户

请求示例:

POST /api/user/v1/users HTTP/1.1

{
    "logname": "test_user",
    "initial_password": "password"
}

结果示例:

{
    "user":
    {
        "href": "/api/user/v1/users/test_user",
        "logname": "test_user",
        "type": "local",
        "uid": 2000000002,
        "fullname": "test_user",
        "initial_password": true,
        "require_annotation": false,
        "roles": ["basic"],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [],
        "preferences": {
            "href": "/api/user/v1/users/test_user/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "cli_idle_timeout": -1,
            "advanced_analytics": false,
            "keys": [],
            "tokens": []
        }
    }
}
示例 2  克隆用户

要创建与现有用户类型相同且分配了相同角色和授权的新用户,请指定以下属性:

  • user-要克隆的用户的用户名。

  • clonename-新克隆用户的用户名。

  • password-新克隆用户的初始密码。

请求示例:

POST /api/user/v1/users HTTP/1.1

{
    "user": "test_user",
    "clonename": "clone_user",
    "password": "password"
}

结果示例:

{
    "user":
    {
        "href": "/api/user/v1/users/clone_user",
        "logname": "clone_user",
        "type": "local",
        "uid": 2000000003,
        "fullname": "clone_user",
        "initial_password": true,
        "require_annotation": false,
        "roles": ["basic"],
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "exceptions": [],
        "preferences": {
            "href": "/api/user/v1/users/clone_user/preferences",
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "cli_idle_timeout": -1,
            "advanced_analytics": false,
            "keys": [],
            "tokens": []
        }
    }
}