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
- Parent
- 該当なし
user- 説明
- キーに関連付けられたユーザーアカウント。
- 型
- String
- Parent
-
keys
access-key- 説明
- アクセスキー。
- 型
- String
- Parent
-
keys
secret-key- 説明
- シークレットキー。
- 型
- String
- Parent
-
keys
特別なエラーレスポンス
InvalidAccessKey- 説明
- 無効なアクセスキーが指定されている。
- コード
- 400 Bad Request
InvalidKeyType- 説明
- 無効なキータイプが指定されている。
- コード
- 400 Bad Request
InvalidSecretKey- 説明
- 無効なシークレットキーが指定されている。
- コード
- 400 Bad Request
InvalidKeyType- 説明
- 無効なキータイプが指定されている。
- コード
- 400 Bad Request
KeyExists- 説明
- 提供されたアクセスキーが存在し、別のユーザーに属している。
- コード
- 409 Conflict
