All Products
Search
Document Center

E-MapReduce:GetDoctorHDFSCluster

Last Updated:Oct 17, 2024

Obtains the analysis results of the Hadoop Distributed File System (HDFS) storage resources of a cluster on E-MapReduce (EMR) Doctor.

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.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID.

cn-hangzhou
ClusterIdstringYes

The cluster ID.

c-b933c5aac8fe****
DateTimestringYes

Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023.

2023-01-01

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

Dataobject

The HDFS analysis results.

Metricsobject

The metric information.

LargeFileCountobject

The number of large files. Large files are those with a size greater than 1 GB.

Namestring

The name of the metric.

largeFileCount
Valuelong

The value of the metric.

123
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of large files
MediumFileCountobject

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.

Namestring

The name of the metric.

mediumFileCount
Valuelong

The value of the metric.

234
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of medium files
SmallFileCountobject

The number of small files. Small files are those with a size greater than or equal to 10 MB and less than 128 MB.

Namestring

The name of the metric.

smallFileCount
Valuelong

The value of the metric.

12345
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of small files
TinyFileCountobject

The number of very small files. Very small files are those with a size greater than 0 MB and less than 10 MB.

Namestring

The name of the metric.

tinyFileCount
Valuelong

The value of the metric.

232131
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of tiny files
EmptyFileCountobject

The number of empty files. Empty files are those with a size of 0 MB.

Namestring

The name of the metric.

emptyFileCount
Valuelong

The value of the metric.

15595897
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of empty files
TotalFileCountobject

The total number of files.

Namestring

The name of the metric.

totalFileCount
Valuelong

The value of the metric.

51683279
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Number of total files
HotDataSizeobject

The amount of hot data. Hot data refers to data that is accessed in recent seven days.

Namestring

The name of the metric.

hotDataSize
Valuelong

The value of the metric.

6701531944206
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the hot data size
WarmDataSizeobject

The amount of warm data. Warm data refers to data that is not accessed for more than 7 days but is accessed in 30 days.

Namestring

The name of the metric.

warmDataSize
Valuelong

The value of the metric.

4062349775577
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the warm data size
ColdDataSizeobject

The amount of cold data. Cold data refers to data that is not accessed for more than 30 days but is accessed in 90 days.

Namestring

The name of the metric.

coldDataSize
Valuelong

The value of the metric.

5570958082267
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the cold data size
FreezeDataSizeobject

The amount of very cold data. Very cold data refers to data that is not accessed for more than 90 days.

Namestring

The name of the metric.

freezeDataSize
Valuelong

The value of the metric.

1231312431
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Size of the freeze data size
TotalDataSizeobject

The total amount of data.

Namestring

The name of the metric.

totalDataSize
Valuelong

The value of the metric.

62086342083623
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Total data size in megabytes (MB)
LargeFileRatioobject

The proportion of large files. Large files are those with a size greater than 1 GB.

Namestring

The name of the metric.

largeFileRatio
Valuefloat

The value of the metric.

0.22
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of large files
MediumFileRatioobject

The proportion 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.

Namestring

The name of the metric.

mediumFileRatio
Valuefloat

The value of the metric.

0.21
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of medium files
SmallFileRatioobject

The proportion of small files. Small files are those with a size greater than or equal to 10 MB and less than 128 MB.

Namestring

The name of the metric.

smallFileRatio
Valuefloat

The value of the metric.

0.19
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of small files
TinyFileRatioobject

The proportion of very small files. Very small files are those with a size greater than 0 MB and less than 10 MB.

Namestring

The name of the metric.

tinyFileRatio
Valuefloat

The value of the metric.

0.19
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of tiny files
EmptyFileRatioobject

The proportion of empty files. Empty files are those with a size of 0 MB.

Namestring

The name of the metric.

emptyFileRatio
Valuefloat

The value of the metric.

0.3
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Ratio of empty files
HotDataRatioobject

The proportion of hot data. Hot data refers to data that is accessed in recent seven days.

Namestring

The name of the metric.

hotDataRatio
Valuefloat

The value of the metric.

0.22
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Hot data ratio
WarmDataRatioobject

The proportion of warm data. Warm data refers to data that is not accessed for more than 7 days but is accessed in 30 days.

Namestring

The name of the metric.

warmDataRatio
Valuefloat

The value of the metric.

0.12
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of warm data
ColdDataRatioobject

The proportion of cold data. Cold data refers to data that is not accessed for more than 30 days but is accessed in 90 days.

Namestring

The name of the metric.

coldDataRatio
Valuefloat

The value of the metric.

