ListDoctorHDFSDirectories - 批量获取HDFS目录分析结果_开源大数据平台 E-MapReduce(EMR)-阿里云帮助中心

通过EMR Doctor批量获取特定目录分析结果，目录不超过5级。

接口说明

list Doctor HDFSNodes

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

emr:ListDoctorHDFSDirectories

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
ClusterId	string	是	集群 ID。	c-b933c5aac8fe****
NextToken	string	否	标记当前开始读取的位置。	DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResults	integer	否	一次获取的最大记录数。	20
DateTime	string	是	其日期和时间信息以 ISO 8601 格式表示，例如：2023 年 1 月 1 日为 2023-01-01。	2023-01-01
DirPath	string	否	目录名称。目录不超过 5 级。如果不填写，就是全量目录分析。	/tmp/test
OrderType	string	否	排序方向。取值： ASC：升序排列 DESC：降序排列	ASC
OrderBy	string	否	排序依据。取值： totalFileCount: 总文件个数。 largeFileCount: 大文件个数。大文件指的是 1 GB 以上大小的文件。 mediumFileCount: 中文件个数。中文件指的是 128 MB 以上，1 GB 以下大小的文件。 smallFileCount: 小文件个数。小文件指的是 10 MB 以上，128 MB 以下大小的文件。 tinyFileCount: 极小文件个数。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。 emptyFileCount: 空文件个数。空文件指的是 0 MB 大小的文件。 hotDataSize: 热数据的数据量大小。热数据指的是 7 日内有访问的数据。 warmDataSize: 温数据的数据量大小。温数据指的是 7 日内没有访问的数据，但是 30 日以内有访问的数据。 coldDataSize: 冷数据的数据量大小。冷数据指的是 30 日内没有访问的数据，但是 90 日以内有访问的数据。 freezeDataSize: 极冷数据的数据量大小。极冷数据指的是 90 日以内都没有访问的数据。 totalDataSize: 总数据量大小。 totalFileDayGrowthCount: 总文件个数日增量。 largeFileDayGrowthCount: 大文件个数日增量。大文件指的是 1 GB 以上大小的文件。 mediumFileDayGrowthCount: 中文件个数增量。比中文件指的是 128 MB 以上，1 GB 以下大小的文件。 smallFileDayGrowthCount: 小文件个数日增量。小文件指的是 10 MB 以上，128 MB 以下大小的文件。 tinyFileDayGrowthCount: 极小文件个数日增量。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。 emptyFileDayGrowthCount: 空文件个数日增量。空文件指的是 0 MB 大小的文件。 hotDataDayGrowthSize: 热数据的数据量日增量大小。热数据指的是 7 日内有访问的数据。 warmDataDayGrowthSize: 温数据的数据量日增量大小。温数据指的是 7 日内没有访问的数据，但是 30 日以内有访问的数据。 coldDataDayGrowthSize: 冷数据的数据量日增量大小。冷数据指的是 30 日内没有访问的数据，但是 90 日以内有访问的数据。 freezeDataDayGrowthSize: 极冷数据的数据量日增量大小。极冷数据指的是 90 日以内都没有访问的数据。 totalDataDayGrowthSize: 全部数据的数据量日增量大小。 totalFileCountDayGrowthRatio: 总文件个数日环比。 largeFileCountDayGrowthRatio: 大文件个数日环比。大文件指的是 1 GB 以上大小的文件。 mediumFileCountDayGrowthRatio: 中文件个数日环比。比中文件指的是 128 MB 以上，1 GB 以下大小的文件。 smallFileCountDayGrowthRatio: 小文件个数日环比。小文件指的是 10 MB 以上，128 MB 以下大小的文件。 tinyFileCountDayGrowthRatio: 极小文件个数日环比。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。 emptyFileCountDayGrowthRatio: 空文件个数日环比。空文件指的是 0 MB 大小的文件。	smallFileCount

返回参数

名称	类型	描述	示例值
	object	返回数据
Data	array<object>	HDFS 批量目录分析数据。
	object	HDFS 目录分析数据。
