GetDoctorHDFSDirectory API の呼び出しによる HDFS ディレクトリ分析結果の取得 - E-MapReduce

クラスターの特定の Hadoop 分散ファイルシステム (HDFS) ディレクトリの分析結果を取得します。ディレクトリの深さは 5 以下である必要があります。

操作説明

Doctor HDFS ノードを取得します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

emr:GetDoctorHDFSDirectory

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	リージョン ID です。	cn-hangzhou
ClusterId	string	必須	クラスター ID です。	c-b933c5aac8fe****
DateTime	string	必須	ISO 8601 標準で日付を指定します。たとえば、2023-01-01 は 2023 年 1 月 1 日を表します。	2023-01-01
DirPath	string	必須	ディレクトリ名です。ディレクトリの深さは 5 以下である必要があります。	/tmp/test

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーターです。
Data	object	HDFS ディレクトリの分析結果です。
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	メトリックの値です。	234
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	ファイルの総数の 1 日あたりの増分です。
Name	string	メトリックの名前です。	totalFileDayGrowthCount
Value	integer	メトリックの値です。	27809
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of total files
LargeFileDayGrowthCount	object	大きいファイルの数の 1 日あたりの増分です。大きいファイルとは、サイズが 1 GB を超えるファイルです。
Name	string	メトリックの名前です。	largeFileDayGrowthCount
Value	integer	メトリックの値です。	2
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of large files
MediumFileDayGrowthCount	object	中程度のファイルの数の 1 日あたりの増分です。中程度のファイルとは、サイズが 128 MB 以上 1 GB 以下のファイルです。
Name	string	メトリックの名前です。	mediumFileDayGrowthCount
Value	integer	メトリックの値です。	176
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of medium files
SmallFileDayGrowthCount	object	小さいファイルの数の 1 日あたりの増分です。小さいファイルとは、サイズが 10 MB 以上 128 MB 未満のファイルです。
Name	string	メトリックの名前です。	smallFileDayGrowthCount
Value	integer	メトリックの値です。	12345
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of small files
TinyFileDayGrowthCount	object	非常に小さいファイルの数の 1 日あたりの増分です。非常に小さいファイルとは、サイズが 0 MB より大きく 10 MB 未満のファイルです。
Name	string	メトリックの名前です。	tinyFileDayGrowthCount
Value	integer	メトリックの値です。	-123
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of tiny files
EmptyFileDayGrowthCount	object	空のファイルの数の 1 日あたりの増分です。空のファイルとは、サイズが 0 MB のファイルです。
Name	string	メトリックの名前です。	emptyFileDayGrowthCount
Value	integer	メトリックの値です。	114
Unit	string	メトリックの単位です。	”“
Description	string	メトリックの説明です。	Day growth count of empty files
HotDataDayGrowthSize	object	ホットデータの量の 1 日あたりの増分です。ホットデータとは、過去 7 日間にアクセスされたデータを指します。
Name	string	メトリックの名前です。	hotDataDayGrowthSize
Value	integer	メトリックの値です。	123154
Unit	string	メトリックの単位です。	MB
Description	string	メトリックの説明です。	Day growth size of hot data
WarmDataDayGrowthSize	object	ウォームデータの量の 1 日あたりの増分です。ウォームデータとは、7 日を超えてアクセスされていないが、過去 30 日間にアクセスされたデータを指します。
Name	string	メトリックの名前です。	warmDataDayGrowthSize
Value	integer	メトリックの値です。	-64806998319
Unit	string	メトリックの単位です。	MB
Description	string	メトリックの説明です。	Day growth size of warm data
ColdDataDayGrowthSize	object	コールドデータの量の 1 日あたりの増分です。コールドデータとは、30 日を超えてアクセスされていないが、過去 90 日間にアクセスされたデータを指します。
Name	string	メトリックの名前です。	coldDataDayGrowthSize
Value	integer	メトリックの値です。	-182636577752
Unit	string	メトリックの単位です。	MB
Description	string	メトリックの説明です。	Day growth size of cold data
FreezeDataDayGrowthSize	object	フリーズデータの量の 1 日あたりの増分です。フリーズデータとは、90 日を超えてアクセスされていないデータを指します。
Name	string	メトリックの名前です。	freezeDataDayGrowthSize
Value	integer	メトリックの値です。	-167683929450
Unit	string	メトリックの単位です。	MB
Description	string	メトリックの説明です。	Day growth size of freeze data
TotalDataDayGrowthSize	object	データ総量の 1 日あたりの増分です。
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****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。