Возвращает сведения о использовании ресурсов для запрашиваемой подписки в следующей форме:
В промежутке времени [T1; T2] было израсходовано количество Q ресурса R.
Например:
Метод не оперирует понятиями «цена» и «стоимость». Необходимым и достаточным является указание соответствующего ресурса. Для приведенных выше высказываний таковыми ресурсами являются:
По-умолчанию предполагается посуточная агрегация сведений по использованию ресурсов, к примеру с 00:00 ч. до 23:59 того же дня.
| Метод | URI |
|---|---|
| GET | /subscriptions/{id}/usage-records/?from={from}&to={to}&offset={offset}&limit={limit} |
Нет.
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.
Тело ответа: возвращается общий для сервиса набор данных, содержащий сообщение об ошибке и дополнительную информацию. Дополнительная информация в разделе Ошибки сервиса.
{
"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 ресурса |