# 创建文件系统 - CreateShare #### 功能介绍 创建文件系统。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=CreateShare)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。 #### URI POST /v1/{project_id}/sfs-turbo/shares 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 账号的token | | Content-Type | 是 | String | MIME类型 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | share | 是 | [Share] object | 创建文件系统参数body | | bss_param | 否 | [BssInfo] object | 包周期付费模式，需要填写该参数 | 表4Share | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | availability_zone | 是 | String | 文件系统所在可用区（az）的编码 | | description | 否 | String | 文件系统描述信息，长度为0\~255。 | | enterprise_project_id | 否 | String | 创建文件系统时，给文件系统绑定的企业项目ID。 | | metadata | 否 | [Metadata] object | 创建文件系统的metadata信息，一到多个字典形式组织的键值对组成。 | | name | 是 | String | SFS Turbo文件系统的名称。长度为4\~64位，必须以字母开头，可以包含字母、数字、中划线、下划线，不能包含其他的特殊字符，不区分大小写。 | | security_group_id | 是 | String | 用户在某一区域下的安全组ID。 | | share_proto | 是 | String | - NFS（Network File System），即网络文件系统。一种使用于分散式文件系统的协议，通过网络让不同的机器、不同的操作系统能够彼此分享数据。Linux系统建议使用NFS协议类型的文件系统。 - CIFS（Common Internet File System），通用Internet文件系统，是一种网络文件系统访问协议。CIFS协议是SMB协议的方言（定义特定版本的协议的消息数据包集称为方言），CIFS协议也是公共的或开放的SMB协议版本，它使程序可以访问远程Internet计算机上的文件并要求此计算机提供服务。通过CIFS协议，可实现Windows系统主机之间的网络文件共享。CIFS类型的文件系统不支持使用Linux操作系统的云服务器进行挂载。Windows系统建议使用CIFS协议类型的文件系统。 | | share_type | 是 | String | 文件系统类型，有效值为STANDARD或者PERFORMANCE。当文件系统正在创建时，该字段不返回。 - SFS Turbo上一代文件系统规格类型：标准型和标准型增强版填写STANDARD，性能型和性能型增强版填写PERFORMANCE。 - 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/TiB：不校验该字段，填写STANDARD或者PERFORMANCE。 - HPC缓存型：不校验该字段，填写STANDARD或者PERFORMANCE。 | | size | 是 | Integer | - SFS Turbo上一代文件系统规格类型-文件系统容量：取值范围为500\~32768，单位为GiB。 - SFS Turbo上一代文件系统规格类型-增强版文件系统：在"metadata"字段中设置了expand_type="bandwidth"，则容量范围为10240\~327680，单位为GiB。 - 20MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="20M"，则容量范围为3686\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - 40MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="40M"，则容量范围为1228\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - 125MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="125M"，则容量范围为1228\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - 250MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="250M"，则容量范围为1228\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - 500MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="500M"，则容量范围为1228\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - 1000MB/s/TiB：在"metadata"字段中设置了expand_type="hpc"、hpc_bw="1000M"，则容量范围为1228\~1048576，单位为GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB-\>3686GiB，4.8TiB-\>4915GiB，8.4TiB-\>8601GiB。 - HPC缓存型文件系统：在"metadata"字段中设置了expand_type="hpc_cache"，则容量范围为4096\~1048576，单位为GiB。不同带宽，起步容量不一样，步长均为1TiB。如2GB/s带宽，起步容量为4TiB，即4096GiB；4GB/s带宽，起步容量为8TiB，即8192GiB；8GB/s带宽，起步容量为16TiB，即16384GiB。 | | subnet_id | 是 | String | 用户在VPC下面的子网的网络ID。 | | vpc_id | 是 | String | 用户在某一区域下的VPC ID。 | | backup_id | 否 | String | 备份ID，从备份创建文件系统时为必选。 | | tags | 否 | Array of [ResourceTag] objects | tag标签的列表。 | 表5Metadata | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | crypt_key_id | 否 | String | 要创加密文件系统，该字段传KMS服务专业版密钥的ID。 | | dedicated_flavor | 否 | String | 创专属文件系统，要创建的虚拟机的规格。 | | dedicated_storage_id | 否 | String | 创专属文件系统，要指定一个专属分布式存储的ID。 | | expand_type | 否 | String | 扩展类型；当文件系统正在创建时，该字段不返回。 枚举值： - bandwidth：创建增强型的文件系统，包括标准型-增强版和性能型-增强版，需要填写"bandwidth"。 - hpc：创建20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统，需要填写"hpc"。 - hpc_cache：创建HPC缓存型，需要填写"hpc_cache"。 | | hpc_bw | 否 | String | 文件系统的带宽规格。 创建20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型文件系统时，该参数必填。 20MB/s/TiB，填写"20M"。 40MB/s/TiB，填写"40M"。 125MB/s/TiB，填写"125M"。 250MB/s/TiB，填写"250M"。 500MB/s/TiB，填写"500M"。 1000MB/s/TiB，填写"1000M"。 HPC缓存型，填写"2G"、"4G"、"8G"、"16G"、"24G"、"32G"或"48G"。 | | auto_create_security_group_rules | 否 | String | 是否自动创建安全组规则。"true"表示自动创建安全组规则，"false"表示不自动创建安全组规则。默认值是"true"。 枚举值： - **true** - **false** | | vault_id | 否 | String | 存储库ID。 | 表6ResourceTag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | 标签的键。 最大长度128个字符。 key不能为空，不能包含非打印字符ASCII(0-31)，"=","\*","\<","\>","\\",",","\|","/"。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。 | | value | 是 | String | 标签的值。 每个值最大长度255个字符，可以为空字符串。 不能包含非打印字符ASCII(0-31)，"=","\*","\<","\>","\\",",","\|","/"。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。 | 表7BssInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | is_auto_renew | 否 | Long | 是否自动续费。0表示不自动续费，1表示自动续费。 枚举值： - **0** - **1** | | period_num | 是 | Long | 包周期订购的周期数 | | period_type | 是 | Long | 包周期的类型，可选包年或包月，2 表示包月，3 表示包年 枚举值： - **2** - **3** | | is_auto_pay | 否 | Long | 是否生成订单后自动扣款。0表示不自动扣款，1表示自动扣款。 枚举值： - **0** - **1** | #### 响应参数 **状态码：202** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 创建的SFS Turbo文件系统ID。 | | name | String | 创建的SFS Turbo文件系统名称。 | | status | String | SFS Turbo文件系统的状态。 枚举值： - 100：表示创建中。 | #### 请求示例 - SFS Turbo上一代文件系统规格类型：创建一个名称为"sfs-turbo-test"的SFS Turbo标准型文件系统，共享协议为NFS，容量为500GB，文件系统所在的可用区编码是example。安全组ID为"8c4ebbd0-6edf-4aae-8353-xxx"，子网的网络ID为"b8884abe-f47b-4917-9f6c-xxx"，VPC ID为"d651ea2b-2b20-4c6d-8bbf-xxx"。 ``` POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares { "share" : { "name" : "sfs-turbo-test", "availability_zone" : "example", "security_group_id" : "8c4ebbd0-6edf-4aae-8353-xxx", "share_proto" : "NFS", "share_type" : "STANDARD", "size" : 500, "subnet_id" : "b8884abe-f47b-4917-9f6c-xxx", "vpc_id" : "d651ea2b-2b20-4c6d-8bbf-xxx" } } ``` - SFS Turbo上一代文件系统规格类型+专属场景：创建一个名称为"sfs-turbo-dedicated-test"的SFS Turbo标准型文件系统，共享协议为NFS，容量为500GB，文件系统所在的可用区编码是example。指定专属的存储池id为"198f0704-xxx-4d85-xxx-c25caa4d3264"，专属的ecs规格为"c6.xlarge.2"，安全组ID为"8c4ebbd0-6edf-4aae-8353-xxx"，子网的网络ID为"b8884abe-f47b-4917-9f6c-xxx"，VPC ID为"d651ea2b-2b20-4c6d-8bbf-xxx"。 ``` POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares { "share" : { "name" : "sfs-turbo-dedicated-test", "availability_zone" : "example", "security_group_id" : "8c4ebbd0-6edf-4aae-8353-xxx", "share_proto" : "NFS", "share_type" : "STANDARD", "size" : 500, "subnet_id" : "b8884abe-f47b-4917-9f6c-xxx", "vpc_id" : "d651ea2b-2b20-4c6d-8bbf-xxx", "metadata" : { "dedicated_flavor" : "c6.xlarge.2", "dedicated_storage_id" : "198f0704-xxx-4d85-xxx-c25caa4d3264" } } } ``` - 125MB/s/TiB：创建一个名称为"sfs-turbo-test"的SFS Turbo 125MB/s/TiB 文件系统，共享协议为NFS，容量为3686GB，规格类型为125MB/s/TiB，文件系统所在的可用区编码是example。安全组ID为"8c4ebbd0-6edf-4aae-8353-xxx"，子网的网络ID为"b8884abe-f47b-4917-9f6c-xxx"，VPC ID为"d651ea2b-2b20-4c6d-8bbf-xxx"。 ``` POST HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares { "share" : { "name" : "sfs-turbo-test", "availability_zone" : "example", "security_group_id" : "8c4ebbd0-6edf-4aae-8353-xxx", "share_proto" : "NFS", "share_type" : "STANDARD", "size" : 3686, "subnet_id" : "b8884abe-f47b-4917-9f6c-xxx", "vpc_id" : "d651ea2b-2b20-4c6d-8bbf-xxx", "metadata" : { "expand_type" : "hpc", "hpc_bw" : "125M" } } } ``` #### 响应示例 **状态码：202** 创建请求下发成功返回body。 ``` { "id" : "708c017c-54b5-429a-a098-7692e23fa518", "name" : "sfs-turbo-test", "status" : "100" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 202 | 创建请求下发成功返回body。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。