GetDbfs - 数据库文件存储

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	GetDbfs	系统规定参数。取值：GetDbfs。
FsId	String	是	dbfs-GOrr********Yd0VLOyBpg	数据库文件系统ID。
RegionId	String	是	cn-hangzhou	DBFS实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

返回数据


名称	类型	示例值	描述
DBFSInfo	Struct		数据库文件系统实例。
AttachNodeNumber	Integer	1	数据库文件系统挂载的节点数。
Category	String	standard	数据库文件系统类型。取值范围： standard：标准版 enterprise：企业版（公测中）
CreatedTime	String	1609330367000	创建时间。
DBFSClusterId	String	c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD	数据库文件系统集群ID。
Description	String	desc	数据库文件系统描述信息。
EbsList	Array of EbsList		DBFS使用的云盘列表。
EbsId	String	d-bp1hq4******qi7gy1th	云盘ID。
SizeG	Integer	20	云盘容量。
EcsList	Array of EcsList		挂载到的ECS实例集合。
EcsId	String	i-y2vZ3********vvMilZ2hQ	已挂载的ECS实例ID。
EnableRaid	Boolean	false	是否使能RAID。
Encryption	Boolean	false	是否已加密。
FsId	String	dbfs-GOrr********Yd0VLOyBpg	数据库文件系统ID。
FsName	String	dbfs-test-01	数据库文件系统名称。
InstanceType	String	dbfs.small	DBFS实例规格。取值范围： dbfs.small dbfs.medium dbfs.large
KMSKeyId	String	c39EcDBf-2Ecb-C3C6-6526-018d4D******	KMS密钥ID。
LastFailed	String	TargetIsBusy.DBFS	最近一次操作失败原因。
LastMountTime	String	1644915400000	最后挂载时间。
LastUmountTime	String	1644915319000	最后卸载时间。
PayType	String	postpaid	数据库文件系统的付费类型，目前仅支持按量付费（postpaid）。
PerformanceLevel	String	PL1	云盘性能等级。取值范围： PL0 PL1 PL2 PL3
RaidStrip	Integer	2	条数个数。
RegionId	String	cn-hangzhou	数据库文件系统所属的地域ID。
SizeG	Integer	20	数据库文件系统大小，单位GiB。
Status	String	attached	数据库文件系统的状态。取值范围： unattached 待挂载 attached 已挂载 creating 创建中 attaching 挂载中 detaching 卸载中 deleting 删除中 deleted 已删除 resizing 扩容中 snapshotting 快照中 upgrading 升级中
Tags	Array of TagList		标签集合。
Id	Integer	1	标签ID。
TagKey	String	TestTagKey1	标签键。
TagValue	String	TestTagValue1	标签值。
UsedScene	String	MySQL 5.7	使用场景。
ZoneId	String	cn-hangzhou-i	数据库文件系统所属的可用区ID。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GetDbfs
&FsId=dbfs-GOrr********Yd0VLOyBpg
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<DBFSInfo>
    <Status>attached</Status>
    <LastFailed>TargetIsBusy.DBFS</LastFailed>
    <KMSKeyId>c39EcDBf-2Ecb-C3C6-6526-018d4D******</KMSKeyId>
    <CreatedTime>1609330367000</CreatedTime>
    <Category>standard</Category>
    <Description>desc</Description>
    <EnableRaid>false</EnableRaid>
    <ZoneId>cn-hangzhou-i</ZoneId>
    <SizeG>20</SizeG>
    <PerformanceLevel>PL1</PerformanceLevel>
    <DBFSClusterId>c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD</DBFSClusterId>
    <FsId>dbfs-GOrr********Yd0VLOyBpg</FsId>
    <LastUmountTime>1644915319000</LastUmountTime>
    <Encryption>false</Encryption>
    <PayType>postpaid</PayType>
    <FsName>dbfs-test-01</FsName>
    <UsedScene>MySQL 5.7</UsedScene>
    <RaidStrip>2</RaidStrip>
    <LastMountTime>1644915400000</LastMountTime>
    <AttachNodeNumber>1</AttachNodeNumber>
    <RegionId>cn-hangzhou</RegionId>
    <InstanceType>dbfs.small</InstanceType>
    <EcsList>
        <EcsId>i-y2vZ3********vvMilZ2hQ</EcsId>
    </EcsList>
    <EbsList>
        <SizeG>20</SizeG>
        <EbsId>d-bp1hq4******qi7gy1th</EbsId>
    </EbsList>
    <Tags>
        <TagKey>TestTagKey1</TagKey>
        <Id>1</Id>
        <TagValue>TestTagValue1</TagValue>
    </Tags>
</DBFSInfo>

JSON格式

{
    "RequestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "DBFSInfo":{
        "Status":"attached",
        "LastFailed":"TargetIsBusy.DBFS",
        "KMSKeyId":"c39EcDBf-2Ecb-C3C6-6526-018d4D******",
        "CreatedTime":"1609330367000",
        "Category":"standard",
        "Description":"desc",
        "EnableRaid":"false",
        "ZoneId":"cn-hangzhou-i",
        "SizeG":"20",
        "PerformanceLevel":"PL1",
        "DBFSClusterId":"c39EcDBf-2Ecb-C3C6-6526-018d4Dcf63eD",
        "FsId":"dbfs-GOrr********Yd0VLOyBpg",
        "LastUmountTime":"1644915319000",
        "Encryption":"false",
        "PayType":"postpaid",
        "FsName":"dbfs-test-01",
        "UsedScene":"MySQL 5.7",
        "RaidStrip":"2",
        "LastMountTime":"1644915400000",
        "AttachNodeNumber":"1",
        "RegionId":"cn-hangzhou",
        "InstanceType":"dbfs.small",
        "EcsList":[{
            "EcsId":"i-y2vZ3********vvMilZ2hQ"
        }],
        "EbsList":[{
            "SizeG":"20",
            "EbsId":"d-bp1hq4******qi7gy1th"
        }],
        "Tags":[{
            "TagKey":"TestTagKey1",
            "Id":"1",
            "TagValue":"TestTagValue1"
        }]
    }
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidRegion.DBFS	The region is not supported.	不支持的区域。
404	EntityNotExist.DBFS	The DBFS instance does not exist.	数据库文件存储实例不存在。

访问错误中心查看更多错误码。