All Products
Search
Document Center

Elastic Compute Service:DescribeDiagnosticReports

Last Updated:Apr 11, 2024

Queries diagnostic reports.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID of the diagnostic report. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
ReportIdsarrayNo

The IDs of diagnostic reports. You can specify up to 100 report IDs.

stringNo

The ID of diagnostic report.

dr-uf6i0tv2refv8wz*****
ResourceIdsarrayNo

The IDs of resources. You can specify up to 100 resource IDs.

stringNo

The ID of resource.

i-uf6i0tv2refv8wz*****
StatusstringNo

The state of the diagnostic report. Valid values:

  • InProgress: The diagnostic is in progress.
  • Failed: The diagnostic failed.
  • Finished: The diagnostic is complete.
Finished
SeveritystringNo

The severity level of the diagnostic report. Valid values:

  • Unknown: The diagnostic has not started, failed to run, or exited unexpectedly without a diagnosis.
  • Normal: No exceptions are detected.
  • Info: Diagnostic information is recorded and may be related to exceptions.
  • Warn: Diagnostic information is recorded and may indicate exceptions.
  • Critical: Critical exceptions are detected.
Enumeration Value:
  • normal
  • info
  • warn
  • critical
  • Normal
  • Info
  • Warn
  • Critical
  • unknown
  • Unknown
Normal
NextTokenstringNo

The query token. Set the value to the NextToken value returned in the last call to the DescribeDiagnosticReports operation. Leave this parameter empty the first time you call this operation.

caeba0bbb2be03f84eb48b699f0a4883
MaxResultsintegerNo

The maximum number of entries to return on each page. Maximum value: 100.

Default value:

  • If this parameter is left empty, the default value is 10.
  • If this parameter is set to a value greater than 100, the default value is 100.
10

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

473469C7-AA6F-4DC5-B3DB-A3DC0DE*****
NextTokenstring

The query token returned in this call.

caeba0bbb2be03f84eb48b699f0a4883
Reportsobject []

The list of reports.

ResourceIdstring

The ID of the resource.

i-uf6i0tv2refv8wz*****
ResourceTypestring

The type of the resource.

instance
MetricSetIdstring

The ID of the diagnostic metric set.

dms-bp17p0qwtr72zmu*****
StartTimestring

The beginning of the reporting period of the diagnostic report. The value is the StartTime value that was passed in when you called the CreateDiagnosticReport operation to create the diagnostic report.

2022-07-11T12:00:00Z
EndTimestring

The end of the reporting period of the diagnostic report. The value is the EndTime value that was passed in when you called the CreateDiagnosticReport operation to create the diagnostic report.

2022-07-11T14:00:00Z
ReportIdstring

The ID of the diagnostic report.

dr-uf6i0tv2refv8wz*****
Statusstring

The state of the diagnostic report.

Finished
CreationTimestring

The time when the diagnostic report was created.

2022-07-11T12:00:00Z
FinishedTimestring

The time when the diagnostic was complete.

2022-07-11T14:00:00Z
Severitystring

The severity level of the diagnostic report. Valid values:

  • Unknown: The diagnostic has not started, failed to run, or exited unexpectedly without a diagnosis.
  • Normal: No exceptions were detected.
  • Info: Diagnostic information was recorded and may be related to exceptions.
  • Warn: Diagnostic information was recorded and may indicate exceptions.
  • Critical: Critical exceptions were detected.
Normal
Issuesobject []

The list of issues.

MetricIdstring

The ID of the diagnostic metric.

GuestOS.WinFirewall
MetricCategorystring

The category of the diagnostic metric.

ECSService.GuestOS
IssueIdstring

The unique ID of the diagnosed issue.

GuestOS.CPU.HighUtiliz*****
Severitystring

The severity level of the diagnostic metric. Valid values:

  • Info: Diagnostic information was recorded and may be related to exceptions.
  • Warn: Diagnostic information was recorded and may indicate exceptions.
  • Critical: Critical exceptions were detected.
Info

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE*****",
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "Reports": {
    "Report": [
      {
        "ResourceId": "i-uf6i0tv2refv8wz*****",
        "ResourceType": "instance",
        "MetricSetId": "dms-bp17p0qwtr72zmu*****",
        "StartTime": "2022-07-11T12:00:00Z",
        "EndTime": "2022-07-11T14:00:00Z",
        "ReportId": "dr-uf6i0tv2refv8wz*****",
        "Status": "Finished",
        "CreationTime": "2022-07-11T12:00:00Z",
        "FinishedTime": "2022-07-11T14:00:00Z",
        "Severity": "Normal",
        "Issues": {
          "Issue": [
            {
              "MetricId": "GuestOS.WinFirewall",
              "MetricCategory": "ECSService.GuestOS",
              "IssueId": "GuestOS.CPU.HighUtiliz*****",
              "Severity": "Info"
            }
          ]
        }
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2022-07-21Add Operationsee changesets