调用GetFileSystem查询文件系统详细信息-文件存储HDFS版-阿里云-文件存储HDFS版(HDFS)-阿里云帮助中心

查询文件系统信息。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dfs:GetFileSystem

get

*FileSystem

acs:dfs:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

无

请求参数

名称	类型	必填	描述	示例值
FileSystemId	string	是	文件系统 ID。	37af8f42-2abc-4e74-889d-664f5163****
InputRegionId	string	是	地域 ID。	cn-hangzhou

返回参数

名称	类型	描述	示例值
	object
FileSystem	object	文件系统信息集合。
CreateTime	string	文件系统的创建时间。采用 ISO 8601 格式的 UTC 时间，例如 2022-04-18T06:03:15.836222Z。	2022-04-18T06:03:15.836222Z
Description	string	文件系统的描述信息。	这是我公司的第一个文件存储HDFS版实例。
FileSystemId	string	文件系统 ID。	37af8f42-2abc-4e74-889d-664f5163****
FileSystemName	string	文件系统名称。	MyFirstHDFS
MeteringMode	string	文件系统计量模式, UsageBased:按实际用量计量上报（默认值）, CapacityBased:按申请容量 SpaceCapacity 固定计量上报，QoS 给满规格	UsageBased,CapacityBased
MeteringSpaceSize	number	文件系统的计费容量。单位：字节（byte）。计费容量=MAX[（文件数+目录数）*5MiB，使用容量]。统计数据，不作为计费数据，仅作参考。HDFS 按照上一小时计费容量峰值进行计费。若您希望查询更详细的计量数据，请参见查看消费明细。	107374182400
MountPointCount	integer	挂载点数量。	2
NumberOfDirectories	integer	目录数量。	100
NumberOfFiles	integer	文件数量。	1000
ProtocolType	string	协议类型。仅支持 HDFS（Hadoop Distributed File System）。	HDFS
ProvisionedThroughputInMiBps	integer	预置吞吐量。单位：MB/s	1024
RegionId	string	地域 ID。	cn-hangzhou
SpaceCapacity	integer	文件系统容量。单位：GB	1024
StoragePackageId	string	存储包 ID。	1
StorageType	string	存储介质类型。包括： STANDARD：标准型 PERFORMANCE：性能型	STANDARD
ThroughputMode	string	吞吐模式。包括： Standard：标准吞吐 Provisioned：预置吞吐	Standard
UsedSpaceSize	number	已使用存储空间。单位：GB	100
Version	string	阿里云文件存储 HDFS 版的版本，非 hadoop 版本。	1.0.0
ZoneId	string	可用区 ID。	cn-hangzhou-b
RequestId	string	请求 ID。	55C5FFD6-BF99-41BD-9C66-FFF39189****

示例

正常返回示例

JSON格式

{
  "FileSystem": {
    "CreateTime": "2022-04-18T06:03:15.836222Z",
    "Description": "这是我公司的第一个文件存储HDFS版实例。",
    "FileSystemId": "37af8f42-2abc-4e74-889d-664f5163****",
    "FileSystemName": "MyFirstHDFS",
    "MeteringMode": "UsageBased,CapacityBased",
    "MeteringSpaceSize": 107374182400,
    "MountPointCount": 2,
    "NumberOfDirectories": 100,
    "NumberOfFiles": 1000,
    "ProtocolType": "HDFS",
    "ProvisionedThroughputInMiBps": 1024,
    "RegionId": "cn-hangzhou",
    "SpaceCapacity": 1024,
    "StoragePackageId": "1",
    "StorageType": "STANDARD",
    "ThroughputMode": "Standard",
    "UsedSpaceSize": 100,
    "Version": "1.0.0",
    "ZoneId": "cn-hangzhou-b"
  },
  "RequestId": "55C5FFD6-BF99-41BD-9C66-FFF39189****"
}

错误码

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

变更历史

更多信息，参考变更详情。