===== Использование ресурсов подписки за период =====
Возвращает сведения о использовании ресурсов для запрашиваемой подписки в следующей форме: \\
\\
**В промежутке времени [T1; T2] было израсходовано количество Q ресурса R.**
Например:\\
- За 10 ноября 2015 г. было израсходовано 5.41 ГБ трафика;
- С 13:00 до 14:00 10 ноября 2015 г. использовалось 2 экземпляра виртуальных машин конфигурации C1.
Метод не оперирует понятиями "цена" и "стоимость". Необходимым и достаточным является указание соответствующего ресурса. Для приведенных выше высказываний таковыми ресурсами являются:
- 1 ГБ трафика;
- 1 экземпляр виртуальной машины конфигурации C1.
По-умолчанию предполагается посуточная агрегация сведений по использованию ресурсов, к примеру с 00:00 ч. до 23:59 того же дня.
===== Запрос =====
==== Синтаксис ====
^ Метод ^ URI ^
| GET | /subscriptions/{id}/usage-records/?from={from}&to={to}&offset={offset}&limit={limit}|
==== Параметры URI ====
{{page>vendor-api:sub-paged-params}}
==== Тело запроса ====
Нет.
==== Пример запроса ====
GET /subscriptions/42/usage-records/?from=2013-12-25&to=2016-01-01&offset=100&limit=20
===== Ответ =====
==== Успех ====
{{page>vendor-api:response-success}}
Тело ответа: массив объектов UsageRecord. \\
== Пример тела ответа ==
[{
"IntervalBegin": "2002-12-30T00:00:00+04:00",
"IntervalEnd": "2002-12-31T23:59:59+04:00",
"Quantity": 42.45,
"ResourceId": "31605363-f28b-468f-9bc5-ab7b3bdb355a"
},
{
"IntervalBegin": "2002-12-31T00:00:00+04:00",
"IntervalEnd": "2003-01-01T23:59:59+04:00",
"Quantity": 123.45,
"ResourceId": "31605363-f28b-468f-9bc5-ab7b3bdb355a"
},
{
"IntervalBegin": "2003-01-01T00:00:00+04:00",
"IntervalEnd": "2003-01-02T23:59:59+04:00",
"Quantity": 0.0,
"ResourceId": "31605363-f28b-468f-9bc5-ab7b3bdb355a"
}]
{{page>vendor-api:response-error}}
===== Контракт данных =====
{{page>vendor-api:contracts:usage-record}}