Function
This API is used to create a file system with a specified name.
- A file system name must be unique in SFS. If a user repeatedly creates a file system with the same name as that of an existing file system in a given region, a success response is returned. In other cases, if a file system with the same name is repeatedly created, an error message will be returned, indicating that the file system already exists.
- By default, a user can have a maximum of 100 file systems.
- If a general purpose file system is deleted, you can create a new file system with the same name after at least 12 hours.
URI
PUT /
Request Parameters
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
Authorization |
Yes |
String |
The signature information. |
Date |
Yes |
String |
The request time. |
x-obs-az-redundancy |
Yes |
String |
When creating a file system, you must include this header, which sets the file system redundancy to 3AZ. Example: x-obs-az-redundancy:3az |
x-obs-bucket-type |
Yes |
String |
The header used to specify the file system creation. Enumerated value:
|
Host |
Yes |
String |
The host address. |
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
Location |
No |
String |
The region. |
Response Parameters
This response uses common headers. For details, see Table 1.
(Optional) Response Body
A response body contains information other than the response header. It is usually sent in a structured format (JSON or XML) defined by the response header parameter Content-type.
Example Request
Creating a file system in example (with the host address Host: example-sfs-01.sfs3.example.region.com:443):
PUT / HTTP/1.1
Host: example-sfs-01.sfs3.example.region.com:443
Date: Wed, 07 Jun 2023 02:38:09 GMT
x-obs-bucket-type: SFS
Authorization: OBS FNEX1B77SXDIB3TFMSZZ:0Xsnu4hJVOI7VWH0wIQczVN+rbg=
Content-Length: 85
x-obs-az-redundancy:3az
<CreateBucketConfiguration>
<Location>example</Location>
</CreateBucketConfiguration>
Example Response
HTTP/1.1 200 OK Server: OBS X-Obs-Request-Id: 0000018893B8058EC0470388BE6EDE88 Location: /example-sfs-01 X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCTRa4voOUvr50ncznQT/hligMxL4so2z Date: Wed, 07 Jun 2023 02:38:11 GMT Content-Length: 0
Status Codes
Status Code |
Description |
|---|---|
200 |
The file system is created. |