Gunakan GetDoctorHDFSDirectory API untuk mendapatkan hasil analisis direktori HDFS - E-MapReduce - Alibaba Cloud - E-MapReduce

Mengambil hasil analisis direktori Hadoop Distributed File System (HDFS) tertentu pada kluster. Kedalaman direktori tidak lebih dari lima.

Deskripsi operasi

get Doctor HDFSNode

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

emr:GetDoctorHDFSDirectory

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
ClusterId	string	Yes	ID kluster.	c-b933c5aac8fe****
DateTime	string	Yes	Tanggal dalam standar ISO 8601. Misalnya, 2023-01-01 mewakili 1 Januari 2023.	2023-01-01
DirPath	string	Yes	Nama direktori. Kedalaman direktori tidak lebih dari lima.	/tmp/test

Elemen respons

Element	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	integer	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	number	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	number	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	number	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	number	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	number	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	number	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	number	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	number	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	number	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	number	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	number	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****

Contoh

Respons sukses

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****"
}

Kode kesalahan

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

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.