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
詳細
ユーザーが所有できるバケットの最大数を指定します。
Integer
500 [1000]
必須
いいえ
suspended
詳細
ユーザーが一時停止するかどうかを指定します。
Boolean
False [False]
必須
いいえ

レスポンスエンティティー

user
詳細
ユーザーが一時停止するかどうかを指定します。
Boolean
いいえ
user_id
詳細
ユーザー ID。
String
user
display_name
詳細
ユーザーの表示名。
String
user
suspended
詳細
ユーザーが一時停止してきる場合は True。
Boolean
user
max_buckets
詳細
ユーザーが所有するバケットの最大数。
Integer
user
subusers
詳細
このユーザーアカウントに関連付けられたサブユーザー。
Container
user
keys
詳細
このユーザーアカウントに関連付けられた S3 キー。
Container
user
swift_keys
詳細
このユーザーアカウントに関連付けられた Swift 鍵。
Container
user
caps
詳細
ユーザー機能。
Container
成功すると、応答にはユーザー情報が含まれます。

特別なエラーレスポンス

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

関連情報