Updated on 2024-01-03 GMT+08:00

Creating a File System

Function

This API is used to create a file system.

URI

PUT /

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

Authorization

Yes

String

The signature information.

Date

Yes

String

The request time.

x-obs-az-redundancy

No

String

The AZ redundancy, single-AZ or multi-AZ.

x-obs-bucket-type

Yes

String

The header used to specify the file system creation.

Enumerated value:

  • SFS: creating a file system

Host

Yes

String

The host address.

x-obs-epid

No

String

The enterprise project ID.

Table 2 Request body parameter

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 and enterprise project ID 0):

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-epid: 0

<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.