public class DescribeMetricDataRequest
extends com.aliyun.tea.TeaModel
| 限定符和类型 | 字段和说明 |
|---|---|
String |
dimensions
The dimensions based on which the resources are queried.
|
String |
endTime
The end of the time range to query monitoring data.
|
String |
express
The expression that is used to compute the query results in real time.
|
String |
length
The number of entries per page.
|
String |
metricName
The metric that is used to monitor the cloud service.
|
String |
namespace
The namespace of the cloud service.
|
String |
period
The statistical period of the metric.
|
String |
regionId |
String |
startTime
The start of the time range to query monitoring data.
|
| 构造器和说明 |
|---|
DescribeMetricDataRequest() |
| 限定符和类型 | 方法和说明 |
|---|---|
static DescribeMetricDataRequest |
build(Map<String,?> map) |
String |
getDimensions() |
String |
getEndTime() |
String |
getExpress() |
String |
getLength() |
String |
getMetricName() |
String |
getNamespace() |
String |
getPeriod() |
String |
getRegionId() |
String |
getStartTime() |
DescribeMetricDataRequest |
setDimensions(String dimensions) |
DescribeMetricDataRequest |
setEndTime(String endTime) |
DescribeMetricDataRequest |
setExpress(String express) |
DescribeMetricDataRequest |
setLength(String length) |
DescribeMetricDataRequest |
setMetricName(String metricName) |
DescribeMetricDataRequest |
setNamespace(String namespace) |
DescribeMetricDataRequest |
setPeriod(String period) |
DescribeMetricDataRequest |
setRegionId(String regionId) |
DescribeMetricDataRequest |
setStartTime(String startTime) |
@NameInMap(value="Dimensions") public String dimensions
The dimensions based on which the resources are queried.
Set the value to a collection of key-value pairs. A typical key-value pair is instanceId:i-2ze2d6j5uhg20x47****.
example:You can query a maximum of 50 instances in a single request.
[{"instanceId": "i-abcdefgh12****"}]
@NameInMap(value="EndTime") public String endTime
The end of the time range to query monitoring data.
If the StartTime and EndTime parameters are not specified, the monitoring data of the last statistical period is queried.``
If the StartTime and EndTime parameters are specified, the monitoring data of the last statistical period in the specified time range is queried.```` The following examples demonstrate how to determine the period in which monitoring data is queried:
Period parameter to 15, the specified time range must be less than or equal to 20 minutes. For example, if you set the StartTime parameter to 2021-05-08 08:10:00 and the EndTime parameter to 2021-05-08 08:30:00, the monitoring data of the last 15 seconds in the time range is queried.Period to 60 or 900, the specified time range must be less than or equal to 2 hours. For example, if you set the Period parameter to 60, the StartTime parameter to 2021-05-08 08:00:00, and the EndTime parameter to 2021-05-08 10:00:00, the monitoring data of the last 60 seconds in the time range is queried.Period parameter to 3600, the specified time range must be less than or equal to 2 days. For example, if you set the StartTime parameter to 2021-05-08 08:00:00 and the EndTime parameter to 2021-05-10 08:00:00, the monitoring data of the last 3,600 seconds in the time range is queried.The following formats are supported:
example:We recommend that you use UNIX timestamps to prevent time zone-related issues.
1618368960000
@NameInMap(value="Express") public String express
The expression that is used to compute the query results in real time.
example:Only the
groupbyexpression is supported. This expression is similar to theGROUP BYstatement that is used in databases.
{"groupby":["userId","instanceId"]}
@NameInMap(value="Length") public String length
The number of entries per page.
Default value: 1000.
example:The maximum value of the Length parameter in a request is 1440.
1000
@NameInMap(value="MetricName") public String metricName
The metric that is used to monitor the cloud service.
For more information about the metrics of cloud services, see Appendix 1: Metrics.
This parameter is required.
example:cpu_idle
@NameInMap(value="Namespace") public String namespace
The namespace of the cloud service.
For more information about the namespaces of cloud services, see Appendix 1: Metrics.
This parameter is required.
example:acs_ecs_dashboard
@NameInMap(value="Period") public String period
The statistical period of the metric.
Valid values: 15, 60, 900, and 3600.
Unit: seconds.
If this parameter is not specified, monitoring data is queried based on the period in which metric values are reported.
For more information about the statistical period of a metric that is specified by the MetricName parameter, see Appendix 1: Metrics.
60
@NameInMap(value="RegionId") public String regionId
@NameInMap(value="StartTime") public String startTime
The start of the time range to query monitoring data.
If the StartTime and EndTime parameters are not specified, the monitoring data of the last statistical period is queried.``
If the StartTime and EndTime parameters are specified, the monitoring data of the last statistical period in the specified time range is queried.```` The following examples demonstrate how to determine the period in which monitoring data is queried:
Period parameter to 15, the specified time range must be less than or equal to 20 minutes. For example, if you set the StartTime parameter to 2021-05-08 08:10:00 and the EndTime parameter to 2021-05-08 08:30:00, the monitoring data of the last 15 seconds in the time range is queried.Period to 60 or 900, the specified time range must be less than or equal to 2 hours. For example, if you set the Period parameter to 60, the StartTime parameter to 2021-05-08 08:00:00, and the EndTime parameter to 2021-05-08 10:00:00, the monitoring data of the last 60 seconds in the time range is queried.Period parameter to 3600, the specified time range must be less than or equal to 2 days. For example, if you set the StartTime parameter to 2021-05-08 08:00:00 and the EndTime parameter to 2021-05-10 08:00:00, the monitoring data of the last 3,600 seconds in the time range is queried.The following formats are supported:
You must set the StartTime parameter to a point in time that is later than 00:00:00 UTC on Thursday, January 1, 1970. Otherwise, this parameter is invalid.
We recommend that you use UNIX timestamps to prevent time zone-related issues.
1618368900000
public static DescribeMetricDataRequest build(Map<String,?> map) throws Exception
Exceptionpublic DescribeMetricDataRequest setDimensions(String dimensions)
public String getDimensions()
public DescribeMetricDataRequest setEndTime(String endTime)
public String getEndTime()
public DescribeMetricDataRequest setExpress(String express)
public String getExpress()
public DescribeMetricDataRequest setLength(String length)
public String getLength()
public DescribeMetricDataRequest setMetricName(String metricName)
public String getMetricName()
public DescribeMetricDataRequest setNamespace(String namespace)
public String getNamespace()
public DescribeMetricDataRequest setPeriod(String period)
public String getPeriod()
public DescribeMetricDataRequest setRegionId(String regionId)
public String getRegionId()
public DescribeMetricDataRequest setStartTime(String startTime)
public String getStartTime()
Copyright © 2026. All rights reserved.