文档首页/ 弹性文件服务 SFS/ API参考/ 通用文件系统API说明/ 文件共享/ 获取文件系统列表
更新时间：2025-09-17 GMT+08:00
查看PDF
分享

获取文件系统列表

功能介绍

获取文件系统列表

URI

GET /

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

x-obs-bucket-type

是

String

通过此消息头明确获取的列表内容。 取值： SFS：获取所有文件系统列表。

Authorization

是

String

签名信息

Date

是

String

请求时间

Host

是

String

表明主机地址。如sfs3.cn-north-4.myhuaweicloud.com。

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

Owner

Owner object

文件系统拥有者信息，包含租户ID

Buckets

Buckets object

用户所拥有的文件系统列表
表3 Owner

参数

参数类型

描述

ID

String

用户的DomainID（账号ID）
表4 Buckets

参数

参数类型

描述

Bucket

Bucket object

具体的文件系统信息
表5 Bucket

参数

参数类型

描述

Name

String

文件系统名称

CreationDate

String

文件系统的创建时间

Location

String

文件系统的位置信息

请求示例

GET / HTTP/1.1 
Host: sfs3.cn-north-4.myhuaweicloud.com
Date: date
x-obs-bucket-type: SFS
Authorization: authorization

响应示例

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>cn-north-4</Location>
      
      <BucketType>SFS</BucketType>
    </Bucket>
    <Bucket>
      <Name>examplebucket02</Name>
      <CreationDate>2018-06-22T03:56:33.700Z</CreationDate>
      <Location>cn-east-3</Location>
      
      <BucketType>SFS</BucketType>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

状态码

状态码

描述

200

成功响应消息样式，获取文件系统列表成功

错误码

请参见错误码。

父主题： 文件共享

相关文档