创建文件系统 - CreateShare

project_id

是

String

参数解释：

项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

用户Token，用于鉴权认证。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

请求消息体MIME类型，用于标识请求正文的数据格式。

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

share

是

Share object

参数解释：

创建文件系统的请求参数结构体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

bss_param

否

BssInfo object

参数解释：

包周期付费模式需要填写该参数，包含订购周期、自动续费、自动扣款等包周期计费相关拓展参数。

约束限制：

仅包周期计费场景下需传入，按需计费无需配置该参数。

取值范围：

不涉及。

默认取值：

不涉及。

availability_zone

是

String

参数解释：

文件系统所在可用区（AZ）的编码。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

文件系统描述信息。

约束限制：

长度为0~255的字符串。

取值范围：

不涉及。

默认取值：

不涉及。

enterprise_project_id

否

String

参数解释：

创建SFS Turbo文件系统时，给文件系统绑定的企业项目ID。

关于企业项目ID的获取及企业项目特性的详细信息，请参考查询企业项目列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

metadata

否

Metadata object

参数解释：

文件系统扩展元数据配置集合，以键值对形式组织，用于传递加密密钥、扩展类型、专属部署规格等文件系统进阶属性。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

SFS Turbo文件系统的名称。

约束限制：

• 同区域且同账号内名称需唯一。

• 删除文件系统后，立即创建同名文件系统会创建失败，需要等待30分钟才能创建。

• 只能由英文字母、数字、下划线和中划线组成，并以字母开头，不区分大小写。

• 长度为4~64的字符串。

取值范围：

不涉及。

默认取值：

不涉及。

security_group_id

是

String

参数解释：

用户在当前区域下的安全组ID。

约束限制：

安全组需放通文件系统对应的NFS/CIFS协议端口，否则会导致挂载失败。

取值范围：

不涉及。

默认取值：

不涉及。

share_proto

是

String

参数解释：

文件系统的共享协议类型，包括NFS（Network File System）网络文件系统和CIFS（Common Internet File System）通用Internet文件系统两种协议。其中CIFS协议是SMB协议的方言（定义特定版本的协议的消息数据包集称为方言）。

约束限制：

• NFS协议适用于Linux系统挂载。

• CIFS协议适用于Windows系统挂载，不支持Linux云服务器挂载。

取值范围：

• NFS：网络文件系统协议。

• CIFS：通用Internet文件系统协议。

默认取值：

不涉及。

share_type

是

String

参数解释：

SFS Turbo文件系统的性能规格类型，用于标识文件系统的性能等级与所属规格系列，不同规格对应不同的带宽、时延等存储性能表现。

约束限制：

不涉及。

取值范围：

• STANDARD：表示标准型、标准型-增强版、20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型等类型的文件系统。

• PERFORMANCE：表示性能型、性能型-增强版、20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型等类型的文件系统。

• 100MB/s/TiB-智算型：填写aits.100M。

• 200MB/s/TiB-智算型：填写aits.200M。

默认取值：

不涉及。

size

是

Integer

参数解释：

文件系统容量，单位为GiB。

约束限制：

不同规格类型需搭配对应metadata参数，部分类型容量需按指定基数取整。

取值范围：

• 标准型、性能型：取值范围为500~32768GiB。

• 标准型增强版、性能型增强版文件系统：在metadata字段中设置了expand_type="bandwidth"，则容量范围为10240~327680GiB。

• 20MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="20M"，则容量范围为3686~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• 40MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="40M"，则容量范围为1228~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• 125MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="125M"，则容量范围为1228~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• 250MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="250M"，则容量范围为1228~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• 500MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="500M"，则容量范围为1228~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• 1000MB/s/TiB：在metadata字段中设置了expand_type="hpc"、hpc_bw="1000M"，则容量范围为1228~1048576GiB。容量必须为1.2TiB的倍数，换算为GiB后需要向下取整。如3.6TiB向下取整为3686GiB，4.8TiB向下取整为4915GiB，8.4TiB向下取整为8601GiB。

• HPC缓存型文件系统：在metadata字段中设置了expand_type="hpc_cache"，则容量范围为4096~1048576GiB。不同带宽，起步容量不一样，步长均为1TiB。如2GB/s带宽，起步容量为4TiB，即4096GiB；4GB/s带宽，起步容量为8TiB，即8192GiB；8GB/s带宽，起步容量为16TiB，即16384GiB。

• 100MB/s/TiB-智算型：在share_type字段中设置了"aits.100M"，则容量范围为532480~27262976GiB。容量必须为106496GiB，即104TiB的倍数。

• 200MB/s/TiB-智算型：在share_type字段中设置了"aits.200M"，则容量范围为532480~27262976GiB。容量必须为106496GiB，即104TiB的倍数。

默认取值：

不涉及。

subnet_id

是

String

