2.6. ユーザーの作成
新しいユーザーを作成します。デフォルトでは、S3 キーペアが自動的に作成され、レスポンスで返されます。access-key
または secret-key
のいずれかのみを指定すると、省略キーが自動的に生成されます。デフォルトでは、生成されたキーは、既存のキーペアを置き換えることなくキーリングに追加されます。access-key
が指定され、ユーザーが所有する既存のキーを参照すると、そのキーは変更されます。
ケイパビリティー
`users=write`
構文
PUT /admin/user?format=json HTTP/1.1
Host: FULLY_QUALIFIED_DOMAIN_NAME
リクエストパラメーター
uid
- 説明
- 作成されるユーザー ID。
- 型
- String
- 例
-
foo_user
- 必須
- はい
display-name
- 説明
- 作成するユーザーの表示名。
- 型
- String
- 例
-
foo_user
- 必須
- はい
email
- 説明
- ユーザーに関連付けられたメールアドレス。
- 型
- String
- 例
-
foo@bar.com
- 必須
- いいえ
key-type
- 説明
- 生成されるキータイプ。オプションは swift、s3 (デフォルト) です。
- 型
- String
- 例
-
s3
[s3
] - 必須
- いいえ
access-key
- 説明
- アクセスキーを指定します。
- 型
- String
- 例
-
ABCD0EF12GHIJ2K34LMN
- 必須
- いいえ
secret-key
- 説明
- シークレットキーを指定します。
- 型
- String
- 例
-
0AbCDEFg1h2i34JklM5nop6QrSTUV+WxyzaBC7D8
- 必須
- いいえ
user-caps
- 説明
- ユーザー機能。
- 型
- String
- 例
-
usage=read, write; users=read
- 必須
- いいえ
generate-key
- 説明
- 新しいキーペアを生成し、既存のキーリングに追加します。
- 型
- Boolean
- 例
- True [True]
- 必須
- いいえ
max-buckets
- 説明
- ユーザーが所有できるバケットの最大数を指定します。
- 型
- 整数
- 例
- 500 [1000]
- 必須
- いいえ
suspended
- 説明
- ユーザーが一時停止するかどうかを指定します。
- 型
- Boolean
- 例
- False [False]
- 必須
- いいえ
レスポンスエンティティー
user
- 説明
- ユーザーが一時停止するかどうかを指定します。
- 型
- Boolean
- Parent
- いいえ
user_id
- 説明
- ユーザー ID。
- 型
- String
- Parent
-
user
display_name
- 説明
- ユーザーの表示名。
- 型
- String
- Parent
-
user
suspended
- 説明
- ユーザーが一時停止してきる場合は True。
- 型
- Boolean
- Parent
-
user
max_buckets
- 説明
- ユーザーが所有するバケットの最大数。
- 型
- 整数
- Parent
-
user
subusers
- 説明
- このユーザーアカウントに関連付けられたサブユーザー。
- 型
- Container
- Parent
-
user
keys
- 説明
- このユーザーアカウントに関連付けられた S3 キー。
- 型
- Container
- Parent
-
user
swift_keys
- 説明
- このユーザーアカウントに関連付けられた Swift 鍵。
- 型
- Container
- Parent
-
user
caps
- 説明
- ユーザー機能。
- 型
- Container
- Parent
- 成功すると、応答にはユーザー情報が含まれます。
特別なエラーレスポンス
UserExists
- 説明
- 既存ユーザーの作成を試行。
- コード
- 409 Conflict
InvalidAccessKey
- 説明
- 無効なアクセスキーが指定されている。
- コード
- 400 Bad Request
InvalidKeyType
- 説明
- 無効なキータイプが指定されている。
- コード
- 400 Bad Request
InvalidSecretKey
- 説明
- 無効なシークレットキーが指定されている。
- コード
- 400 Bad Request
KeyExists
- 説明
- 提供されたアクセスキーが存在し、別のユーザーに属している。
- コード
- 409 Conflict
EmailExists
- 説明
- 提供されるメールアドレスが存在する。
- コード
- 409 Conflict
InvalidCap
- 説明
- 無効な管理者機能の付与を試行。
- コード
- 400 Bad Request
関連情報
- サブユーザーの作成は、Red Hat Ceph Storage 開発者ガイド を参照してください。