GetInstanceGroupInspectReportList查询DAS Agent运维报告列表-数据库自治服务-阿里云-数据库自治服务(DAS)-阿里云帮助中心

接口说明

开启 DAS Agent 的运维报告功能可让系统对目标实例进行定期巡检并给出报告。当前仅支持生成日报。

使用该接口需满足以下前提条件：

用户开通 DAS Agent 并且该 Agent 仍在有效期。
用户在 DAS Agent 的配置页面，开启日报功能。
在使用阿里云 SDK 时，需要保证 aliyun-sdk-core 的版本大于 4.3.3，建议使用最新版本。
使用 DAS 的 SDK 的版本为 1.0.3 或以上。
在使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

hdm:GetInstanceGroupInspectReportList

get

*全部资源

*

无

请求语法

POST  HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
GroupId	string	否	保留参数	null
AgentId	string	否	可选，默认使用默认 Agent 进行服务，或者传入开启 DASAgent 服务后生成的或者主动创建的 Agent	ag-472T0DxtmjIxxxxx
StartTime	integer	是	开始时间戳	1596177993000
EndTime	integer	是	结束时间戳	1655427625000
ReportType	string	否

返回参数

名称	类型	描述	示例值
	object	Schema of Response
Code	string	返回的状态码。	200
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）。	Successful
RequestId	string	请求 ID。	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	请求是否执行成功： true：执行成功。 false：执行失败。	true
Data	array<object>	List
	object	详细信息列表，报告 ID、任务日期、任务状态。
ReportId	string	报告 ID	13f52040-5a6e-42c3-bb84-051f5d6d****
Status	string	任务状态 WAITING_UNREADY = 0 WAITING_READY = 1 PROCESSING = 2 FINISHED = 3 ERROR = 4 STOPPED = -1	3
ReportDate	string	诊断的日期	2025-12-10
CreateTime	string	任务创建时间。	2025-12-11 00:39:00

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": [
    {
      "ReportId": "13f52040-5a6e-42c3-bb84-051f5d6d****",
      "Status": "3",
      "ReportDate": "2025-12-10",
      "CreateTime": "2025-12-11 00:39:00"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

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

变更历史

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