创建通用文件系统 - CreateFileSystem
功能介绍
创建通用文件系统是指按照用户指定的通用文件系统名称创建一个新通用文件系统的操作。
- 新创建文件系统的名称在SFS中必须是唯一的。如果是同一个用户重复创建同一区域的同名文件系统时将返回成功。除此以外的其他场景重复创建同名文件系统返回文件系统已存在。
- 默认情况下,一个用户可以拥有的文件系统的数量不能超过100个。
- 用户删除文件系统后,需要等待30分钟才能创建同名文件系统。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
PUT /
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Authorization |
是 |
String |
签名信息 |
|
Date |
是 |
String |
请求时间 |
|
x-obs-bucket-type |
是 |
String |
通过此消息头明确创建通用文件系统。 取值: SFS:创建通用文件系统。 |
|
Host |
是 |
String |
表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 |
|
x-obs-epid |
否 |
String |
企业项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
创建通用文件系统成功 |
错误码
请参见错误码。