2016-04-12 09:03:46 -04:00
|
|
|
.. -*- rst -*-
|
|
|
|
|
|
|
|
========================================================
|
2016-04-27 22:42:03 +08:00
|
|
|
Server usage audit log (os-instance-usage-audit-log)
|
2016-04-12 09:03:46 -04:00
|
|
|
========================================================
|
|
|
|
|
2016-12-14 11:22:50 -05:00
|
|
|
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.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-12-14 11:22:50 -05:00
|
|
|
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
|
|
|
|
========================
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
.. rest_method:: GET /os-instance_usage_audit_log
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-12-14 11:22:50 -05:00
|
|
|
Lists usage audits for all servers on all compute hosts where usage auditing
|
|
|
|
is configured.
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Normal response codes: 200
|
|
|
|
|
2016-05-11 17:14:53 +00:00
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-06-14 13:20:38 +09:00
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- instance_usage_audit_logs: instance_usage_audit_logs
|
|
|
|
- hosts_not_run: host_not_run
|
|
|
|
- log: instance_usage_audit_log
|
|
|
|
- errors: errors
|
|
|
|
- instances: instances_usage_audit
|
|
|
|
- message: instance_usage_audit_log_message
|
|
|
|
- state: instance_usage_audit_task_state
|
|
|
|
- num_hosts: host_num
|
|
|
|
- num_hosts_done: host_done_num
|
|
|
|
- num_hosts_not_run: host_not_run_num
|
|
|
|
- num_hosts_running: host_running_num
|
|
|
|
- overall_status: overall_status
|
|
|
|
- period_beginning: period_beginning
|
|
|
|
- period_ending: period_ending
|
|
|
|
- total_errors: total_errors
|
|
|
|
- total_instances: total_instances
|
|
|
|
|
|
|
|
|
2016-12-14 11:22:50 -05:00
|
|
|
**Example List Usage Audits For All Servers**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-04-20 11:38:31 +09:00
|
|
|
.. literalinclude:: ../../doc/api_samples/os-instance-usage-audit-log/inst-usage-audit-log-index-get-resp.json
|
2016-04-12 09:03:46 -04:00
|
|
|
:language: javascript
|
|
|
|
|
|
|
|
List Usage Audits Before Specified Time
|
|
|
|
=======================================
|
|
|
|
|
2016-06-02 08:50:03 -04:00
|
|
|
.. rest_method:: GET /os-instance_usage_audit_log/{before_timestamp}
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Lists usage audits that occurred before a specified time.
|
|
|
|
|
|
|
|
Normal response codes: 200
|
|
|
|
|
2016-12-14 11:22:50 -05:00
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
Request
|
2016-04-14 13:10:59 -04:00
|
|
|
-------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
|
|
- before_timestamp: before_timestamp
|
|
|
|
|
|
|
|
Response
|
2016-04-14 13:10:59 -04:00
|
|
|
--------
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-06-14 13:20:38 +09:00
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
2016-06-21 20:13:00 +09:00
|
|
|
- instance_usage_audit_log: instance_usage_audit_logs
|
2016-06-14 13:20:38 +09:00
|
|
|
- hosts_not_run: host_not_run
|
|
|
|
- log: instance_usage_audit_log
|
|
|
|
- errors: errors
|
|
|
|
- instances: instances_usage_audit
|
|
|
|
- message: instance_usage_audit_log_message
|
|
|
|
- state: instance_usage_audit_task_state
|
|
|
|
- num_hosts: host_num
|
|
|
|
- num_hosts_done: host_done_num
|
|
|
|
- num_hosts_not_run: host_not_run_num
|
|
|
|
- num_hosts_running: host_running_num
|
|
|
|
- overall_status: overall_status
|
|
|
|
- period_beginning: period_beginning
|
|
|
|
- period_ending: period_ending
|
|
|
|
- total_errors: total_errors
|
|
|
|
- total_instances: total_instances
|
|
|
|
|
|
|
|
|
2016-04-27 22:42:03 +08:00
|
|
|
**Example List Usage Audits Before Specified Time**
|
2016-04-12 09:03:46 -04:00
|
|
|
|
2016-04-20 11:38:31 +09:00
|
|
|
.. literalinclude:: ../../doc/api_samples/os-instance-usage-audit-log/inst-usage-audit-log-show-get-resp.json
|
2016-04-12 09:03:46 -04:00
|
|
|
:language: javascript
|