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

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
emr:GetDoctorHDFSDirectory	get	All Resources ``	none	none

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