文档首页/ 弹性文件服务 SFS/ API参考/ API说明/ 通用文件系统管理/ 创建通用文件系统 - CreateFileSystem
更新时间:2025-12-01 GMT+08:00
分享

创建通用文件系统 - CreateFileSystem

功能介绍

创建通用文件系统是指按照用户指定的通用文件系统名称创建一个新通用文件系统的操作。

  • 新创建文件系统的名称在SFS中必须是唯一的。如果是同一个用户重复创建同一区域的同名文件系统时将返回成功。除此以外的其他场景重复创建同名文件系统返回文件系统已存在。
  • 默认情况下,一个用户可以拥有的文件系统的数量不能超过100个。
  • 用户删除文件系统后,需要等待30分钟才能创建同名文件系统。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

PUT /

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

String

签名信息

Date

String

请求时间

x-obs-bucket-type

String

通过此消息头明确创建通用文件系统。 取值: SFS:创建通用文件系统。

Host

String

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

x-obs-epid

String

企业项目ID

表2 请求Body参数

参数

是否必选

参数类型

描述

Location

String

区域

响应参数

该请求的响应消息使用公共消息头,具体请参考 表1

响应消息体(可选)

响应消息体通常以结构化格式(如JSON或XML)返回,与响应消息头中Content-type对应,传递除响应消息头之外的内容。

请求示例

  • 在“cn-east-3”区域创建通用文件系统,主机地址是Host: example-sfs-01.sfs3.cn-east-3.myhuaweicloud.com:443,企业项目ID为“0”。
    PUT / HTTP/1.1
    Host: example-sfs-01.sfs3.cn-east-3.myhuaweicloud.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>cn-east-3</Location>
    </CreateBucketConfiguration>

响应示例

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

状态码

状态码

描述

200

创建通用文件系统成功

错误码

请参见错误码

相关文档