GetDoctorHDFSDirectory - E-MapReduce - Alibaba Cloud Documentation Center

Obtains the analysis results of a specific Hadoop Distributed File System (HDFS) directory of a cluster. The depth of the directory is not greater than five.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID.	cn-hangzhou
ClusterId	string	Yes	The cluster ID.	c-b933c5aac8fe****
DateTime	string	Yes	Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023.	2023-01-01
DirPath	string	Yes	The directory name. The depth of the directory is not greater than five.	/tmp/test

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
Data	object	The analysis results of the HDFS directory.
Depth	integer	The directory level.	2
User	string	The directory owner.	DW
Group	string	The group to which the directory belongs.	DW
Metrics	object	The metric information.
TotalFileCount	object	The total number of files.
Name	string	The name of the metric.	totalFileCount
Value	long	The value of the metric.	51683279
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of total files
LargeFileCount	object	The number of large files. Large files are those with a size greater than 1 GB.
Name	string	The name of the metric.	largeFileCount
Value	long	The value of the metric.	123
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of large files
MediumFileCount	object	The number of medium files. Medium files are those with a size greater than or equal to 128 MB and less than or equal to 1 GB.
Name	string	The name of the metric.	mediumFileCount
Value	long	The value of the metric.	234
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of medium files
SmallFileCount	object	The number of small files. Small files are those with a size greater than or equal to 10 MB and less than 128 MB.
Name	string	The name of the metric.	smallFileCount
Value	long	The value of the metric.	12345
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of small files
TinyFileCount	object	The number of very small files. Very small files are those with a size greater than 0 MB and less than 10 MB.
Name	string	The name of the metric.	tinyFileCount
Value	long	The value of the metric.	232131
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of tiny files
EmptyFileCount	object	The number of empty files. Empty files are those with a size of 0 MB.
Name	string	The name of the metric.	emptyFileCount
Value	long	The value of the metric.	15595897
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Number of empty files
HotDataSize	object	The amount of hot data. Hot data refers to data that is accessed in previous seven days.
Name	string	The name of the metric.	hotDataSize
Value	long	The value of the metric.	6701531944206
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Size of the hot data size
WarmDataSize	object	The amount of warm data. Warm data refers to data that is not accessed for more than 7 days but is accessed in previous 30 days.
Name	string	The name of the metric.	warmDataSize
Value	long	The value of the metric.	4062349775577
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Size of the warm data size
ColdDataSize	object	The amount of cold data. Cold data refers to data that is not accessed for more than 30 days but is accessed in previous 90 days.
Name	string	The name of the metric.	coldDataSize
Value	long	The value of the metric.	5570958082267
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Size of the cold data size
FreezeDataSize	object	The amount of very cold data. Very cold data refers to data that is not accessed for more than 90 days.
Name	string	The name of the metric.	freezeDataSize
Value	long	The value of the metric.	1231312431
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Size of the freeze data size
TotalDataSize	object	The total amount of data.
Name	string	The name of the metric.	totalDataSize
Value	long	The value of the metric.	62086342083623
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Total data size in megabytes (MB)
TotalFileDayGrowthCount	object	The daily increment of the total number of files.
Name	string	The name of the metric.	totalFileDayGrowthCount
Value	long	The value of the metric.	27809
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of total files
LargeFileDayGrowthCount	object	The daily increment of the number of large files. Large files are those with a size greater than 1 GB.
Name	string	The name of the metric.	largeFileDayGrowthCount
Value	long	The value of the metric.	2
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of large files
MediumFileDayGrowthCount	object	The daily increment of the number of medium files. Medium files are those with a size greater than or equal to 128 MB and less than or equal to 1 GB.
Name	string	The name of the metric.	mediumFileDayGrowthCount
Value	long	The value of the metric.	176
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of medium files
SmallFileDayGrowthCount	object	The daily increment of the number of small files. Small files are those with a size greater than or equal to 10 MB and less than 128 MB.
Name	string	The name of the metric.	smallFileDayGrowthCount
Value	long	The value of the metric.	12345
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of small files
TinyFileDayGrowthCount	object	The daily increment of the number of very small files. Very small files are those with a size greater than 0 MB and less than 10 MB.
Name	string	The name of the metric.	tinyFileDayGrowthCount
Value	long	The value of the metric.	-123
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of tiny files
EmptyFileDayGrowthCount	object	The daily increment of the number of empty files. Empty files are those with a size of 0 MB.
Name	string	The name of the metric.	emptyFileDayGrowthCount
Value	long	The value of the metric.	114
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth count of empty files
HotDataDayGrowthSize	object	The daily increment of the amount of hot data. Hot data refers to data that is accessed in previous seven days.
Name	string	The name of the metric.	hotDataDayGrowthSize
Value	long	The value of the metric.	123154
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Day growth size of hot data
WarmDataDayGrowthSize	object	The daily increment of the amount of warm data. Warm data refers to data that is not accessed for more than 7 days but is accessed in previous 30 days.
Name	string	The name of the metric.	warmDataDayGrowthSize
Value	long	The value of the metric.	-64806998319
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Day growth size of warm data
ColdDataDayGrowthSize	object	The daily increment of the amount of cold data. Cold data refers to data that is not accessed for more than 30 days but is accessed in previous 90 days.
Name	string	The name of the metric.	coldDataDayGrowthSize
Value	long	The value of the metric.	-182636577752
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Day growth size of cold data
FreezeDataDayGrowthSize	object	The daily increment of the amount of very cold data. Very cold data refers to data that is not accessed for more than 90 days.
Name	string	The name of the metric.	freezeDataDayGrowthSize
Value	long	The value of the metric.	-167683929450
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Day growth size of freeze data
TotalDataDayGrowthSize	object	The daily incremental of the total amount of data.
Name	string	The name of the metric.	totalDataDayGrowthSize
Value	long	The value of the metric.	256482228248
Unit	string	The unit of the metric.	MB
Description	string	The description of the metric.	Day growth size of total data
TotalFileCountDayGrowthRatio	object	The day-to-day growth rate of the total number of files.
Name	string	The name of the metric.	totalFileCountDayGrowthRatio
Value	float	The value of the metric.	0.02
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of total files
LargeFileCountDayGrowthRatio	object	The day-to-day growth rate of the number of large files. Large files are those with a size greater than 1 GB.
Name	string	The name of the metric.	largeFileCountDayGrowthRatio
Value	float	The value of the metric.	0.39
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of large files
MediumFileCountDayGrowthRatio	object	The day-to-day growth rate of the number of medium files. Medium files are those with a size greater than or equal to 128 MB and less than or equal to 1 GB.
Name	string	The name of the metric.	mediumFileCountDayGrowthRatio
Value	float	The value of the metric.	0.19
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of medium files
SmallFileCountDayGrowthRatio	object	The day-to-day growth rate of the number of small files. Small files are those with a size greater than or equal to 10 MB and less than 128 MB.
Name	string	The name of the metric.	smallFileCountDayGrowthRatio
Value	float	The value of the metric.	0.02
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of small files
TinyFileCountDayGrowthRatio	object	The day-to-day growth rate of the number of very small files. Very small files are those with a size greater than 0 MB and less than 10 MB.
Name	string	The name of the metric.	tinyFileCountDayGrowthRatio
Value	float	The value of the metric.	0.003
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of tiny files
EmptyFileCountDayGrowthRatio	object	The day-to-day growth rate of the number of empty files. Empty files are those with a size of 0 MB.
Name	string	The name of the metric.	emptyFileCountDayGrowthRatio
Value	float	The value of the metric.	0.005
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of empty files
HotDataSizeDayGrowthRatio	object	The day-to-day growth rate of the amount of hot data. Hot data refers to data that is accessed in previous seven days.
Name	string	The name of the metric.	hotDataSizeDayGrowthRatio
Value	float	The value of the metric.	0.1114
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of hot data size
WarmDataSizeDayGrowthRatio	object	The day-to-day growth rate of the amount of warm data. Warm data refers to data that is not accessed for more than 7 days but is accessed in previous 30 days.
Name	string	The name of the metric.	warmDataSizeDayGrowthRatio
Value	float	The value of the metric.	-0.015
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of warm data size
ColdDataSizeDayGrowthRatio	object	The day-to-day growth rate of the amount of cold data. Cold data refers to data that is not accessed for more than 30 days but is accessed in previous 90 days.
Name	string	The name of the metric.	coldDataSizeDayGrowthRatio
Value	float	The value of the metric.	-0.03
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of cold data size
FreezeDataSizeDayGrowthRatio	object	The day-to-day growth rate of the amount of very cold data. Very cold data refers to data that is not accessed for more than 90 days.
Name	string	The name of the metric.	freezeDataSizeDayGrowthRatio
Value	float	The value of the metric.	-0.09
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of freeze data size
TotalDataSizeDayGrowthRatio	object	The day-to-day growth rate of the total data volume.
Name	string	The name of the metric.	totalDataSizeDayGrowthRatio
Value	float	The value of the metric.	0.14
Unit	string	The unit of the metric.	”“
Description	string	The description of the metric.	Day growth ratio of total data size
RequestId	string	The request ID.	DD6B1B2A-5837-5237-ABE4-FF0C8944****

