2.9. 创建子用户

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

注意

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

功能

`users=write`

语法

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

请求参数

uid
描述
要创建子用户的用户 ID。
Type
字符串
示例
foo_user
必需
subuser
描述
指定要创建的子用户 ID。
Type
字符串
示例
sub_foo
必需
是(或 gen-subuser
gen-subuser
描述
指定要创建的子用户 ID。
Type
字符串
示例
sub_foo
必需
是(或 gen-subuser
secret-key
描述
指定 secret 密钥。
Type
字符串
示例
0AbCDEFg1h2i34JklM5nop6QrSTUV+WxyzaBC7D8
必需
key-type
描述
要生成的密钥类型,选项为:swift(默认)、s3。
Type
字符串
示例
swift [swift]
必需
access
描述
为子用户设置访问权限,应为 read, write, readwrite, full 之一。
Type
字符串
示例
读取
必需
generate-secret
描述
生成 secret 密钥。
Type
布尔值
示例
True [False]
必需

响应实体

子用户
描述
与用户帐户关联的子用户。
Type
Container
不适用
权限
描述
对用户帐户的子用户访问。
Type
字符串
子用户

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

特殊错误响应

SubuserExists
描述
存在指定的子用户。
代码
409 冲突
InvalidKeyType
描述
指定了无效的密钥类型。
代码
400 错误请求
InvalidSecretKey
描述
指定了无效的 secret key。
代码
400 错误请求
InvalidAccess
描述
指定了无效的子用户访问权限
代码
400 错误请求