2.14. キーの作成

新しいキーを作成します。subuser を指定すると、デフォルトで作成されたキーは swift タイプになります。access-key または secret-key のいずれかのみが指定された場合、コミットされたキーは自動的に生成されます。secret-key のみが指定されている場合、access-key は自動的に生成されます。デフォルトでは、生成されたキーは、既存のキーペアを置き換えることなくキーリングに追加されます。access-key が指定され、ユーザーが所有する既存のキーを参照すると、そのキーは変更されます。レスポンスは、作成された鍵と同じタイプの鍵をすべて一覧表示するコンテナーです。

注記

swift キーの作成時に、access-key オプションを指定しても効果はありません。また、ユーザーまたはサブユーザーごとに 1 つの swift キーのみを保持することができます。

機能

`users=write`

構文

PUT /admin/user?key&format=json HTTP/1.1
Host FULLY_QUALIFIED_DOMAIN_NAME

リクエストパラメーター

uid
詳細
新しいキーを受け取るユーザー ID。
String
foo_user
必須
はい
subuser
詳細
新しいキーを受け取るサブユーザー ID。
String
sub_foo
必須
いいえ
key-type
詳細
生成されるキータイプ。オプションは swift、s3 (デフォルト) です。
String
s3 [s3]
必須
いいえ
access-key
詳細
アクセスキーを指定します。
String
AB01C2D3EF45G6H7IJ8K
必須
いいえ
secret-key
詳細
シークレットキーを指定します。
String
0ab/CdeFGhij1klmnopqRSTUv1WxyZabcDEFgHij
必須
いいえ
generate-key
詳細
新しいキーペアを生成し、既存のキーリングに追加します。
Boolean
True [True]
必須
いいえ

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

keys
詳細
このユーザーアカウントに関連付けられたタイプのキー。
Container
該当なし
user
詳細
キーに関連付けられたユーザーアカウント。
String
keys
access-key
詳細
アクセスキー。
String
keys
secret-key
詳細
シークレットキー。
String
keys

特別なエラーレスポンス

InvalidAccessKey
詳細
無効なアクセスキーが指定されている。
コード
400 Bad Request
InvalidKeyType
詳細
無効なキータイプが指定されている。
コード
400 Bad Request
InvalidSecretKey
詳細
無効なシークレットキーが指定されている。
コード
400 Bad Request
InvalidKeyType
詳細
無効なキータイプが指定されている。
コード
400 Bad Request
KeyExists
詳細
提供されたアクセスキーが存在し、別のユーザーに属している。
コード
409 Conflict