nova/releasenotes/notes/pagination-for-usage-a313397f9a7e9a70.yaml
Diana Clarke 83404013cb Simple tenant usage pagination
Add optional parameters 'limit' and 'marker' to the
os-simple-tenant-usage endpoints for pagaination.

  /os-simple-tenant-usage?limit={limit}&marker={instance_uuid}
  /os-simple-tenant-usage/{tenant}?limit={limit}&marker={instance_uuid}

The aggregate usage totals may no longer reflect all instances for a
tenant, but rather just the instances for a given page. API consumers
will need to stitch the aggregate data back together (add the totals)
if a tenant's instances span several pages.

Implements blueprint paginate-simple-tenant-usage
Change-Id: Ic8e9f869f1b855f968967bedbf77542f287f26c0
2016-12-14 03:33:50 +00:00

17 lines
722 B
YAML

---
features:
- |
Added microversion v2.40 which introduces pagination support for usage
with the help of new optional parameters 'limit' and 'marker'. If 'limit'
isn't provided, it will default to the configurable max limit which is
currently 1000.
::
/os-simple-tenant-usage?limit={limit}&marker={instance_uuid}
/os-simple-tenant-usage/{tenant}?limit={limit}&marker={instance_uuid}
Older microversions will not accept these new paging query parameters,
but they will start to silently limit by the max limit to encourage the
adoption of this new microversion, and circumvent the existing possibility
DoS-like usage requests on systems with thousands of instances.