Function

This API is used to list file systems.

URI

GET /

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
x-obs-bucket-type	Yes	String	The header used to specify the content to be obtained. Enumerated value: SFS: listing all file systems
Authorization	Yes	String	The signature information.
Date	Yes	String	The request time.
Host	Yes	String	The host address.

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
Owner	Owner object	File system owner information, including the tenant ID.
Buckets	Buckets object	The list of file systems owned by the user.

**Table 3** Owner
Parameter	Type	Description
ID	String	The domain ID (account ID) of a user.

**Table 4** Buckets
Parameter	Type	Description
Bucket	Bucket object	Detailed file system information.

**Table 5** Bucket
Parameter	Type	Description
Name	String	The name of a file system.
CreationDate	String	The time when a file system was created.
Location	String	The location of a file system.

Example Request

GET / HTTP/1.1 
Host: sfs3.example.region.com
Date: date
x-obs-bucket-type: SFS
Authorization: authorization

Example Response

HTTP/1.1 200 OK
Server: OBS
X-Obs-Request-Id: 0000018893B8126DC048B06DD3816BD4
X-Obs-Id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCTMZh3Thi7lcDxuGWu9Qtp9PJbYXa7lb
Date: Wed, 07 Jun 2023 02:38:14 GMT
Content-Type: application/xml
Content-Length: 377

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListAllMyBucketsResult xmlns="http://obs.otc.t-systems.com/doc/2016-01-01/">
  <Owner>
    <ID>783fc6652cf246c096ea836694f71855</ID>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>examplebucket01</Name>
      <CreationDate>2018-06-21T09:15:01.032Z</CreationDate>
      <Location>example-region-1</Location>
      <BucketType>SFS</BucketType>
    </Bucket>
    <Bucket>
      <Name>examplebucket02</Name>
      <CreationDate>2018-06-22T03:56:33.700Z</CreationDate>
      <Location>example-region-2</Location>
      <BucketType>SFS</BucketType>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

Status Codes

Status Code	Description
200	The file systems are obtained.

Error Codes

See General Purpose File System Error Codes.

Listing File Systems

Function

URI

Request Parameters

Response Parameters

Example Request

Example Response

Status Codes

Error Codes