openstack
/
nova
Code Issues Proposed changes

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
This commit is contained in:
Matt Riedemann 2016-12-14 11:22:50 -05:00
parent bce8e4b9e3
commit be379e3733
1 changed files with 13 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
api-ref/source/os-instance-usage-audit-log.inc
View File

@ -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
-------