0.01
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Cold data ratio
FreezeDataRatioobject

The proportion of very cold data. Very cold data refers to data that is not accessed for more than 90 days.

Namestring

The name of the metric.

freezeDataRatio
Valuefloat

The value of the metric.

0.12
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Ratio of freeze data
TotalFileDayGrowthCountobject

The daily increment of the total number of files.

Namestring

The name of the metric.

totalFileDayGrowthCount
Valuelong

The value of the metric.

27809
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Day growth count of total files
LargeFileDayGrowthCountobject

The daily increment of the number of large files. Large files are those with a size greater than 1 GB.

Namestring

The name of the metric.

largeFileDayGrowthCount
Valuelong

The value of the metric.

2
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Day growth count of large files
MediumFileDayGrowthCountobject

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.

Namestring

The name of the metric.

mediumFileDayGrowthCount
Valuelong

The value of the metric.

176
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth count of medium files
SmallFileDayGrowthCountobject

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.

Namestring

The name of the metric.

smallFileDayGrowthCount
Valuelong

The value of the metric.

12321
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth count of small files
TinyFileDayGrowthCountobject

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.

Namestring

The name of the metric.

tinyFileDayGrowthCount
Valuelong

The value of the metric.

-123
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth count of tiny files
EmptyFileDayGrowthCountobject

The daily increment of the number of empty files. Empty files are those with a size of 0 MB.

Namestring

The name of the metric.

emptyFileDayGrowthCount
Valuelong

The value of the metric.

114
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth count of empty files
HotDataDayGrowthSizeobject

The daily increment of the amount of hot data. Hot data refers to data that is accessed in recent seven days.

Namestring

The name of the metric.

hotDataDayGrowthSize
Valuelong

The value of the metric.

123154
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Day growth size of hot data
WarmDataDayGrowthSizeobject

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 30 days.

Namestring

The name of the metric.

warmDataDayGrowthSize
Valuelong

The value of the metric.

-64806998319
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Day growth size of warm data
ColdDataDayGrowthSizeobject

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 90 days.

Namestring

The name of the metric.

coldDataDayGrowthSize
Valuelong

The value of the metric.

-182636577752
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Day growth size of cold data
FreezeDataDayGrowthSizeobject

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.

Namestring

The name of the metric.

freezeDataDayGrowthSize
Valuelong

The value of the metric.

-167683929450
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Day growth size of freeze data
TotalDataDayGrowthSizeobject

The daily incremental of the total data volume.

Namestring

The name of the metric.

totalDataDayGrowthSize
Valuelong

The value of the metric.

256482228248
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Day growth size of total data
TotalFileCountDayGrowthRatioobject

The day-to-day growth rate of the total number of files.

Namestring

The name of the metric.

totalFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.02
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of total files
LargeFileCountDayGrowthRatioobject

The day-to-day growth rate of the number of large files. Large files are those with a size greater than 1 GB.

Namestring

The name of the metric.

largeFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.39
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of large files
MediumFileCountDayGrowthRatioobject

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.

Namestring

The name of the metric.

mediumFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.19
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of medium files
SmallFileCountDayGrowthRatioobject

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.

Namestring

The name of the metric.

smallFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.02
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of small files
TinyFileCountDayGrowthRatioobject

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.

Namestring

The name of the metric.

tinyFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.003
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of tiny files
EmptyFileCountDayGrowthRatioobject

The day-to-day growth rate of the number of empty files. Empty files are those with a size of 0 MB.

Namestring

The name of the metric.

emptyFileCountDayGrowthRatio
Valuefloat

The value of the metric.

0.005
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of empty files
HotDataSizeDayGrowthRatioobject

The day-to-day growth rate of the amount of hot data. Hot data refers to data that is accessed in recent seven days.

Namestring

The name of the metric.

hotDataSizeDayGrowthRatio
Valuefloat

The value of the metric.

0.1114
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of hot data size
WarmDataSizeDayGrowthRatioobject

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 30 days.

Namestring

The name of the metric.

warmDataSizeDayGrowthRatio
Valuefloat

The value of the metric.

-0.015
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of warm data size
ColdDataSizeDayGrowthRatioobject

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 90 days.

Namestring

The name of the metric.

coldDataSizeDayGrowthRatio
Valuefloat

The value of the metric.

-0.03
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of cold data size
FreezeDataSizeDayGrowthRatioobject

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.

Namestring

The name of the metric.

freezeDataSizeDayGrowthRatio
Valuefloat

The value of the metric.

-0.09
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of freeze data size
TotalDataSizeDayGrowthRatioobject

