EMR Doctor を使用して、特定のディレクトリのバッチ分析結果を取得します。ディレクトリの深さは 5 レベルを超えることはできません。
操作説明
HDFS ディレクトリの分析結果をクエリします。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
emr:ListDoctorHDFSDirectories |
list |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
リージョン ID。 |
cn-hangzhou |
| ClusterId |
string |
必須 |
クラスター ID。 |
c-b933c5aac8fe**** |
| NextToken |
string |
任意 |
次のクエリを開始するために使用されるトークン。 |
DD6B1B2A-5837-5237-ABE4-FF0C89568980 |
| MaxResults |
integer |
任意 |
各ページで返されるエントリの最大数。 |
20 |
| DateTime |
string |
必須 |
日付。値は ISO 8601 フォーマットです。たとえば、`2023-01-01` は 2023 年 1 月 1 日を表します。 |
2023-01-01 |
| DirPath |
string |
任意 |
ディレクトリのパス。ディレクトリの深さは 5 レベルを超えることはできません。このパラメーターを指定しない場合、すべてのディレクトリの分析結果が返されます。 |
/tmp/test |
| OrderType |
string |
任意 |
ソート順。有効な値:
|
ASC |
| OrderBy |
string |
任意 |
クエリ結果のソート基準となるプロパティ。有効な値:
|
smallFileCount |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
返されたデータ |
||
| Data |
array<object> |
HDFS ディレクトリのバッチ分析の分析データ。 |
|
|
object |
HDFS ディレクトリの分析データ。 |
||
| DirPath |
string |
ディレクトリ名。 |
/tmp/test |
| 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 |
large ファイルの数。large ファイルは、サイズが 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 |
メトリックの値。 |
323 |
| Unit |
string |
メトリックの単位。 |
”“ |
| Description |
string |
メトリックの説明です。 |
Number of medium files |
| SmallFileCount |
object |
small ファイルの数。small ファイルは、サイズが 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 |
ウォームデータのサイズ。ウォームデータは、過去 30 日以内にアクセスされたものの、過去 7 日以内にはアクセスされていないデータです。 |
|
| 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 |
合計ファイル数の日次増加数。 |
|
| 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 |
極小ファイル数の日次増加。極小ファイルとは、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 |
フリーズデータの日次増加サイズ。フリーズデータは、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**** |
| NextToken |
string |
次の読み取りの開始位置。 |
DD6B1B2A-5837-5237-ABE4-FF0C89568980 |
| MaxResults |
integer |
返されるレコードの最大数。 |
20 |
| TotalCount |
integer |
リクエストに一致するエントリーの総数。 |
200 |
例
成功レスポンス
JSONJSON
{
"Data": [
{
"DirPath": "/tmp/test",
"Depth": 2,
"User": "DW",
"Group": "DW",
"Metrics": {
"TotalFileCount": {
"Name": "totalFileCount",
"Value": 51683279,
"Unit": "”“\n",
"Description": "Number of total files\n"
},
"LargeFileCount": {
"Name": "largeFileCount",
"Value": 123,
"Unit": "”“\n",
"Description": "Number of large files\n"
},
"MediumFileCount": {
"Name": "mediumFileCount",
"Value": 323,
"Unit": "”“\n",
"Description": "Number of medium files\n"
},
"SmallFileCount": {
"Name": "smallFileCount",
"Value": 12345,
"Unit": "”“\n",
"Description": "Number of small files\n"
},
"TinyFileCount": {
"Name": "tinyFileCount\n",
"Value": 232131,
"Unit": "\"\"",
"Description": "Number of tiny files"
},
"EmptyFileCount": {
"Name": "emptyFileCount",
"Value": 15595897,
"Unit": "”“\n",
"Description": "Number of empty files"
},
"HotDataSize": {
"Name": "hotDataSize",
"Value": 6701531944206,
"Unit": "MB\n",
"Description": "Size of the hot data size\n"
},
"WarmDataSize": {
"Name": "warmDataSize\n",
"Value": 4062349775577,
"Unit": "MB\n",
"Description": "Size of the warm data size\n"
},
"ColdDataSize": {
"Name": "coldDataSize",
"Value": 5570958082267,
"Unit": "MB",
"Description": "Size of the cold data size\n"
},
"FreezeDataSize": {
"Name": "freezeDataSize",
"Value": 1231312431,
"Unit": "MB\n",
"Description": "Size of the freeze data size\n"
},
"TotalDataSize": {
"Name": "totalDataSize",
"Value": 62086342083623,
"Unit": "MB\n",
"Description": "Total data size in megabytes (MB)\n"
},
"TotalFileDayGrowthCount": {
"Name": "totalFileDayGrowthCount",
"Value": 27809,
"Unit": "”“\n",
"Description": "Day growth count of total files\n"
},
"LargeFileDayGrowthCount": {
"Name": "largeFileDayGrowthCount",
"Value": 2,
"Unit": "”“\n",
"Description": "Day growth count of large files\n"
},
"MediumFileDayGrowthCount": {
"Name": "mediumFileDayGrowthCount",
"Value": 176,
"Unit": "”“\n",
"Description": "Day growth count of medium files\n"
},
"SmallFileDayGrowthCount": {
"Name": "smallFileDayGrowthCount",
"Value": 12345,
"Unit": "”“\n",
"Description": "Day growth count of small files\n"
},
"TinyFileDayGrowthCount": {
"Name": "tinyFileDayGrowthCount",
"Value": -123,
"Unit": "”“\n",
"Description": "Day growth count of tiny files"
},
"EmptyFileDayGrowthCount": {
"Name": "emptyFileDayGrowthCount",
"Value": 114,
"Unit": "”“\n",
"Description": "Day growth count of empty files\n"
},
"HotDataDayGrowthSize": {
"Name": "hotDataDayGrowthSize",
"Value": 123154,
"Unit": "MB\n",
"Description": "\t\nDay growth size of hot data\n"
},
"WarmDataDayGrowthSize": {
"Name": "warmDataDayGrowthSize",
"Value": -64806998319,
"Unit": "MB\n",
"Description": "Day growth size of warm data\n"
},
"ColdDataDayGrowthSize": {
"Name": "coldDataDayGrowthSize",
"Value": -182636577752,
"Unit": "MB\n",
"Description": "Day growth size of cold data\n"
},
"FreezeDataDayGrowthSize": {
"Name": "freezeDataDayGrowthSize",
"Value": -167683929450,
"Unit": "MB\n",
"Description": "Day growth size of freeze data\n"
},
"TotalDataDayGrowthSize": {
"Name": "totalDataDayGrowthSize",
"Value": 256482228248,
"Unit": "MB\n",
"Description": "Day growth size of total data\n"
},
"TotalFileCountDayGrowthRatio": {
"Name": "totalFileCountDayGrowthRatio\n",
"Value": 0.02,
"Unit": "”“\n",
"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": "”“\n",
"Description": "Day growth ratio of empty files"
},
"HotDataSizeDayGrowthRatio": {
"Name": "hotDataSizeDayGrowthRatio",
"Value": 0.1114,
"Unit": "”“\n",
"Description": "Day growth ratio of hot data size\n"
},
"WarmDataSizeDayGrowthRatio": {
"Name": "\t\nwarmDataSizeDayGrowthRatio\n",
"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": "”“",
"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****",
"NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
"MaxResults": 20,
"TotalCount": 200
}
エラーコード
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。