Help Center/ Data Admin Service/ API Reference/ APIs (in OBT)/ Intelligent O&M/ Querying the Risk Trend of an Instance
Updated on 2025-11-26 GMT+08:00

Querying the Risk Trend of an Instance

Function

This API is used to query the risk trend of an instance.

Authorization Information

Each account has permissions to call all APIs, but IAM users must have the required permissions specifically assigned.

  • If you are using role/policy-based authorization, see the required permissions in Permissions Policies and Supported Actions.
  • If you are using identity policy-based authorization, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: Required)

    Condition Key

    Alias

    Dependency

    das::showCloudDBAInfo

    read

    -

    -

    -

    -

URI

GET /v3/{project_id}/instances/risk-trend

Table 1 URI parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Explanation:

Project ID of a tenant in a region.

To obtain this value, see Obtaining a Project ID.

Constraints:

N/A

Values:

The value can contain 32 characters. Only letters and digits are allowed.

Default value:

N/A

Table 2 Query parameters

Parameter

Mandatory

Type

Description

datastore_type

Yes

String

Explanation:

Database type

Constraints:

N/A

Values:

  • MySQL
  • TaurusDB
  • PostgreSQL
  • Microsoft SQL Server

Default value:

N/A

start_at

Yes

Long

Explanation:

Start time

Constraints:

Unix timestamp, in milliseconds

Values:

[0, 2^31-1]. The actual value depends on the query result.

Default value:

N/A

end_at

Yes

Long

Explanation:

End time

Constraints:

Unix timestamp, in milliseconds

Values:

[0, 2^31-1]. The actual value depends on the query result.

Default value:

N/A

metric_code

Yes

String

Explanation:

Metric code

Constraints:

N/A

Values:

N/A

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

metric_code

String

Explanation:

Metric code

Values:

N/A

metric

Objects in Table 4

Explanation:

Metric

Values:

N/A

Table 4 metric

Parameter

Type

Description

series

Array of double

Explanation:

Value

Values:

N/A

timestamps

Array of long

Explanation:

Timestamp

Values:

N/A

Example Request

"GEThttps://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/risk-trend?datastore_type=mysql&start_at=1736402167045&end_at=1736403967045&metric_code=sys001_cpu_usage"

Example Response

Status code: 200

Successful request

{
  "metric_code": "sys001_cpu_usage",
  "metric": {
    "series": [
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1,
      1
    ],
    "timestamps": [
      1736402220,
      1736402280,
      1736402340,
      1736402400,
      1736402460,
      1736402520,
      1736402580,
      1736402640,
      1736402700,
      1736402760,
      1736402820,
      1736402880,
      1736402940,
      1736403000,
      1736403060,
      1736403120,
      1736403180,
      1736403240,
      1736403300,
      1736403360,
      1736403420,
      1736403480,
      1736403540,
      1736403600,
      1736403660,
      1736403720,
      1736403780,
      1736403840
    ]
  }
}

Status Codes

Status Code

Description

200

Successful request

400

Bad request

500

Internal server error

Error Codes

See Error Codes.