
# 获取通用文件系统列表 - ListFileSystems
#### 功能介绍
获取通用文件系统列表。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### 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 | 用户所拥有的通用文件系统列表     |
   
 表3Owner 
| 参数 | 参数类型   | 描述                |
|:---|:---|:---|
| ID | String | 用户的DomainID（账号ID） |
   
 表4Buckets 
| 参数     | 参数类型                                                                                                     | 描述          |
|:---|:---|:---|
| Bucket | [Bucket] object | 具体的通用文件系统信息 |
   
 表5Bucket 
| 参数           | 参数类型   | 描述          |
|:---|:---|:---|
| 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>
      <BucketType>SFS</BucketType>
    </Bucket>
    <Bucket>
      <Name>examplebucket02</Name>
      <CreationDate>2018-06-22T03:56:33.700Z</CreationDate>
      <BucketType>SFS</BucketType>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | 成功响应消息样式，获取通用文件系统列表成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfs/sfs_02_0119.html)。
