全部產品
Search
文件中心

Database Autonomy Service:GetInstanceGroupInspectReportList

更新時間:Jun 25, 2026

用於查詢DAS Agent生成的維運報告列表。

介面說明

開啟 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

*All Resource

*

無 無

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

GroupId

string

否

保留參數。

null

AgentId

string

否

可選,預設使用預設 Agent 進行服務,或者傳入開啟 DASAgent 服務後生成的或者主動建立的 Agent。

ag-472T0DxtmjIxxxxx

StartTime

integer

是

開始時間戳。

1596177993000

EndTime

integer

是

結束時間戳。

1655427625000

返回參數

名稱

類型

描述

樣本值

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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。