1.9. 创建子用户

创建一个新的子用户,主要用于使用 Swift API 的客户端。

注意

有效请求需要 gen-subusersubuser。通常,对于子用户非常有用,必须通过指定 访问 来授予权限。与用户创建一样,如果没有 secret 指定 子用户,则会自动生成 secret 密钥。

功能

`users=write`

语法

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

表 1.10. 请求参数

名称描述Type示例必需

uid

要创建子用户的用户 ID。

字符串

foo_user

subuser

指定要创建的子用户 ID。

字符串

sub_foo

是(或 gen-subuser

gen-subuser

指定要创建的子用户 ID。

字符串

sub_foo

是(或 子用户

secret-key

指定 secret 密钥。

字符串

0AbCDEFg1h2i34JklM5nop6QrSTUVWxyzaBC7D8

key-type

要生成的密钥类型,选项为:swift(默认)、s3。

字符串

swift [swift]

access

为子用户设置访问权限,应为 read, write, readwrite, full 之一。

字符串

读取

generate-secret

生成 secret 密钥。

布尔值

True [False]

表 1.11. 响应实体

名称描述Type

子用户

与用户帐户关联的子用户。

Container

不适用

id

子用户 ID。

字符串

子用户

权限

对用户帐户的子用户访问。

字符串

子用户

如果成功,响应包含子用户信息。

表 1.12. 特殊错误响应

名称描述代码

SubuserExists

存在指定的子用户。

409 冲突

InvalidKeyType

指定了无效的密钥类型。

400 错误请求

InvalidSecretKey

指定了无效的 secret key。

400 错误请求

InvalidAccess

指定了无效的子用户访问。

400 错误请求