ListDoctorReports - 批量获取集群报告 - 开源大数据平台E-MapReduce

批量获取 EMR Doctor 整体分析结果报告。

接口说明

list all reports analysis by emr doctor

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

emr:ListDoctorReports

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-hangzhou
ClusterId	string	是	集群 ID。	c-b933c5aac8fe****
NextToken	string	否	标记当前开始读取的位置。	DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResults	integer	否	一次获取的最大记录数。	20

返回参数

名称	类型	描述	示例值
	object	返回数据。
Data	array<object>	报告列表。
	array<object>	报告详情。
DateTime	string	报告日期。	2023-06-29
ComponentTypes	array	组件类型列表。枚举值： compute : compute hive : hive hdfs : hdfs yarn : yarn oss : oss hbase : hbase	null
	string	组件类型。取值： compute hive hdfs yarn oss hbase	compute
SummaryReport	object	报告摘要。
Score	integer	分数。	88
Summary	string	报告摘要。	[计算检测] 计算健康度分数为 88 ，健康度良好，继续加油集群中大部分任务保持健康状态集群内存利用率为：47.8% 偏低
Suggestion	string	优化建议。	计算健康度分数为 88 ，集群处于健康状态，继续保持计算任务扫描对集群中 1518 个计算任务进行了扫描，包含 209 个任务处于不健康状态，596 个任务处于亚健康状态，713 个任务处于健康状态。其中： Tez 任务 1518 个，加权平均分为 88 ，内存使用量占整体集群的 100.0% ，CPU 使用量占整体集群的 100.0% ，其中 209 个任务处于不健康状态，596 个任务处于亚健康状态；可在下面的任务明细列表中点击''查看详情''，查看存在的具体问题及解决方案。其中''低分任务算力内存时 (GBSec)Top20 ''表根据内存时使用量进行排序，由于大任务对集群整体影响可能更大，建议优先关注。内存利用率较低* 集群整体内存利用率为 47.8% ，内存利用率较低，计算资源存在浪费，建议优先对内存算力时较大且内存利用率较低的 TOP 任务进行优化其中，Tez作业平均内存利用率为 47.8% ，
RequestId	string	请求 ID。	DD6B1B2A-5837-5237-ABE4-FF0C8944****
NextToken	string	返回读取到的数据位置。	DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResults	integer	本次请求所返回的最大记录条数。	20
TotalCount	integer	本次请求条件下的数据总量。	200

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "DateTime": "2023-06-29",
      "ComponentTypes": [
        "compute"
      ],
      "SummaryReport": {
        "Score": 88,
        "Summary": " [计算检测]  计算健康度分数为 88 ，健康度良好，继续加油 
集群中大部分任务保持健康状态 
集群内存利用率为：47.8% 偏低 ",
        "Suggestion": " 计算健康度分数为 88 ，集群处于健康状态，继续保持 
计算任务扫描
对集群中 1518 个计算任务进行了扫描，包含 209 个任务处于不健康状态 ，596 个任务处于亚健康状态 ，713 个任务处于健康状态。 其中：
       Tez 任务 1518 个，加权平均分为 88 ，内存使用量占整体集群的 100.0% ，CPU 使用量占整体集群的 100.0% ，其中 209 个任务处于不健康状态，596 个任务处于亚健康状态；可在下面的任务明细列表中点击''查看详情''，查看存在的具体问题及解决方案。其中''低分任务算力内存时 (GB*Sec)Top20 ''表根据内存时使用量进行排序，由于大任务对集群整体影响可能更大，建议优先关注。
内存利用率较低
集群整体内存利用率为 47.8% ，内存利用率较低，计算资源存在浪费，建议优先对内存算力时较大且内存利用率较低的 TOP 任务进行优化
其中，Tez作业平均内存利用率为 47.8% ， "
      }
    }
  ],
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "NextToken": "DD6B1B2A-5837-5237-ABE4-FF0C89568980",
  "MaxResults": 20,
  "TotalCount": 200
}

错误码

HTTP status code	错误码	错误信息	描述
400	ConflictParameters	Parameters that must not be used together. %s	多个参数间存在冲突。
400	IncompleteSignature	The request signature is invalid.	API请求签名不合法。
400	InvalidAction	The action %s requested is invalid.	不合法的Action。
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.	缺少Action参数
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.	请求超时或者服务不可用。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。