DescribeMetricDataRequest.Builder (alibabacloud-cms20190101 3.0.10 API)

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 based on which the resources are queried.
`DescribeMetricDataRequest.Builder`	`endTime(String endTime)` The end of the time range to query monitoring data.
`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 per 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 start of the time range to query monitoring data.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - dimensions
```
public DescribeMetricDataRequest.Builder dimensions(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****.
    
    You can query a maximum of 50 instances in a single request.
    
    example:
    [{"instanceId": "i-abcdefgh12****"}]
  - endTime
```
public DescribeMetricDataRequest.Builder endTime(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:
      
      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 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 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:
    - UNIX timestamp: the number of milliseconds that have elapsed since 00:00:00 UTC on 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.
    
    example:
    1618368960000
  - 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.
    
    example:
    {"groupby":["userId","instanceId"]}
  - length
```
public DescribeMetricDataRequest.Builder length(String length)
```
    The number of entries per page.
    
    Default value: 1000.
    
    The maximum value of the Length parameter in a request is 1440.
    
    example:
    1000
  - metricName
```
public DescribeMetricDataRequest.Builder metricName(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
  - 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.
    
    This parameter is required.
    example:
    acs_ecs_dashboard
  - 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.
    example:
    60
  - startTime
```
public DescribeMetricDataRequest.Builder startTime(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:
      
      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 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 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:
    - UNIX timestamp: the number of milliseconds that have elapsed since 00:00:00 UTC on Thursday, January 1, 1970.
    - 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 UTC on Thursday, January 1, 1970. Otherwise, this parameter is invalid.
    - We recommend that you use UNIX timestamps to prevent time zone-related issues.
    example:
    1618368900000
  - build
```
public DescribeMetricDataRequest build()
```

类 DescribeMetricDataRequest.Builder

方法概要

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

方法详细资料

dimensions

endTime

express

length

metricName

namespace

period

startTime

build