nova/api-ref/source/os-instance-usage-audit-log.inc
Sean Dague c9f5ad3bcf remove /v2.1/{tenant_id} from all urls
As discussed at summit, the version part of the URL is not really
relevant, or a thing a user should be filling out themselves, this
should instead be set by the service catalog and extracted from the
token.

This removes it's reference in all documented REST urls, and adds a
new section describing how one gets the base URL for all calls.

Change-Id: I4306b8c3de0225e54f3909dd8a1fb293c4e5944c
2016-06-03 08:47:33 -04:00

53 lines
1.3 KiB
ReStructuredText

.. -*- rst -*-
========================================================
Server usage audit log (os-instance-usage-audit-log)
========================================================
Administrator only. Audit server usage of a tenant.
List Server Usage Audits For An Tenant
========================================
.. rest_method:: GET /os-instance_usage_audit_log
Lists usage audits for all servers on the given tenant.
Normal response codes: 200
Error response codes: unauthorized(401), forbidden(403)
Response
--------
**Example List Usage Audits For All Servers on tenant**
.. literalinclude:: ../../doc/api_samples/os-instance-usage-audit-log/inst-usage-audit-log-index-get-resp.json
:language: javascript
List Usage Audits Before Specified Time
=======================================
.. rest_method:: GET /os-instance_usage_audit_log/{before_timestamp}
Lists usage audits that occurred before a specified time.
Normal response codes: 200
Error response codes: badRequest(400),unauthorized(401), forbidden(403)
Request
-------
.. rest_parameters:: parameters.yaml
- before_timestamp: before_timestamp
Response
--------
**Example List Usage Audits Before Specified Time**
.. literalinclude:: ../../doc/api_samples/os-instance-usage-audit-log/inst-usage-audit-log-show-get-resp.json
:language: javascript