Examples

Sample success responses

JSONformat

{
  "Data": {
    "Depth": 2,
    "User": "DW",
    "Group": "DW",
    "Metrics": {
      "TotalFileCount": {
        "Name": "totalFileCount",
        "Value": 51683279,
        "Unit": "”“",
        "Description": "Number of total files\n"
      },
      "LargeFileCount": {
        "Name": "largeFileCount",
        "Value": 123,
        "Unit": "”“",
        "Description": "Number of large files\n"
      },
      "MediumFileCount": {
        "Name": "mediumFileCount",
        "Value": 234,
        "Unit": "”“",
        "Description": "Number of medium files\n"
      },
      "SmallFileCount": {
        "Name": "smallFileCount",
        "Value": 12345,
        "Unit": "”“",
        "Description": "Number of small files\n"
      },
      "TinyFileCount": {
        "Name": "tinyFileCount",
        "Value": 232131,
        "Unit": "”“\n",
        "Description": "Number of tiny files\n"
      },
      "EmptyFileCount": {
        "Name": "emptyFileCount",
        "Value": 15595897,
        "Unit": "”“",
        "Description": "Number of empty files\n"
      },
      "HotDataSize": {
        "Name": "hotDataSize",
        "Value": 6701531944206,
        "Unit": "MB",
        "Description": "Size of the hot data size\n"
      },
      "WarmDataSize": {
        "Name": "warmDataSize",
        "Value": 4062349775577,
        "Unit": "MB",
        "Description": "Size of the warm data size"
      },
      "ColdDataSize": {
        "Name": "coldDataSize",
        "Value": 5570958082267,
        "Unit": "MB",
        "Description": "Size of the cold data size\n"
      },
      "FreezeDataSize": {
        "Name": "freezeDataSize",
        "Value": 1231312431,
        "Unit": "MB",
        "Description": "Size of the freeze data size\n"
      },
      "TotalDataSize": {
        "Name": "totalDataSize\n",
        "Value": 62086342083623,
        "Unit": "MB",
        "Description": "Total data size in megabytes (MB)\n"
      },
      "TotalFileDayGrowthCount": {
        "Name": "totalFileDayGrowthCount",
        "Value": 27809,
        "Unit": "”“",
        "Description": "Day growth count of total files\n"
      },
      "LargeFileDayGrowthCount": {
        "Name": "largeFileDayGrowthCount",
        "Value": 2,
        "Unit": "”“",
        "Description": "Day growth count of large files\n"
      },
      "MediumFileDayGrowthCount": {
        "Name": "mediumFileDayGrowthCount",
        "Value": 176,
        "Unit": "”“",
        "Description": "Day growth count of medium files\n"
      },
      "SmallFileDayGrowthCount": {
        "Name": "smallFileDayGrowthCount",
        "Value": 12345,
        "Unit": "”“",
        "Description": "Day growth count of small files\n"
      },
      "TinyFileDayGrowthCount": {
        "Name": "tinyFileDayGrowthCount",
        "Value": -123,
        "Unit": "”“\n",
        "Description": "Day growth count of tiny files\n"
      },
      "EmptyFileDayGrowthCount": {
        "Name": "emptyFileDayGrowthCount\n",
        "Value": 114,
        "Unit": "”“\n",
        "Description": "Day growth count of empty files\n"
      },
      "HotDataDayGrowthSize": {
        "Name": "hotDataDayGrowthSize",
        "Value": 123154,
        "Unit": "MB\n",
        "Description": "Day growth size of hot data\n"
      },
      "WarmDataDayGrowthSize": {
        "Name": "warmDataDayGrowthSize",
        "Value": -64806998319,
        "Unit": "MB",
        "Description": "Day growth size of warm data\n"
      },
      "ColdDataDayGrowthSize": {
        "Name": "coldDataDayGrowthSize",
        "Value": -182636577752,
        "Unit": "MB",
        "Description": "Day growth size of cold data\n"
      },
      "FreezeDataDayGrowthSize": {
        "Name": "freezeDataDayGrowthSize",
        "Value": -167683929450,
        "Unit": "MB",
        "Description": "Day growth size of freeze data\n"
      },
      "TotalDataDayGrowthSize": {
        "Name": "totalDataDayGrowthSize",
        "Value": 256482228248,
        "Unit": "MB",
        "Description": "Day growth size of total data\n"
      },
      "TotalFileCountDayGrowthRatio": {
        "Name": "totalFileCountDayGrowthRatio\n",
        "Value": 0.02,
        "Unit": "”“",
        "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": "”“",
        "Description": "Day growth ratio of empty files\n"
      },
      "HotDataSizeDayGrowthRatio": {
        "Name": "hotDataSizeDayGrowthRatio",
        "Value": 0.1114,
        "Unit": "”“\n",
        "Description": "Day growth ratio of hot data size\n"
      },
      "WarmDataSizeDayGrowthRatio": {
        "Name": "warmDataSizeDayGrowthRatio",
        "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": "”“\n",
        "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****"
}

Error codes

HTTP status code	Error code	Error message
400	ConflictParameters	Parameters that must not be used together. %s
400	IncompleteSignature	The request signature is invalid.
400	InvalidAction	The action %s requested is invalid.
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.
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
404	ResourceNotFound	The resource not found by %s.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
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.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history