2.5. 创建用户
创建新用户。默认情况下，将自动创建 S3 密钥对并在响应中返回。如果只提供了 access-key 或 secret-key，则忽略的密钥会自动生成。默认情况下，生成的密钥会添加到密钥环中，而不替换现有的密钥对。如果指定了 access-key，并引用用户拥有的现有密钥，则会修改它。
功能
`users=write`
语法
PUT /admin/user?format=json HTTP/1.1
Host: FULLY_QUALIFIED_DOMAIN_NAME
请求参数
uid- 描述
- 要创建的用户 ID。
- Type
- 字符串
- 示例
-
foo_user - 必需
- 是
display-name- 描述
- 要创建的用户的显示名称。
- Type
- 字符串
- 示例
-
foo_user - 必需
- 是
email- 描述
- 与用户关联的电子邮件地址。
- Type
- 字符串
- 示例
-
foo@bar.com - 必需
- 否
key-type- 描述
- 要生成的密钥类型，选项为：swift、s3（默认）。
- Type
- 字符串
- 示例
-
s3[s3] - 必需
- 否
access-key- 描述
- 指定访问密钥。
- Type
- 字符串
- 示例
-
ABCD0EF12GHIJ2K34LMN - 必需
- 否
secret-key- 描述
- 指定 secret 密钥。
- Type
- 字符串
- 示例
-
0AbCDEFg1h2i34JklM5nop6QrSTUV+WxyzaBC7D8 - 必需
- 否
user-caps- 描述
- 用户能力。
- Type
- 字符串
- 示例
-
usage=read, write; users=read - 必需
- 否
generate-key- 描述
- 生成新密钥对并添加到现有密钥环中。
- Type
- 布尔值
- 示例
- True [True]
- 必需
- 否
max-buckets- 描述
- 指定用户可以拥有的最大存储桶数。
- Type
- 整数
- 示例
- 500 [1000]
- 必需
- 否
suspended- 描述
- 指定是否应该暂停用户
- Type
- 布尔值
- 示例
- false [False]
- 必需
- 否
响应实体
user- 描述
- 指定是否应该暂停用户
- Type
- 布尔值
- 父
- 否
user_id- 描述
- 用户 ID。
- Type
- 字符串
- 父
-
user
display_name- 描述
- 显示用户的名称。
- Type
- 字符串
- 父
-
user
suspended- 描述
- 如果用户已被挂起，则为 true。
- Type
- 布尔值
- 父
-
user
max_buckets- 描述
- 用户所有的 bucket 的最大数量。
- Type
- 整数
- 父
-
user
子用户- 描述
- 与此用户帐户关联的子用户。
- Type
- Container
- 父
-
user
keys- 描述
- 与这个用户帐户关联的 S3 密钥。
- Type
- Container
- 父
-
user
swift_keys- 描述
- 与此用户帐户关联的 Swift 密钥。
- Type
- Container
- 父
-
user
caps- 描述
- 用户能力。
- Type
- Container
- 父
- 如果成功，响应将包含用户信息。
特殊错误响应
UserExists- 描述
- 尝试创建现有用户。
- 代码
- 409 冲突
InvalidAccessKey- 描述
- 指定无效的访问密钥。
- 代码
- 400 错误请求
InvalidKeyType- 描述
- 指定了无效的密钥类型。
- 代码
- 400 错误请求
InvalidSecretKey- 描述
- 指定了无效的 secret key。
- 代码
- 400 错误请求
KeyExists- 描述
- 提供的访问密钥存在，但属于另一用户。
- 代码
- 409 冲突
EmailExists- 描述
- 提供的电子邮件地址已存在。
- 代码
- 409 冲突
InvalidCap- 描述
- 尝试授予无效的 admin 功能。
- 代码
- 400 错误请求
其它资源
- 有关创建子用户，请参阅 Red Hat Ceph Storage 开发人员指南。
