From 29b85e4a63732017bc10db4f6eeb10a3a381d00b Mon Sep 17 00:00:00 2001
From: Hongbin Lu <hongbin034@gmail.com>
Date: Thu, 3 May 2018 03:41:44 +0000
Subject: [PATCH] api-ref: add parameters for host APIs

Change-Id: Iaca4c984de3b36112d9ed304f0829d95e60e518b
---
 api-ref/source/hosts.inc       | 30 +++++++++++-
 api-ref/source/parameters.yaml | 84 ++++++++++++++++++++++++++++++++++
 2 files changed, 112 insertions(+), 2 deletions(-)

diff --git a/api-ref/source/hosts.inc b/api-ref/source/hosts.inc
index 868f906a0..356f66a9b 100644
--- a/api-ref/source/hosts.inc
+++ b/api-ref/source/hosts.inc
@@ -31,6 +31,20 @@ Response Parameters
 
    - 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
 ----------------
@@ -70,8 +84,20 @@ Response
 
 .. rest_parameters:: parameters.yaml
 
-  - uuid: uuid
-  - hostname: hostname
+   - 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
 ----------------
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index d27adb3b7..7e0c8bf6f 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -425,6 +425,90 @@ host:
   in: body
   required: true
   type: string
+host-architecture:
+  description: |
+    The architecture of the host operating system.
+  in: body
+  required: true
+  type: string
+host-cpu_used:
+  description: |
+    The used cpus of the host.
+  in: body
+  required: true
+  type: string
+host-cpus:
+  description: |
+    The total cpus of the host.
+  in: body
+  required: true
+  type: string
+host-disk_total:
+  description: |
+    The total amount of disk of the host.
+  in: body
+  required: true
+  type: string
+host-disk_used:
+  description: |
+    The amount of used disk of the host.
+  in: body
+  required: true
+  type: string
+host-hostname:
+  description: |
+    The hostname.
+  in: body
+  required: true
+  type: string
+host-kernel_version:
+  description: |
+    The kernel version of the host.
+  in: body
+  required: true
+  type: string
+host-labels:
+  description: |
+    The labels of the local container engine (i.e. Docker daemon).
+  in: body
+  required: true
+  type: string
+host-mem_total:
+  description: |
+    The total amount of memory of the host.
+  in: body
+  required: true
+  type: string
+host-mem_used:
+  description: |
+    The amount of used memory of the host.
+  in: body
+  required: true
+  type: string
+host-os:
+  description: |
+    The name of host operating system.
+  in: body
+  required: true
+  type: string
+host-os_type:
+  description: |
+    The type of host operating system.
+  in: body
+  required: true
+  type: string
+host-total_containers:
+  description: |
+    The total number of containers in the host.
+  in: body
+  required: true
+  type: string
+host-uuid:
+  description: |
+    The UUID of the host.
+  in: body
+  required: true
+  type: string
 host_list:
   description: |
     The host information list, including hostname, uuid, links, labels,