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