1. 接口描述
接口请求域名: turbofs.api3.gsesgpucloud.com。
用于添加新文件系统
默认接口请求频率限制:10次/秒。
接口更新时间:2019-07-09 19:27:47。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。
参数名称 | 必选 | 允许NULL | 类型 | 描述 |
---|---|---|---|---|
Action | 是 | 否 | String | 公共参数,本接口取值:CreateCfsFileSystem |
Version | 是 | 否 | String | 公共参数,本接口取值:2018-04-16 |
Region | 是 | 否 | String | 公共参数,地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
ZoneId | 否 | 否 | Uint64 | 可用区 ID 示例值: |
Zone | 否 | 否 | String | 可用区缩写 示例值: |
CreationToken | 否 | 否 | String | 用户自定义文件系统名称 示例值: |
Protocol | 否 | 否 | String | 文件系统协议类型 示例值: |
StorageType | 否 | 否 | String | 文件系统存储类型 示例值: |
NetInterface | 是 | 否 | String | 网络类型 示例值: |
PGroupId | 是 | 否 | String | 权限组 ID 示例值: |
VpcId | 否 | 否 | Uint64 | VPC ID 示例值: |
UnVpcId | 否 | 否 | String | 系统分配的VPC统一ID 示例值: |
SubnetId | 否 | 否 | Uint64 | 子网 ID 示例值: |
UnSubnetId | 否 | 否 | String | 系统分配的子网统一 ID 示例值: |
MountIP | 否 | 否 | String | 指定IP地址,仅VPC网络支持 示例值: |
StorageResourcePkgId | 否 | 否 | String | 文件系统绑定的存储包,每个文件系统只能绑定一个。低频文件系统该字段为必填 示例值: |
BandwidthResourcePkgId | 否 | 否 | String | 文件系统绑定的带宽包,每个文件系统只能绑定一个 示例值: |
FsName | 否 | 否 | String | 用户自定义文件系统名称,优先级优于CreationToken 示例值: |
Encrypted | 否 | 否 | Bool | 文件系统协议类型,输入值 NFS,CIFS;不填默认为 NFS 示例值: |
KmsKeyId | 否 | 否 | String | 文件系统是否加密 示例值: |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
CreationTime | String | 创建时间 示例值: |
CreationToken | String | 用户自定义文件系统名称 示例值: |
FileSystemId | String | 文件系统 ID 示例值: |
LifeCycleState | String | 文件系统状态 示例值: |
SizeByte | Uint64 | 文件系统已使用容量大小 示例值: |
ZoneId | Uint64 | 可用区 ID 示例值: |
FsName | String | 用户自定义文件系统名称 示例值: |
Encrypted | Bool | 文件系统是否加密 示例值: |
RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
错误码 | 描述 |
---|---|
InvalidParameter | 参数错误。 |
InternalError | 内部错误。 |
InternalError.CreateFsFailed | 创建文件系统失败。 |
InternalError.GetAccountStatusFailed | 获取用户费用状态失败。 |
InvalidParameterValue.FsNameLimitExceeded | 用户自定义名称过长(超过64字节)。 |
InvalidParameterValue.InvalidFsName | 无效的自定义名称。 |
InvalidParameterValue.InvalidMountTargetIp | 错误的挂载点IP。 |
InvalidParameterValue.InvalidNetInterface | 无效的网络类型。 |
InvalidParameterValue.InvalidPgroupId | 权限组ID无效。 |
InvalidParameterValue.InvalidProtocol | 协议参数错误。 |
InvalidParameterValue.InvalidRegionZoneInfo | 用户区域选择错误 (ZoneName) 或 (ZoneId, Region)二者必选一。 |
InvalidParameterValue.InvalidStorageType | 存储类型参数错误。 |
InvalidParameterValue.InvalidSubnetId | 无效的子网ID。 |
InvalidParameterValue.InvalidVip | 用户指定不可用的vip。 |
InvalidParameterValue.InvalidVpcId | 无效的VPCID。 |
InvalidParameterValue.InvalidVpcParameter | VPC参数错误。 |
InvalidParameterValue.InvalidZoneId | 无效的可用区。 |
InvalidParameterValue.InvalidZoneOrZoneId | 无效的可用区或可用区ID。 |
InvalidParameterValue.MissingStorageResourcePkg | 未绑定存储包。 |
InvalidParameterValue.MissingSubnetidOrUnsubnetid | SUBNETID和UNSUBNETID不能同时为空。 |
InvalidParameterValue.MissingVpcidOrUnvpcid | VPCID和UNVPCID不能同时为空。 |
InvalidParameterValue.MissingVpcParameter | VPC相关参数缺失。 |
InvalidParameterValue.MissingZoneId | ZoneID缺失。 |
InvalidParameterValue.UnavailableRegion | 该可用区无法提供服务。 |
InvalidParameterValue.UnavailableZone | 该地域无法提供服务。 |
InvalidParameterValue.ZoneIdRegionNotMatch | ZoneId和Region不匹配。 |
ResourceInsufficient.FileSystemLimitExceeded | 文件系统数量达到上限。 |
ResourceInsufficient.RegionSoldOut | 区域资源售罄。 |
ResourceNotFound.PgroupNotFound | 权限组不存在。 |
FailedOperation | 操作失败。 |
InvalidParameterValue.InvalidEncrypted | 加密参数错误。 |
InvalidParameterValue.MissingKmsKeyId | 密钥ID或ARN参数缺失。 |
InvalidParameterValue.MissingZoneOrZoneId | 用户区域选择错误 (Zone) 或 (Zone_id)二者必选一。 |