zun/api-ref/source/hosts.inc

107 lines
2.0 KiB
ReStructuredText

.. -*- rst -*-
==================
Manage zun host
==================
List all compute hosts
========================================
.. rest_method:: GET /v1/hosts
Enables administrative users to list all Zun container hosts.
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 400
- 401
- 403
Response Parameters
-------------------
.. rest_parameters:: parameters.yaml
- X-Openstack-Request-Id: request_id
- hosts: host_list
- architecture: host-architecture
- cpus: host-cpus
- cpu_used: host-cpu_used
- disk_used: host-disk_used
- disk_total: host-disk_total
- hostname: host-hostname
- kernel_version: host-kernel_version
- labels: host-labels
- mem_used: host-mem_used
- mem_total: host-mem_total
- os: host-os
- os_type: host-os_type
- total_containers: host-total_containers
- uuid: host-uuid
Response Example
----------------
.. literalinclude:: samples/host-get-all-resp.json
:language: javascript
Show details of a host
===========================
.. rest_method:: GET /v1/hosts/{host_ident}
Get all information of a host in Zun.
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 200
.. rest_status_code:: error status.yaml
- 401
- 403
- 404
Request
-------
.. rest_parameters:: parameters.yaml
- host_ident: host_ident
Response
--------
.. rest_parameters:: parameters.yaml
- architecture: host-architecture
- cpus: host-cpus
- cpu_used: host-cpu_used
- disk_used: host-disk_used
- disk_total: host-disk_total
- hostname: host-hostname
- kernel_version: host-kernel_version
- labels: host-labels
- mem_used: host-mem_used
- mem_total: host-mem_total
- os: host-os
- os_type: host-os_type
- total_containers: host-total_containers
- uuid: host-uuid
Response Example
----------------
.. literalinclude:: samples/host-get-resp.json
:language: javascript