参数解释：

文件系统所在VPC下的子网网络ID。

约束限制：

子网需与文件系统在同一可用区，创建单个SFS Turbo至少预留21个空闲可用IP。

取值范围：

不涉及。

默认取值：

不涉及。

vpc_id

是

String

参数解释：

用户在当前区域下的VPC ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

backup_id

否

String

参数解释：

备份ID，用于从备份创建文件系统。可通过云备份服务的查询所有备份接口获取备份ID。

约束限制：

从备份创建文件系统时该参数为必选。

取值范围：

不涉及。

默认取值：

不涉及。

tags

否

Array of ResourceTag objects

参数解释：

使用同一标签标识多种云资源，即所有服务均可在标签输入框下拉选择同一标签。

约束限制：

单个文件系统最多可以创建20个标签，标签的key需要唯一，重复的key会做去重操作。

取值范围：

不涉及。

默认取值：

不涉及。

crypt_key_id

否

String

参数解释：

KMS服务专业版密钥ID，用于创建加密文件系统。详细信息请参考密码管理概述。

约束限制：

需确保当前账号具备该密钥的使用权限。

取值范围：

不涉及。

默认取值：

不涉及。

dedicated_flavor

否

String

参数解释：

专属文件系统对应的虚拟机规格。

约束限制：

创建专属文件系统时为必选，需与专属存储池规格匹配。

取值范围：

不涉及。

默认取值：

不涉及。

dedicated_storage_id

否

String

参数解释：

创建专属文件系统时，需指定专属分布式存储的ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

expand_type

否

String

参数解释：

扩展类型。当文件系统正在创建时，该字段不返回。

约束限制：

不涉及。

取值范围：

• bandwidth：表示标准型-增强版、性能型-增强版等类型。

• hpc：表示20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB等类型。

• hpc_cache：表示HPC缓存型。

默认取值：

不涉及。

hpc_bw

否

String

参数解释：

HPC型文件系统的带宽规格。

约束限制：

创建20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、HPC缓存型等类型的文件系统时，该参数必填。

取值范围：

• 20M：表示20MB/s/TiB。

• 40M：表示40MB/s/TiB。

• 125M：表示125MB/s/TiB。

• 250M：表示250MB/s/TiB。

• 500M：表示500MB/s/TiB。

• 1000M：表示1000MB/s/TiB。

• 2G、4G、8G、16G、24G、32G或48G：表示HPC缓存型。

默认取值：

不涉及。

auto_create_security_group_rules

否

String

参数解释：

是否自动创建安全组规则。

约束限制：

设置为true时，系统会自动在指定安全组中添加NFS/CIFS协议所需的入方向规则。

取值范围：

• true：自动创建安全组规则。

• false：不自动创建安全组规则。

默认取值：

true

vault_id

否

String

参数解释：

云备份存储库ID，用于创建文件系统时绑定备份存储库。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

key

是

String

参数解释：

标签的键。

约束限制：

• 键不能为空。

• 键最大长度为128个字符。

• 只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”，“*”，“<”，“>”，“\”，“，”，“|”，“/”。

取值范围：

不涉及。

默认取值：

不涉及。

value

是

String

参数解释：

标签的值。

约束限制：

• 值最大长度为255个字符，可以为空字符串。

• 最多包含20个键，每个键最多对应20个值。

• 只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”, “*”, “<”, “>”, “\”, “,”, “|”, “/”。

取值范围：

不涉及。

默认取值：

不涉及。

is_auto_renew

否

Long

参数解释：

是否自动续费。

约束限制：

包周期计费场景下该参数生效。

取值范围：

• 0：不自动续费。

• 1：自动续费。

默认取值：

0

period_num

是

Long

参数解释：

包周期订购的周期数。

约束限制：

包周期计费场景下该参数为必选。

取值范围：

• 包月场景：取值范围为1~9。

• 包年场景：取值范围为1~3。

默认取值：

不涉及。

period_type

是

Long

参数解释：

包周期的类型。

约束限制：

包周期计费场景下该参数为必选。

取值范围：

• 2：表示包月。

• 3：表示包年。

默认取值：

不涉及。

is_auto_pay

否

Long

参数解释：

是否生成订单后自动扣款。

约束限制：

包周期计费场景下该参数生效。

取值范围：

• 0：表示不自动扣款。

• 1：表示自动扣款。

默认取值：

0

id

String

参数解释：

创建的SFS Turbo文件系统的ID。

取值范围：

不涉及。

name

String

参数解释：

创建的SFS Turbo文件系统的名称。

取值范围：

不涉及。

status

String

参数解释：

SFS Turbo文件系统的状态。文件系统处于不同生命周期阶段会返回对应状态。

取值范围：

• 100：创建中

• 200：可用

• 303：创建失败

• 800：实例被冻结

202

创建请求下发成功返回body。