DescribeFileSystems
调用DescribeFileSystems查询文件系统信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeFileSystems |
操作接口名,系统规定参数,取值:DescribeFileSystems。 |
FileSystemId | String | 否 | 109c042666 |
文件系统ID。 |
FileSystemType | String | 否 | standard |
文件系统类型。
|
VpcId | String | 否 | vpc-bp1sevsgtqvk5gxblhhod |
专有网络ID。 必须与待挂载的云服务器ECS选择一样的VPC网络。 |
PageSize | Integer | 否 | 1 |
分页查询时,每个分页包含的文件系统个数。
|
PageNumber | Integer | 否 | 1 |
列表的分页页码。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 035B3A3A-E514-4B41-B906-5D906CFBD65F |
请求ID。 |
TotalCount | Integer | 1 |
文件系统的总个数。 |
PageSize | Integer | 1 |
每个分页包含的文件系统个数。 |
PageNumber | Integer | 1 |
文件系统列表的分页页码。 |
FileSystems | Array |
文件系统的描述信息。 |
|
FileSystemId | String | 109c042666 |
文件系统ID。 |
Description | String | 空 |
文件系统的描述信息。 |
CreateTime | String | 2017-05-27T15:43:06CST |
文件系统的创建时间。 |
ExpiredTime | String | 1572174830000 |
文件系统到期时间。 |
RegionId | String | cn-hangzhou |
地域ID。 |
ZoneId | String | cn-hangzhou-b |
文件系统所在的可用区。 |
ProtocolType | String | NFS |
协议类型,包括:NFS、SMB。 |
StorageType | String | Performance |
存储类型。
|
FileSystemType | String | all |
文件系统类型。 |
EncryptType | Integer | 1 |
|
MeteredSize | Long | 1611661312 |
文件系统已使用量,为上一小时最大使用量,非当前值,(单位:Byte)。 |
Bandwidth | Long | 150 |
文件系统的带宽(单位:MB/s)。通用型NAS没有该字段。 |
Capacity | Long | 1 |
文件系统的容量(单位:GB)。 |
Status | String | Pending |
文件系统状态,仅极速型NAS返回该字段。
|
ChargeType | String | PayAsYouGo |
付费类型。
|
MountTargets | Array |
挂载点信息。 |
|
MountTargetDomain | String | 109c042666-wjb85.cn-hangzhou.nas.aliyuncs.com |
挂载点域名。 |
NetworkType | String | vpc |
网络类型,包括VPC和Classic。 |
VpcId | String | vpc-bp1sevsgtqvk5gxblhhod |
专有网络ID。 |
VswId | String | vsw-bp1omfzsszekkvaxnz66e |
交换机ID。 |
AccessGroupName | String | test-001 |
挂载点使用的权限组名称。 |
Status | String | active |
挂载点状态,通用型 NAS:active、inactive。 |
Packages | Array |
存储包信息。 |
|
PackageId | String | naspackage-xxxxxxxxxxx-xxxxxx |
存储包ID。 |
PackageType | String | hybrid |
存储包类型。 |
Size | Long | 107374182400 |
存储包容量大小。 |
StartTime | String | 2019-12-05T01:40:56Z |
存储包起始时间。 |
ExpiredTime | String | 2020-01-05T16:00:00Z |
存储包到期时间。 |
Ldap | Struct |
LDAP配置,仅CPFS文件系统返回该节点。 |
|
BindDN | String | cn=alibaba,dc=com |
绑定LDAP的指定条目。 |
URI | String | ldap://ldap.example.example |
LDAP服务地址。 |
SearchBase | String | dc=example |
LDAP搜索起始点。 |
示例
请求示例
GET https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeFileSystems
&FileSystemId=109c042666
&<公共请求参数>
正常返回示例
XML
格式
<DescribeFileSystemsResponse>
<PageNumber>1</PageNumber>
<TotalCount>1</TotalCount>
<PageSize>1</PageSize>
<RequestId>035B3A3A-E514-4B41-B906-5D906CFBD65F</RequestId>
<FileSystems>
<FileSystem>
<FileSystemId>109c042666</FileSystemId>
<ProtocolType>NFS</ProtocolType>
<RegionId>cn-hangzhou</RegionId>
<CreateTime>2017-05-27T15:43:06CST</CreateTime>
<Destription></Destription>
<MountTargets>
<MountTarget>
<MountTargetDomain>109c042666-wjb85.cn-hangzhou.nas.aliyuncs.com</MountTargetDomain>
</MountTarget>
</MountTargets>
<StorageType>Performance</StorageType>
<MeteredSize>1611661312</MeteredSize>
</FileSystem>
</FileSystems>
</DescribeFileSystemsResponse>
JSON
格式
{
"PageNumber": 1,
"TotalCount": 1,
"PageSize": 1,
"RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C546E",
"FileSystems": {
"FileSystem": [
{
"FileSystemId": "31a8e48eda",
"Description": "31a8e48eda",
"Packages": {
"Package": [
{
"PackageId": ""
}
]
},
"ProtocolType": "NFS",
"RegionId": "cn-shanghai",
"CreateTime": "2017-04-18T00:22:56CST",
"Destription": "31a8e48eda",
"ZoneId": "cn-shanghai-b",
"MountTargets": {
"MountTarget": [
{
"Status": "active",
"NetworkType": "vpc",
"VswId": "vsw-uf64zi0nn71ntvkbzdti4",
"AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
"VpcId": "vpc-uf65wx2khu08h4dlw2qfv",
"MountTargetDomain": "31a8e48eda-ykf64.cn-shanghai.nas.aliyuncs.com"
}
]
},
"StorageType": "Performance",
"MeteredSize": 4295639040
}
]
}
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论