diff options
| author | Matt Riedemann <mriedem@us.ibm.com> | 2016-12-14 11:22:50 -0500 |
|---|---|---|
| committer | Matt Riedemann <mriedem@us.ibm.com> | 2016-12-14 11:22:50 -0500 |
| commit | be379e3733b379efe83ea6c83159ef94d8174d2c (patch) | |
| tree | dda39a9983226a90330cf11d2c223b651a9241c6 /api-ref/source/os-instance-usage-audit-log.inc | |
| parent | bce8e4b9e378f1bf0d4595c7c3f8b26d86e6527b (diff) | |
| download | nova-be379e3733b379efe83ea6c83159ef94d8174d2c.tar.gz | |
api-ref: Fix description of os-instance-usage-audit-log
This API is not per-tenant, it's a global admin query of all
server usage audit data on all configured compute hosts, so
this change updates the description to reflect that and also
replaces the admin-only wording with the more useful boilerplate
admin default wording we have in other API references.
Change-Id: I8f48caa3505abbcfbe08e9218fc70eeeaf643b13
Closes-Bug: #1649944
Diffstat (limited to 'api-ref/source/os-instance-usage-audit-log.inc')
| -rw-r--r-- | api-ref/source/os-instance-usage-audit-log.inc | 19 |
1 files changed, 13 insertions, 6 deletions
diff --git a/api-ref/source/os-instance-usage-audit-log.inc b/api-ref/source/os-instance-usage-audit-log.inc index 8d557276eb..e7de56a9c5 100644 --- a/api-ref/source/os-instance-usage-audit-log.inc +++ b/api-ref/source/os-instance-usage-audit-log.inc @@ -4,14 +4,21 @@ Server usage audit log (os-instance-usage-audit-log) ======================================================== -Administrator only. Audit server usage of a tenant. +Audit server usage of the cloud. This API is dependent on the +``instance_usage_audit`` configuration option being set on all compute hosts +where usage auditing is required. -List Server Usage Audits For An Tenant -======================================== +Policy defaults enable only users with the administrative role to perform +all os-instance-usage-audit-log related operations. Cloud providers can change +these permissions through the ``policy.json`` file. + +List Server Usage Audits +======================== .. rest_method:: GET /os-instance_usage_audit_log -Lists usage audits for all servers on the given tenant. +Lists usage audits for all servers on all compute hosts where usage auditing +is configured. Normal response codes: 200 @@ -40,7 +47,7 @@ Response - total_instances: total_instances -**Example List Usage Audits For All Servers on tenant** +**Example List Usage Audits For All Servers** .. literalinclude:: ../../doc/api_samples/os-instance-usage-audit-log/inst-usage-audit-log-index-get-resp.json :language: javascript @@ -54,7 +61,7 @@ Lists usage audits that occurred before a specified time. Normal response codes: 200 -Error response codes: badRequest(400),unauthorized(401), forbidden(403) +Error response codes: badRequest(400), unauthorized(401), forbidden(403) Request ------- |