2.5. 创建用户
				创建新用户。默认情况下,将自动创建 S3 密钥对并在响应中返回。如果只提供了 access-key 或 secret-key,则忽略的密钥会自动生成。默认情况下,生成的密钥会添加到密钥环中,而不替换现有的密钥对。如果指定了 access-key,并引用用户拥有的现有密钥,则会修改它。
			
功能
`users=write`
`users=write`
语法
PUT /admin/user?format=json HTTP/1.1 Host: FULLY_QUALIFIED_DOMAIN_NAME
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 开发人员指南。