The day-to-day growth rate of the total data volume.

Namestring

The name of the metric.

totalDataSizeDayGrowthRatio
Valuefloat

The value of the metric.

0.14
Unitstring

The unit of the metric.

”“
Descriptionstring

The description of the metric.

Day growth ratio of total data size
Analysisobject

The analysis results.

HdfsScoreinteger

The overall score of HDFS storage resources.

55
RequestIdstring

The request ID.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

Examples

Sample success responses

JSONformat

{
  "Data": {
    "Metrics": {
      "LargeFileCount": {
        "Name": "largeFileCount",
        "Value": 123,
        "Unit": "”“",
        "Description": "Number of large files"
      },
      "MediumFileCount": {
        "Name": "mediumFileCount",
        "Value": 234,
        "Unit": "”“",
        "Description": "Number of medium files"
      },
      "SmallFileCount": {
        "Name": "smallFileCount",
        "Value": 12345,
        "Unit": "”“",
        "Description": "Number of small files"
      },
      "TinyFileCount": {
        "Name": "tinyFileCount",
        "Value": 232131,
        "Unit": "”“",
        "Description": "Number of tiny files"
      },
      "EmptyFileCount": {
        "Name": "emptyFileCount",
        "Value": 15595897,
        "Unit": "”“",
        "Description": "Number of empty files"
      },
      "TotalFileCount": {
        "Name": "totalFileCount",
        "Value": 51683279,
        "Unit": "”“",
        "Description": "Number of total files"
      },
      "HotDataSize": {
        "Name": "hotDataSize",
        "Value": 6701531944206,
        "Unit": "MB",
        "Description": "Size of the hot data size"
      },
      "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"
      },
      "FreezeDataSize": {
        "Name": "freezeDataSize",
        "Value": 1231312431,
        "Unit": "MB",
        "Description": "Size of the freeze data size"
      },
      "TotalDataSize": {
        "Name": "totalDataSize",
        "Value": 62086342083623,
        "Unit": "MB",
        "Description": "Total data size in megabytes (MB)"
      },
      "LargeFileRatio": {
        "Name": "largeFileRatio",
        "Value": 0.22,
        "Unit": "”“",
        "Description": "Ratio of large files"
      },
      "MediumFileRatio": {
        "Name": "mediumFileRatio",
        "Value": 0.21,
        "Unit": "”“",
        "Description": "Ratio of medium files"
      },
      "SmallFileRatio": {
        "Name": "smallFileRatio",
        "Value": 0.19,
        "Unit": "”“",
        "Description": "Ratio of small files"
      },
      "TinyFileRatio": {
        "Name": "tinyFileRatio",
        "Value": 0.19,
        "Unit": "”“",
        "Description": "Ratio of tiny files"
      },
      "EmptyFileRatio": {
        "Name": "emptyFileRatio",
        "Value": 0.3,
        "Unit": "\"\"",
        "Description": "Ratio of empty files"
      },
      "HotDataRatio": {
        "Name": "hotDataRatio",
        "Value": 0.22,
        "Unit": "”“",
        "Description": "Hot data ratio"
      },
      "WarmDataRatio": {
        "Name": "warmDataRatio",
        "Value": 0.12,
        "Unit": "”“",
        "Description": "Ratio of warm data"
      },
      "ColdDataRatio": {
        "Name": "coldDataRatio",
        "Value": 0.01,
        "Unit": "”“",
        "Description": "Cold data ratio"
      },
      "FreezeDataRatio": {
        "Name": "freezeDataRatio",
        "Value": 0.12,
        "Unit": "”“",
        "Description": "Ratio of freeze data"
      },
      "TotalFileDayGrowthCount": {
        "Name": "totalFileDayGrowthCount",
        "Value": 27809,
        "Unit": "“”",
        "Description": "Day growth count of total files"
      },
      "LargeFileDayGrowthCount": {
        "Name": "largeFileDayGrowthCount",
        "Value": 2,
        "Unit": "“”",
        "Description": "Day growth count of large files"
      },
      "MediumFileDayGrowthCount": {
        "Name": "mediumFileDayGrowthCount",
        "Value": 176,
        "Unit": "”“",
        "Description": "Day growth count of medium files"
      },
      "SmallFileDayGrowthCount": {
        "Name": "smallFileDayGrowthCount",
        "Value": 12321,
        "Unit": "”“",
        "Description": "Day growth count of small files"
      },
      "TinyFileDayGrowthCount": {
        "Name": "tinyFileDayGrowthCount",
        "Value": -123,
        "Unit": "”“",
        "Description": "Day growth count of tiny files"
      },
      "EmptyFileDayGrowthCount": {
        "Name": "emptyFileDayGrowthCount",
        "Value": 114,
        "Unit": "”“",
        "Description": "Day growth count of empty files"
      },
      "HotDataDayGrowthSize": {
        "Name": "hotDataDayGrowthSize",
        "Value": 123154,
        "Unit": "MB",
        "Description": "Day growth size of hot data"
      },
      "WarmDataDayGrowthSize": {
        "Name": "warmDataDayGrowthSize",
        "Value": -64806998319,
        "Unit": "MB",
        "Description": "Day growth size of warm data"
      },
      "ColdDataDayGrowthSize": {
        "Name": "coldDataDayGrowthSize",
        "Value": -182636577752,
        "Unit": "MB",
        "Description": "Day growth size of cold data"
      },
      "FreezeDataDayGrowthSize": {
        "Name": "freezeDataDayGrowthSize",
        "Value": -167683929450,
        "Unit": "MB",
        "Description": "Day growth size of freeze data"
      },
      "TotalDataDayGrowthSize": {
        "Name": "totalDataDayGrowthSize",
        "Value": 256482228248,
        "Unit": "MB",
        "Description": "Day growth size of total data"
      },
      "TotalFileCountDayGrowthRatio": {
        "Name": "totalFileCountDayGrowthRatio",
        "Value": 0.02,
        "Unit": "”“",
        "Description": "Day growth ratio of total files"
      },
      "LargeFileCountDayGrowthRatio": {
        "Name": "largeFileCountDayGrowthRatio",
        "Value": 0.39,
        "Unit": "”“",
        "Description": "Day growth ratio of large files"
      },
      "MediumFileCountDayGrowthRatio": {
        "Name": "mediumFileCountDayGrowthRatio",
        "Value": 0.19,
        "Unit": "”“",
        "Description": "Day growth ratio of medium files"
      },
      "SmallFileCountDayGrowthRatio": {
        "Name": "smallFileCountDayGrowthRatio",
        "Value": 0.02,
        "Unit": "”“",
        "Description": "Day growth ratio of small files"
      },
      "TinyFileCountDayGrowthRatio": {
        "Name": "tinyFileCountDayGrowthRatio",
        "Value": 0.003,
        "Unit": "”“",
        "Description": "Day growth ratio of tiny files"
      },
      "EmptyFileCountDayGrowthRatio": {
        "Name": "emptyFileCountDayGrowthRatio",
        "Value": 0.005,
        "Unit": "”“",
        "Description": "Day growth ratio of empty files"
      },
      "HotDataSizeDayGrowthRatio": {
        "Name": "hotDataSizeDayGrowthRatio",
        "Value": 0.1114,
        "Unit": "”“",
        "Description": "Day growth ratio of hot data size"
      },
      "WarmDataSizeDayGrowthRatio": {
        "Name": "warmDataSizeDayGrowthRatio",
        "Value": -0.015,
        "Unit": "”“",
        "Description": "Day growth ratio of warm data size"
      },
      "ColdDataSizeDayGrowthRatio": {
        "Name": "coldDataSizeDayGrowthRatio",
        "Value": -0.03,
        "Unit": "”“",
        "Description": "Day growth ratio of cold data size"
      },
      "FreezeDataSizeDayGrowthRatio": {
        "Name": "freezeDataSizeDayGrowthRatio",
        "Value": -0.09,
        "Unit": "”“",
        "Description": "Day growth ratio of freeze data size"
      },
      "TotalDataSizeDayGrowthRatio": {
        "Name": "totalDataSizeDayGrowthRatio",
        "Value": 0.14,
        "Unit": "”“",
        "Description": "Day growth ratio of total data size"
      }
    },
    "Analysis": {
      "HdfsScore": 55
    }
  },
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Error codes

HTTP status codeError codeError message
400ConflictParametersParameters that must not be used together. %s
400IncompleteSignatureThe request signature is invalid.
400InvalidActionThe action %s requested is invalid.
400InvalidParameterThe specified parameter %s is not valid.
400InvalidParameterValueThe input parameter %s is invalid or out of range.
400MissingActionThe action %s requested is missing.
400MissingParameterThe input parameter %s that is mandatory for processing this request is not supplied.
400NotAuthorizedYou do not have permission to perform this action. %s
400ThrottlingExceptionThe request was denied due to request throttling. %s
404ResourceNotFoundThe resource not found by %s.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.
503ServiceFailureThe request has failed due to a temporary failure of %s service.
503ServiceUnavailableThe 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 timeSummary of changesOperation
No change history