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

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史