ユーザーの作成

言語:

ユーザーやユーザータイプについてより深く理解するには、Oracle ZFS Storage Appliance 管理ガイド、Release OS8.8.0 のユーザーとロールについてを参照してください。

このコマンドは、次の 3 つの形式を使用します。

新規ユーザーの作成 – 新しいユーザーを作成します
既存のユーザーのクローン作成 – 既存のユーザーから新しいユーザーをクローン作成します
管理者の追加 – 企業ディレクトリ内で定義されているユーザーがアプライアンスを管理できるようにします。

3 つすべての場合において、本文での JSON 形式のプロパティーとともにユーザーへの POST リクエストが送信されます。

表 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"
    }
}