创建文件系统
最近更新时间: 2025-02-18 17:50:22
1. 接口描述
接口请求域名： cfs.api3.fincloud.tencent.cn。
用于添加新文件系统
默认接口请求频率限制：10次/秒。
接口更新时间：2020-12-16 20:39:57。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateCfsFileSystem |
| Version | 是 | 否 | String | 公共参数，本接口取值：2019-07-19 |
| Region | 是 | 否 | String | 公共参数，详见产品支持的地域列表(TODO) |
| ZoneId | 否 | 否 | Uint64 | 此参数对外不可见。 可用区 ID |
| Zone | 是 | 否 | String | 可用区名称，例如:ap-beijing-1 |
| CreationToken | 否 | 否 | String | 此参数对外不可见。 用户自定义文件系统名称，优先级低于 FSNAME |
| Protocol | 否 | 否 | String | 文件系统协议类型， 值为 NFS、CIFS; 若留空则默认为 NFS协议 |
| StorageType | 否 | 否 | String | 文件系统存储类型，值为 SD ；其中 SD 为标准型存储 |
| NetInterface | 是 | 否 | String | 网络类型，值为 VPC，BASIC；其中 VPC 为私有网络，BASIC 为基础网络 |
| PGroupId | 是 | 否 | String | 权限组 ID |
| VpcId | 否 | 否 | String | 私有网路（VPC） ID;当网络类型值为 VPC时，与UnVpcId 两者必须填一项 |
| UnVpcId | 否 | 否 | String | 此参数对外不可见。 系统分配的VPC统一ID |
| SubnetId | 否 | 否 | String | 子网， 当网络类型值为 VPC时，与UnSubnetId 两者必须填一项 |
| UnSubnetId | 否 | 否 | String | 此参数对外不可见。 系统分配的子网统一 ID |
| MountIP | 否 | 否 | String | 指定IP地址，仅VPC网络支持；若不填写、将在该子网下随机分配 IP |
| StorageResourcePkgId | 否 | 否 | String | 此参数对外不可见。 文件系统绑定的存储包，每个文件系统只能绑定一个 |
| BandwidthResourcePkgId | 否 | 否 | String | 此参数对外不可见。 文件系统绑定的带宽包，每个文件系统只能绑定一个 |
| FsName | 否 | 否 | String | 用户自定义文件系统名称,与CreationToken 两者必须填一项 |
| Encrypted | 否 | 否 | Bool | 此参数对外不可见。 文件系统是否加密，若留空则默认为不加密 |
| KmsKeyId | 否 | 否 | String | 此参数对外不可见。 加密密钥 ID |
| TagId | 否 | 否 | Uint64 | cfs资源池id |
| SnapId | 否 | 否 | String | 快照id |
| ResourceTags | 否 | 否 | Array of ResourceTags | 标签 |
| ProjectId | 否 | 否 | String | 项目id |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| CreationTime | String | 文件系统创建时间 |
| CreationToken | String | 用户自定义文件系统名称 |
| FileSystemId | String | 文件系统 ID |
| LifeCycleState | String | 文件系统状态 |
| SizeByte | Uint64 | 文件系统已使用容量大小 |
| ZoneId | Uint64 | 可用区 ID |
| FsName | String | 用户自定义文件系统名称 |
| Encrypted | Bool | 文件系统是否加密 |
| CfsId | String | 文件系统ID |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue.FsNameLimitExceeded | |
| InvalidParameterValue.InvalidVpcParameter | |
| InvalidParameterValue.MissingSubnetidOrUnsubnetid | |
| InternalError.CreateFsFailed | |
| ResourceInsufficient.RegionSoldOut | |
| InvalidParameterValue.InvalidEncrypted | |
| InvalidParameterValue.InvalidFsName | |
| InvalidParameterValue.InvalidNetInterface | |
| InvalidParameterValue.InvalidZoneOrZoneId | |
| InvalidParameterValue.MissingStorageResourcePkg | |
| UnsupportedOperation.UnverifiedUser | |
| InvalidParameterValue.InvalidZoneId | |
| InvalidParameterValue.MissingZoneId | |
| ResourceInsufficient.FileSystemLimitExceeded | |
| ResourceNotFound.PgroupNotFound | |
| InternalError.GetAccountStatusFailed | |
| InvalidParameterValue.UnavailableRegion | |
| UnsupportedOperation.OutOfService | |
| InvalidParameterValue.InvalidStorageType | |
| InvalidParameterValue.MissingKmsKeyId | |
| InvalidParameterValue.InvalidRegionZoneInfo | |
| InvalidParameterValue.InvalidVip | |
| InvalidParameterValue.ZoneIdRegionNotMatch | |
| InternalError | |
| InvalidParameterValue.InvalidPgroupId | |
| InvalidParameterValue.MissingVpcidOrUnvpcid | |
| AuthFailure.UnauthorizedOperation | |
| FailedOperation | |
| InvalidParameterValue.MissingVpcParameter | |
| InvalidParameterValue.MissingZoneOrZoneId | |
| InvalidParameterValue.InvalidMountTargetIp | |
| InvalidParameterValue.UnavailableZone | |
| InvalidParameter | |
| InvalidParameterValue.InvalidSubnetId | |
| InvalidParameterValue.InvalidProtocol | |
| ResourceInsufficient.SubnetIpAllOccupied | |
| InvalidParameterValue.InvalidVpcId | |
| InvalidParameterValue.SnapSrcFsBusy | |
| InvalidParameter.InvalidTagKey | |
| ResourceInsufficient.TagLimitExceeded | |
| AuthFailure |