Добавить страницу в книгу 
Удалить страницу из книги 
Показать или изменить шаблон книги (
Помощь Содержание
Использование ресурсов подписки за период
Возвращает сведения о использовании ресурсов для запрашиваемой подписки в следующей форме:
В промежутке времени [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
Тело запроса
Нет.
Пример запроса
GET /subscriptions/42/usage-records/?from=2013-12-25&to=2016-01-01&offset=100&limit=20
Ответ
Успех
Успех
Стандартный код HTTP: 200 OK.
Тело ответа: массив объектов 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"
}]
Ошибка
Для указания типа ошибки в ответе сервера, используются стандартные HTTP-коды 4xx-5xx.
Тело ответа: возвращается общий для сервиса набор данных, содержащий сообщение об ошибке и дополнительную информацию. Дополнительная информация в разделе Ошибки сервиса.
Контракт данных
UsageRecord
{
"IntervalBegin": "2002-12-30T23:59:59+00:00",
"IntervalEnd": "2002-12-31T23:59:59+00:00",
"Quantity": 123.45,
"ResourceId": "31605363-f28b-468f-9bc5-ab7b3bdb355a"
}
| Поле | Тип | Описание |
|---|---|---|
| IntervalBegin | datetime | |
| IntervalEnd | datetime | |
| Quantity | number | Количество потребленного ресурса |
| ResourceId | string | ID ресурса |