3.5.6. Swift 创建容器
若要创建新容器,请为 PUT
请求提供 API 版本、帐户和新容器的名称。容器名称必须是唯一的,不得包含正斜杠(/)字符,且应小于 256 字节。您可以在请求中包含访问控制标头和元数据标头。您还可以包含指定一组 PG 的密钥的存储策略。例如,执行 radosgw-admin zone get
以查看 placement_pools
下的可用键的列表。存储策略允许您为容器指定一组特殊的池,如基于 SSD 的存储。操作是幂等的。如果您请求创建已存在的容器,它会返回 HTTP 202 返回代码,但不会创建另一个容器。
语法
PUT /AP_VERSION/ACCOUNT/TENANT:CONTAINER HTTP/1.1 Host: FULLY_QUALIFIED_DOMAIN_NAME X-Auth-Token: AUTH_TOKEN X-Container-Read: COMMA_SEPARATED_UIDS X-Container-Write: COMMA_SEPARATED_UIDS X-Container-Meta-KEY:VALUE X-Storage-Policy: PLACEMENT_POOLS_KEY
名称 | 描述 | Type | 必需 |
---|---|---|---|
| 具有容器读取权限的用户 ID。 | 用户 ID 的以逗号分隔的字符串值。 | 否 |
| 具有容器写入权限的用户 ID。 | 用户 ID 的以逗号分隔的字符串值。 | 否 |
| 用户定义的 meta 数据键,它采用任意字符串值。 | 字符串 | 否 |
|
在 Ceph 对象网关的 | 字符串 | 否 |
如果容器已存在具有相同名称的容器,并且用户是容器所有者,则操作将成功。否则,操作将失败。
名称 | 描述 | 状态代码 |
---|---|---|
| 容器已存在于其他用户的所有权下。 |
|