com.aliyun.sdk.service.cms20190101.models

类 DescribeMetricDataRequest.Builder

java.lang.Object

com.aliyun.sdk.service.cms20190101.models.DescribeMetricDataRequest.Builder

所有已实现的接口:

darabonba.core.RequestModel.Builder<DescribeMetricDataRequest,DescribeMetricDataRequest.Builder>

封闭类:

DescribeMetricDataRequest

public static final class DescribeMetricDataRequest.Builder
extends Object

方法概要

限定符和类型	方法和说明
DescribeMetricDataRequest	build()
DescribeMetricDataRequest.Builder	dimensions(String dimensions) The dimensions that specify the resources whose monitoring data you want to query.
DescribeMetricDataRequest.Builder	endTime(String endTime) The end of the time range to query.
DescribeMetricDataRequest.Builder	express(String express) The expression that is used to compute the query results in real time.
DescribeMetricDataRequest.Builder	length(String length) The number of entries to return on each page.
DescribeMetricDataRequest.Builder	metricName(String metricName) The metric that is used to monitor the cloud service.
DescribeMetricDataRequest.Builder	namespace(String namespace) The namespace of the cloud service.
DescribeMetricDataRequest.Builder	period(String period) The statistical period of the metric.
DescribeMetricDataRequest.Builder	startTime(String startTime) The beginning of the time range to query.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

dimensions

public DescribeMetricDataRequest.Builder dimensions(String dimensions)

The dimensions that specify the resources whose monitoring data you want to query.

Set the value to a collection of key-value pairs. A typical key-value pair is `instanceId:i-2ze2d6j5uhg20x47****`. > You can query a maximum of 50 instances in a single request.

endTime

public DescribeMetricDataRequest.Builder endTime(String endTime)

The end of the time range to query.

* 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: * If you set the `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. * If you set the `Period` parameter 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. * If you set the `Period` parameter to 3600, the specified time range must be less than or equal to two 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: * UNIX timestamp: the number of milliseconds that have elapsed since 00:00:00 Thursday, January 1, 1970 * UTC time: the UTC time that follows the YYYY-MM-DDThh:mm:ssZ format > We recommend that you use UNIX timestamps to prevent time zone-related issues.

express

public DescribeMetricDataRequest.Builder express(String express)

The expression that is used to compute the query results in real time.

> Only the `groupby` expression is supported. This expression is similar to the `GROUP BY` statement that is used in databases.

length

public DescribeMetricDataRequest.Builder length(String length)

The number of entries to return on each page.

Default value: 1000. > The maximum value of the Length parameter in a request is 1440.

metricName

public DescribeMetricDataRequest.Builder metricName(String metricName)

The metric that is used to monitor the cloud service.

For more information about the metrics of different cloud services, see [Appendix 1: Metrics](~~163515~~).

namespace

public DescribeMetricDataRequest.Builder namespace(String namespace)

The namespace of the cloud service.

For more information about the namespaces of cloud services, see [Appendix 1: Metrics](~~163515~~).

period

public DescribeMetricDataRequest.Builder period(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](~~163515~~).

startTime

public DescribeMetricDataRequest.Builder startTime(String startTime)

The beginning of the time range to query.

* 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: * If you set the `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. * If you set the `Period` parameter 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. * If you set the `Period` parameter to 3600, the specified time range must be less than or equal to two 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: * UNIX timestamp: the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC. * UTC time: the UTC time that follows the YYYY-MM-DDThh:mm:ssZ format > * You must set the `StartTime` parameter to a point in time that is later than 00:00:00 Thursday, January 1, 1970. Otherwise, this parameter is invalid. * We recommend that you use UNIX timestamps to prevent time zone-related issues.

build

public DescribeMetricDataRequest build()