创建密钥

创建新密钥。 如果指定了 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

描述

用于接收新密钥的用户标识。

类型

字符串

示例

foo_user

必需

是

subuser

描述

用于接收新密钥的子用户标识。

类型

字符串

示例

sub_foo

必需

False

key-type

描述

要生成的密钥类型，选项为 :swift ， s3 (缺省值)。

类型

字符串

示例

s3

必需

False

access-key

描述

指定访问密钥。

类型

字符串

示例

AB01C2D3EF45G6H7IJ8K

必需

False

secret-key

描述

指定密钥。

类型

字符串

示例

0ab/CdeFGhij1klmnopqRSTUv1WxyZabcDEFgHij

必需

False

generate-key

描述

生成新的密钥对并添加到现有密钥环。

类型

布尔值

示例

是

必需

False

响应实体

keys

描述

已创建与此用户帐户关联的类型的密钥。

类型

容器

父代

不适用

user

描述

与密钥关联的用户帐户。

类型

字符串

父代

keys

access-key

描述

访问密钥。

类型

字符串

父代

keys

secret-key

描述

密钥。

类型

字符串

父代

keys

特殊错误响应

InvalidAccessKey

描述

指定的访问密钥无效。

代码

400 错误请求

InvalidKeyType

描述

指定的密钥类型无效。

代码

400 错误请求

InvalidSecretKey

描述

指定的密钥无效。

代码

400 错误请求

InvalidKeyType

描述

指定的密钥类型无效。

代码

400 错误请求

KeyExists

描述

提供的访问密钥已存在并且属于另一个用户。

代码

409 冲突