Creating a File System

Function

This API is used to create a file system.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For the specific permissions required, see Permissions Policies and Supported Actions.

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.
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 Host: example-sfs-01.sfs3.example.region.com:443 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