Updated on 2024-11-13 GMT+08:00

Listing File Systems

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

This header field is 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 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.myhwclouds.com/doc/2015-06-30/">
  <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.