ユーザーの作成

言語:

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

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

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

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

新規ユーザーの作成のプロパティー

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