调用CreateDbfs创建一个按量付费的数据库文件系统。
创建数据库文件系统需要通过实名认证。请前往会员信息中进行实名认证。
创建数据库文件系统会涉及到资源计费,建议您提前了解数据库文件系统的计费方式。更多详情请参见按量付费。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDbfs |
系统规定参数。取值:CreateDbfs。 |
FsName | String | 是 | testdbfs-001 |
数据库文件系统名称。 取值范围:2~128个字符,以英文大小写字母或中文开头,可包含数字、下划线和连字符(-)。 |
Category | String | 是 | standard |
数据库文件系统类型。取值范围:
|
RegionId | String | 是 | cn-hangzhou |
DBFS实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
SizeG | Integer | 是 | 200 |
容量大小,以GiB为单位。指定该参数后,其取值必须≥指定快照ID的容量大小。 取值范围:20-10240。 |
ZoneId | String | 是 | cn-hangzhou-i |
DBFS实例所属的可用区ID。 |
PerformanceLevel | String | 否 | PL1 |
创建DBFS实例时,设置DBFS的性能等级。取值范围:
|
EnableRaid | Boolean | 否 | false |
是否以RAID方式来创建DBFS。如果以RAID方式创建,容量至少为66GB。 取值范围:true或false,默认值为false。 |
RaidStripeUnitNumber | Integer | 否 | 2 |
条带数量。当EnableRaid参数为true时必传。 取值范围:目前仅支持条带数为2。 |
Encryption | Boolean | 否 | false |
是否加密DBFS。 取值范围:true或false,默认值为false。 |
KMSKeyId | String | 否 | 0e478b7a-4262-4802-b8cb-00d3fb40826X |
DBFS使用的KMS密钥ID。 |
SnapshotId | String | 否 | s-y2vZ3********vvMilZ2hQ |
创建DBFS实例使用的快照ID。 |
DeleteSnapshot | Boolean | 否 | false |
使用快照创建DBFS后是否删除原始快照。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性。 |
UsedScene | String | 否 | PostgreSQL |
DBFS的使用场景。取值范围:
|
InstanceType | String | 否 | dbfs.small |
实例规格。取值范围:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
FsId | String | dbfs-GOrr********Yd0VLOyBpg |
数据库文件系统ID。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateDbfs
&FsName=testdbfs-001
&Category=standard
&RegionId=cn-hangzhou
&SizeG=200
&ZoneId=cn-hangzhou-i
&<公共请求参数>
正常返回示例
XML
格式
<CreateDbfsResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>
</CreateDbfsResponse>
JSON
格式
{
"RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"FsId":"dbfs-GOrr********Yd0VLOyBpg"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidCategory.DBFS | The category is not supported. | 非法的版本类型。 |
400 | InvalidName.DBFS | Invalid DBFS instance name. | 非法的DBFS实例名称。 |
400 | InvalidPerformanceLevel.DBFS | The performance level is not supported. | 非法的性能等级。 |
400 | InvalidRegion.DBFS | The region is not supported. | 不支持的区域。 |
400 | InvalidSize.DBFS | The size of DBFS is invalid. | 非法的容量大小。 |
400 | InvalidZone.DBFS | The zone is not supported. | 不支持的可用区。 |
404 | EntityNotExist.Snapshot | The snapshot does not exist. | 快照不存在。 |
访问错误中心查看更多错误码。
访问错误中心查看更多错误码。