a7cbc90fb1
Improve api samples for os-instance_usage_audit_log and fix a parameter. Change-Id: I8436a6ab0610e41d8c6c95c55a263fdfbbf58476 Implements: blueprint api-ref-in-rst
93 lines
2.5 KiB
ReStructuredText
93 lines
2.5 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
|
|
--------
|
|
|
|
.. 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
|
|
|
|
|
|
**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
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- instance_usage_audit_log: 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
|
|
|
|
|
|
**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
|