DirPath	string	目录名称。	/tmp/test
Depth	integer	目录层级。	2
User	string	目录属主。	DW
Group	string	目录属组。	DW
Metrics	object	指标信息。
TotalFileCount	object	总文件个数。
Name	string	指标名称。	totalFileCount
Value	integer	指标值。	51683279
Unit	string	指标单位。	”“
Description	string	指标描述。	Number of total files
LargeFileCount	object	大文件个数。大文件指的是 1 GB 以上大小的文件。
Name	string	指标名称。	largeFileCount
Value	integer	指标值。	123
Unit	string	指标单位。	”“
Description	string	指标描述。	Number of large files
MediumFileCount	object	中文件个数。中文件指的是 128 MB 以上，1 GB 以下大小的文件。
Name	string	指标名称。	mediumFileCount
Value	integer	指标值。	323
Unit	string	指标单位。	”“
Description	string	指标描述。	Number of medium files
SmallFileCount	object	小文件个数。小文件指的是 10 MB 以上，128 MB 以下大小的文件。
Name	string	指标名称。	smallFileCount
Value	integer	指标值。	12345
Unit	string	指标单位。	”“
Description	string	指标描述。	Number of small files
TinyFileCount	object	极小文件个数。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。
Name	string	指标名称。	tinyFileCount
Value	integer	指标值。	232131
Unit	string	指标单位。	""
Description	string	指标描述。	Number of tiny files
EmptyFileCount	object	空文件个数。空文件指的是 0 MB 大小的文件。
Name	string	指标名称。	emptyFileCount
Value	integer	指标值。	15595897
Unit	string	指标单位。	”“
Description	string	指标描述。	Number of empty files
HotDataSize	object	热数据的数据量大小。热数据指的是 7 日内有访问的数据。
Name	string	指标名称。	hotDataSize
Value	integer	指标值。	6701531944206
Unit	string	指标单位。	MB
Description	string	指标描述。	Size of the hot data size
WarmDataSize	object	温数据的数据量大小。温数据指的是 7 日内没有访问的数据，但是 30 日以内有访问的数据。
Name	string	指标名称。	warmDataSize
Value	integer	指标值。	4062349775577
Unit	string	指标单位。	MB
Description	string	指标描述。	Size of the warm data size
ColdDataSize	object	冷数据的数据量大小。冷数据指的是 30 日内没有访问的数据，但是 90 日以内有访问的数据。
Name	string	指标名称。	coldDataSize
Value	integer	指标值。	5570958082267
Unit	string	指标单位。	MB
Description	string	指标描述。	Size of the cold data size
FreezeDataSize	object	极冷数据的数据量大小。极冷数据指的是 90 日以内都没有访问的数据。
Name	string	指标名称。	freezeDataSize
Value	integer	指标值。	1231312431
Unit	string	指标单位。	MB
Description	string	指标描述。	Size of the freeze data size
TotalDataSize	object	总数据量大小。
Name	string	指标名称。	totalDataSize
Value	integer	指标值。	62086342083623
Unit	string	指标单位。	MB
Description	string	指标描述。	Total data size in megabytes (MB)
TotalFileDayGrowthCount	object	总文件个数日增量。
Name	string	指标名称。	totalFileDayGrowthCount
Value	integer	指标值。	27809
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of total files
LargeFileDayGrowthCount	object	大文件个数日增量。大文件指的是 1 GB 以上大小的文件。
Name	string	指标名称。	largeFileDayGrowthCount
Value	integer	指标值。	2
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of large files
MediumFileDayGrowthCount	object	中文件个数增量。比中文件指的是 128 MB 以上，1 GB 以下大小的文件。
Name	string	指标名称。	mediumFileDayGrowthCount
Value	integer	指标值。	176
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of medium files
SmallFileDayGrowthCount	object	小文件个数日增量。小文件指的是 10 MB 以上，128 MB 以下大小的文件。
Name	string	指标名称。	smallFileDayGrowthCount
Value	integer	指标值。	12345
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of small files
TinyFileDayGrowthCount	object	极小文件个数日增量。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。
Name	string	指标名称。	tinyFileDayGrowthCount
Value	integer	指标值。	-123
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of tiny files
EmptyFileDayGrowthCount	object	空文件个数日增量。空文件指的是 0 MB 大小的文件。
Name	string	指标名称。	emptyFileDayGrowthCount
Value	integer	指标值。	114
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth count of empty files
HotDataDayGrowthSize	object	热数据的数据量日增量大小。热数据指的是 7 日内有访问的数据。
Name	string	指标名称。	hotDataDayGrowthSize
Value	integer	指标值。	123154
Unit	string	指标单位。	MB
Description	string	指标描述。	Day growth size of hot data
WarmDataDayGrowthSize	object	温数据的数据量日增量大小。温数据指的是 7 日内没有访问的数据，但是 30 日以内有访问的数据。
Name	string	指标名称。	warmDataDayGrowthSize
Value	integer	指标值。	-64806998319
Unit	string	指标单位。	MB
Description	string	指标描述。	Day growth size of warm data
ColdDataDayGrowthSize	object	冷数据的数据量日增量大小。冷数据指的是 30 日内没有访问的数据，但是 90 日以内有访问的数据。
Name	string	指标名称。	coldDataDayGrowthSize
Value	integer	指标值。	-182636577752
Unit	string	指标单位。	MB
Description	string	指标描述。	Day growth size of cold data
FreezeDataDayGrowthSize	object	极冷数据的数据量日增量大小。极冷数据指的是 90 日以内都没有访问的数据。
Name	string	指标名称。	freezeDataDayGrowthSize
Value	integer	指标值。	-167683929450
Unit	string	指标单位。	MB
Description	string	指标描述。	Day growth size of freeze data
TotalDataDayGrowthSize	object	全部数据的数据量日增量大小。
Name	string	指标名称。	totalDataDayGrowthSize
Value	integer	指标值。	256482228248
Unit	string	指标单位。	MB
Description	string	指标描述。	Day growth size of total data
TotalFileCountDayGrowthRatio	object	总文件个数日环比。
Name	string	指标名称。	totalFileCountDayGrowthRatio
Value	number	指标值。	0.02
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of total files
LargeFileCountDayGrowthRatio	object	大文件个数日环比。大文件指的是 1 GB 以上大小的文件。
Name	string	指标名称。	largeFileCountDayGrowthRatio
Value	number	指标值。	0.39
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of large files
MediumFileCountDayGrowthRatio	object	中文件个数日环比。比中文件指的是 128 MB 以上，1 GB 以下大小的文件。
Name	string	指标名称。	mediumFileCountDayGrowthRatio
Value	number	指标值。	0.19
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of medium files
SmallFileCountDayGrowthRatio	object	小文件个数日环比。小文件指的是 10 MB 以上，128 MB 以下大小的文件。
Name	string	指标名称。	smallFileCountDayGrowthRatio
Value	number	指标值。	0.02
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of small files
TinyFileCountDayGrowthRatio	object	极小文件个数日环比。极小文件指的是 0 MB 以上，10 MB 以下大小的文件。
Name	string	指标名称。	tinyFileCountDayGrowthRatio
Value	number	指标值。	0.003
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of tiny files
EmptyFileCountDayGrowthRatio	object	空文件个数日环比。空文件指的是 0 MB 大小的文件。
Name	string	指标名称。	emptyFileCountDayGrowthRatio
Value	number	指标值。	0.005
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of empty files
HotDataSizeDayGrowthRatio	object	热数据的数据量大小日环比。热数据指的是 7 日内有访问的数据。
Name	string	指标名称。	hotDataSizeDayGrowthRatio
Value	number	指标值。	0.1114
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of hot data size
WarmDataSizeDayGrowthRatio	object	温数据的数据量大小日环比。温数据指的是 7 日内没有访问的数据，但是 30 日以内有访问的数据。
Name	string	指标名称。	warmDataSizeDayGrowthRatio
Value	number	指标值。	-0.015
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of warm data size
ColdDataSizeDayGrowthRatio	object	冷数据的数据量大小日环比。冷数据指的是 30 日内没有访问的数据，但是 90 日以内有访问的数据。
Name	string	指标名称。	coldDataSizeDayGrowthRatio
Value	number	指标值。	-0.03
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of cold data size
FreezeDataSizeDayGrowthRatio	object	极冷数据的数据量大小日环比。极冷数据指的是 90 日以内都没有访问的数据。
Name	string	指标名称。	freezeDataSizeDayGrowthRatio
Value	number	指标值。	-0.09
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of freeze data size
TotalDataSizeDayGrowthRatio	object	总数据量大小日环比。
Name	string	指标名称。	totalDataSizeDayGrowthRatio
Value	number	指标值。	0.14
Unit	string	指标单位。	”“
Description	string	指标描述。	Day growth ratio of total data size
RequestId	string	请求 ID。	DD6B1B2A-5837-5237-ABE4-FF0C8944****
NextToken	string	返回读取到的数据位置。	DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResults	integer	本次请求所返回的最大记录条数。	20
TotalCount	integer	本次请求条件下的数据总量。	200

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "DirPath": "/tmp/test",
      "Depth": 2,
      "User": "DW",
      "Group": "DW",
      "Metrics": {
        "TotalFileCount": {
          "Name": "totalFileCount",
          "Value": 51683279,
          "Unit": "”“\n",
          "Description": "Number of total files\n"
        },
        "LargeFileCount": {
          "Name": "largeFileCount",
          "Value": 123,
          "Unit": "”“\n",
          "Description": "Number of large files\n"
        },
        "MediumFileCount": {
          "Name": "mediumFileCount",
          "Value": 323,
          "Unit": "”“\n",
          "Description": "Number of medium files\n"
        },
        "SmallFileCount": {
          "Name": "smallFileCount",
          "Value": 12345,
          "Unit": "”“\n",
          "Description": "Number of small files\n"
        },
        "TinyFileCount": {
          "Name": "tinyFileCount\n",
          "Value": 232131,
          "Unit": "\"\"",
          "Description": "Number of tiny files"
        },
        "EmptyFileCount": {
          "Name": "emptyFileCount",
          "Value": 15595897,
          "Unit": "”“\n",
          "Description": "Number of empty files"
        },
        "HotDataSize": {
          "Name": "hotDataSize",
          "Value": 6701531944206,
          "Unit": "MB\n",
          "Description": "Size of the hot data size\n"
        },
        "WarmDataSize": {
          "Name": "warmDataSize\n",
          "Value": 4062349775577,
          "Unit": "MB\n",
          "Description": "Size of the warm data size\n"
        },
        "ColdDataSize": {
          "Name": "coldDataSize",
          "Value": 5570958082267,
          "Unit": "MB",
          "Description": "Size of the cold data size\n"
        },
        "FreezeDataSize": {
          "Name": "freezeDataSize",
          "Value": 1231312431,
          "Unit": "MB\n",
          "Description": "Size of the freeze data size\n"
        },
        "TotalDataSize": {
          "Name": "totalDataSize",
          "Value": 62086342083623,
          "Unit": "MB\n",
          "Description": "Total data size in megabytes (MB)\n"
        },
        "TotalFileDayGrowthCount": {
          "Name": "totalFileDayGrowthCount",
          "Value": 27809,
          "Unit": "”“\n",
          "Description": "Day growth count of total files\n"
        },
        "LargeFileDayGrowthCount": {
          "Name": "largeFileDayGrowthCount",
          "Value": 2,
          "Unit": "”“\n",
          "Description": "Day growth count of large files\n"
        },
        "MediumFileDayGrowthCount": {
          "Name": "mediumFileDayGrowthCount",
          "Value": 176,
          "Unit": "”“\n",
          "Description": "Day growth count of medium files\n"
        },
        "SmallFileDayGrowthCount": {
          "Name": "smallFileDayGrowthCount",
          "Value": 12345,
          "Unit": "”“\n",
          "Description": "Day growth count of small files\n"
        },
        "TinyFileDayGrowthCount": {
          "Name": "tinyFileDayGrowthCount",
          "Value": -123,
          "Unit": "”“\n",
          "Description": "Day growth count of tiny files"
        },
        "EmptyFileDayGrowthCount": {
          "Name": "emptyFileDayGrowthCount",
          "Value": 114,
          "Unit": "”“\n",
          "Description": "Day growth count of empty files\n"
        },
        "HotDataDayGrowthSize": {
          "Name": "hotDataDayGrowthSize",
          "Value": 123154,
          "Unit": "MB\n",
          "Description": "\t\nDay growth size of hot data\n"
        },
        "WarmDataDayGrowthSize": {
          "Name": "warmDataDayGrowthSize",
          "Value": -64806998319,
          "Unit": "MB\n",
          "Description": "Day growth size of warm data\n"
        },
        "ColdDataDayGrowthSize": {
          "Name": "coldDataDayGrowthSize",
          "Value": -182636577752,
          "Unit": "MB\n",
          "Description": "Day growth size of cold data\n"
        },
        "FreezeDataDayGrowthSize": {
          "Name": "freezeDataDayGrowthSize",
          "Value": -167683929450,
          "Unit": "MB\n",
          "Description": "Day growth size of freeze data\n"
        },
        "TotalDataDayGrowthSize": {
          "Name": "totalDataDayGrowthSize",
          "Value": 256482228248,
          "Unit": "MB\n",
          "Description": "Day growth size of total data\n"
        },
        "TotalFileCountDayGrowthRatio": {
          "Name": "totalFileCountDayGrowthRatio\n",
          "Value": 0.02,
          "Unit": "”“\n",
          "Description": "Day growth ratio of total files\n"
        },
        "LargeFileCountDayGrowthRatio": {
          "Name": "largeFileCountDayGrowthRatio",
          "Value": 0.39,
          "Unit": "”“\n",
          "Description": "Day growth ratio of large files\n"
        },
        "MediumFileCountDayGrowthRatio": {
          "Name": "mediumFileCountDayGrowthRatio",
          "Value": 0.19,
          "Unit": "”“\n",
          "Description": "Day growth ratio of medium files\n"
        },
        "SmallFileCountDayGrowthRatio": {
          "Name": "smallFileCountDayGrowthRatio",
          "Value": 0.02,
          "Unit": "”“\n",
          "Description": "Day growth ratio of small files\n"
        },
        "TinyFileCountDayGrowthRatio": {
          "Name": "tinyFileCountDayGrowthRatio",
          "Value": 0.003,
          "Unit": "”“\n",
          "Description": "Day growth ratio of tiny files\n"
        },
        "EmptyFileCountDayGrowthRatio": {
          "Name": "emptyFileCountDayGrowthRatio",
          "Value": 0.005,
          "Unit": "”“\n",
          "Description": "Day growth ratio of empty files"
        },
        "HotDataSizeDayGrowthRatio": {
          "Name": "hotDataSizeDayGrowthRatio",
          "Value": 0.1114,
          "Unit": "”“\n",
          "Description": "Day growth ratio of hot data size\n"
        },
        "WarmDataSizeDayGrowthRatio": {
          "Name": "\t\nwarmDataSizeDayGrowthRatio\n",
          "Value": -0.015,
          "Unit": "”“\n",
          "Description": "Day growth ratio of warm data size\n"
        },
        "ColdDataSizeDayGrowthRatio": {
          "Name": "coldDataSizeDayGrowthRatio",
          "Value": -0.03,
          "Unit": "”“\n",
          "Description": "Day growth ratio of cold data size\n"
        },
        "FreezeDataSizeDayGrowthRatio": {
          "Name": "freezeDataSizeDayGrowthRatio",
          "Value": -0.09,
          "Unit": "”“",
          "Description": "Day growth ratio of freeze data size\n"
        },
        "TotalDataSizeDayGrowthRatio": {
          "Name": "totalDataSizeDayGrowthRatio",
          "Value": 0.14,
          "Unit": "”“\n",
          "Description": "Day growth ratio of total data size\n"
        }
      }
    }
  ],
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
  "MaxResults": 20,
  "TotalCount": 200
}

错误码

HTTP status code	错误码	错误信息	描述
400	ConflictParameters	Parameters that must not be used together. %s	多个参数间存在冲突。
400	IncompleteSignature	The request signature is invalid.	API请求签名不合法。
400	InvalidAction	The action %s requested is invalid.	不合法的Action。
400	InvalidParameter	The specified parameter %s is not valid.	参数错误。
400	InvalidParameterValue	The input parameter %s is invalid or out of range.	参数值超出范围。
400	MissingAction	The action %s requested is missing.	缺少Action参数
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.	参数缺失。
400	NotAuthorized	You do not have permission to perform this action. %s	没有权限。
400	ThrottlingException	The request was denied due to request throttling. %s	限流。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误。
404	ResourceNotFound	The resource not found by %s.	请求的资源未找到。
503	ServiceFailure	The request has failed due to a temporary failure of %s service.	依赖的阿里云其他服务不可用。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	请求超时或者服务不可用。

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

变更历史

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