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