2.6. 修改用户
修改现有用户。
功能
`users=write`
语法
POST /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
- 必需
- 否
generate-key
- 描述
- 生成新密钥对并添加到现有密钥环中。
- Type
- 布尔值
- 示例
- True [False]
- 必需
- 否
access-key
- 描述
- 指定访问密钥。
- Type
- 字符串
- 示例
-
ABCD0EF12GHIJ2K34LMN
- 必需
- 否
secret-key
- 描述
- 指定 secret 密钥。
- Type
- 字符串
- 示例
-
0AbCDEFg1h2i34JklM5nop6QrSTUV+WxyzaBC7D8
- 必需
- 否
key-type
- 描述
- 要生成的密钥类型,选项为:swift、s3(默认)。
- Type
- 字符串
- 示例
-
s3
- 必需
- 否
user-caps
- 描述
- 用户能力。
- Type
- 字符串
- 示例
-
usage=read, write; users=read
- 必需
- 否
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
- 父
- 如果成功,响应将包含用户信息。
特殊错误响应
InvalidAccessKey
- 描述
- 指定无效的访问密钥。
- 代码
- 400 错误请求
InvalidKeyType
- 描述
- 指定了无效的密钥类型。
- 代码
- 400 错误请求
InvalidSecretKey
- 描述
- 指定了无效的 secret key。
- 代码
- 400 错误请求
KeyExists
- 描述
- 提供的访问密钥存在,但属于另一用户。
- 代码
- 409 冲突
EmailExists
- 描述
- 提供的电子邮件地址已存在。
- 代码
- 409 冲突
InvalidCap
- 描述
- 尝试授予无效的 admin 功能。
- 代码
- 400 错误请求
其它资源
- 有关修改子用户,请参阅 Red Hat Ceph Storage 开发人员指南。