2.14. 创建密钥
创建新密钥。如果指定了 subuser，那么默认创建的密钥将是 swift 类型。如果只提供一个 access-key 或 secret-key，则会自动生成提交的密钥，如果只指定了 secret-key，则会自动生成 access-key。默认情况下，生成的密钥会添加到密钥环中，而不替换现有的密钥对。如果指定了 access-key，并引用用户拥有的现有密钥，则会修改它。响应是一个容器，它列出了与创建的密钥相同的所有类型。
注意
在创建 swift 密钥时，指定 access-key 选项将无效。另外，每个用户或子用户只能保留一个 swift 密钥。
功能
`users=write`
语法
PUT /admin/user?key&format=json HTTP/1.1
Host FULLY_QUALIFIED_DOMAIN_NAME
请求参数
uid- 描述
- 用于接收新密钥的用户 ID。
- Type
- 字符串
- 示例
-
foo_user - 必需
- 是
subuser- 描述
- 用于接收新密钥的子用户 ID。
- Type
- 字符串
- 示例
-
sub_foo - 必需
- 否
key-type- 描述
- 要生成的密钥类型，选项为：swift、s3（默认）。
- Type
- 字符串
- 示例
-
s3[s3] - 必需
- 否
access-key- 描述
- 指定访问密钥。
- Type
- 字符串
- 示例
-
AB01C2D3EF45G6H7IJ8K - 必需
- 否
secret-key- 描述
- 指定 secret 密钥。
- Type
- 字符串
- 示例
-
0ab/CdeFGhij1klmnopqRSTUv1WxyZabcDEFgHij - 必需
- 否
generate-key- 描述
- 生成新密钥对并添加到现有密钥环中。
- Type
- 布尔值
- 示例
-
True [
True] - 必需
- 否
响应实体
keys- 描述
- 与此用户帐户关联的类型密钥。
- Type
- Container
- 父
- 不适用
user- 描述
- 与密钥关联的用户帐户。
- Type
- 字符串
- 父
-
keys
access-key- 描述
- 访问密钥。
- Type
- 字符串
- 父
-
keys
secret-key- 描述
- secret 密钥。
- Type
- 字符串
- 父
-
keys
特殊错误响应
InvalidAccessKey- 描述
- 指定无效的访问密钥。
- 代码
- 400 错误请求
InvalidKeyType- 描述
- 指定了无效的密钥类型。
- 代码
- 400 错误请求
InvalidSecretKey- 描述
- 指定了无效的 secret key。
- 代码
- 400 错误请求
InvalidKeyType- 描述
- 指定了无效的密钥类型。
- 代码
- 400 错误请求
KeyExists- 描述
- 提供的访问密钥存在，但属于另一用户。
- 代码
- 409 冲突
