2.9. 创建子用户
创建一个新的子用户,主要用于使用 Swift API 的客户端。
注意
有效请求需要 gen-subuser
或 subuser
。通常,对于子用户来说,要使子用户变得有用,必须通过指定 访问权限来授予权限
。与创建用户一样,如果在没有 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 错误请求