###################
GetMetricStatistics
###################

***********
Description
***********

Возвращает статистические данные для заданной метрики.

******************
Request Parameters
******************

- *Dimensions.member.N* — Измерения метрики (подробнее см. :ref:`документацию пользователя <Dimensions>`).

  - Необходимо: Да
  - Тип: Список объектов :ref:`Dimension`
  - Ограничение длины: От 0 до 10 элементов
  - Атрибуты `Name` переданных :ref:`Dimension` объектов не должны быть разными

- *EndTime* — Конечная дата выборки данных метрики.

  - Необходимо: Да
  - Тип: Datetime

- *MetricName* — Имя метрики.

  - Необходимо: Да
  - Тип: String
  - Ограничение длины: От 1 до 255 символов

- *Namespace* — Пространство имён метрики.

  - Необходимо: Да
  - Тип: String
  - Ограничение длины: От 1 до 255 символов

- *Period* — Детализация статистических данных в секундах.

  - Необходимо: Да
  - Тип: Integer
  - Диапазон: Значение должно быть кратным 60, минимальное значение — ``60``

- *StartTime* — Начальная дата выборки данных метрики.

  - Необходимо: Да
  - Тип: Datetime

- *Statistics.member.N* — Статистики.

  - Необходимо: Да
  - Тип: Array of strings
  - Возможные значения: ``Average`` | ``Sum`` | ``SampleCount`` | ``Maximum`` | ``Minimum``

*****************
Response Elements
*****************

- *Datapoints* — Статистические данные для заданной метрики.

  - Тип: Список объектов :ref:`Datapoint`

- *Label* — текстовые данные, описывающие заданную метрику.

  - Тип: String

********
Examples
********

.. code-block:: bash

   c2-cw GetMetricStatistics Period <period> StartTime <start_time> EndTime <end_time> \
                             MetricName <metric_name> Namespace <namespace> \
                             Statistics.member.1 <statistic>

   c2-cw GetMetricStatistics Period <period> StartTime <start_time> EndTime <end_time> \
                             MetricName <metric_name> Namespace <namespace> \
                             Statistics.member.1 <statistic> \
                             Dimensions.member.1.Name "InstanceId" \
                             Dimensions.member.1.Value <instance_id>