ユーザーの作成

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

• 新規ローカルユーザーの作成 - 新しいローカルユーザーを作成します

• 既存のユーザーのクローン作成 - 既存のユーザーから新しいユーザーをクローン作成します

• 管理者の追加 - netuser プロパティーをネットワークユーザーの名前で設定する必要があります

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

新規ローカルユーザーの作成には、次のプロパティーがあります。

表 14-5  新規ユーザーの作成のプロパティー

型 プロパティー名 説明 string logname 新規ユーザーのログイン名 (必須) string fullname 新規ユーザーのフルネーム (必須) string initial_password 初期のユーザーパスワード (必須) boolean require_annotation セッションの注釈を必要とするオプションフラグです

既存のユーザーのクローン作成には、次の必須プロパティーがあります。

表 14-6  ユーザーのクローン作成プロパティー

型 プロパティー名 説明 string user ソースユーザー名 string clonename 新規クローンログイン名 string fullname 新規のクローンユーザーのフルネーム (ローカルのみ) boolean password 新規のクローンユーザーのパスワード (ローカルのみ)

管理者の追加には、次のプロパティーがあります。

表 14-7  ネットユーザーのプロパティー

型 プロパティー名 説明 string netuser ネットユーザーのログイン名

リクエストの例 (ローカルユーザーを作成する):

POST /api/user/v1/users HTTP/1.1
Authorization: Basic abcefgMWE=
Host: zfssa.example.com:215
Accept: application/json
Content-Type: application/json
Content-Length: 71

{"logname":"joe", "fullname":"Joe Admin", "initial_password":"letmein"}

結果例:

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 386
Location: /api/user/v1/users/joe

{
    "user": {
        "href": "/api/user/v1/users",
        "logname": "joe",
        "fullname": "Joe Admin",
        "initial_password": "DummyPassword",
        "require_annotation": false,
        "kiosk_mode": false,
        "kiosk_screen": "status/dashboard",
        "roles": ["basic"],
        "exceptions": {},
        "preferences": {
            "locale": "C",
            "login_screen": "status/dashboard",
            "session_timeout": 15,
            "advanced_analytics": false,
            "keys": {}
        }
    }
}