consolidate 10 bugs in a single bug.
bug id:1633112
there is something wrong about response parameters explain in the first api "GET /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}",the last two response parameter "id" and "name" should be explain as "the UUID of the cluster template" and "the name of the cluster template" not the cluster,that is to say the word template is absent.
bug id:1633117
there is something wrong about request parameters explain in the first api "GET /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}",the parameter "cluster_template_id" is in the path not in the body,because it's a GET method.
bug id:1633119
there is something wrong about request parameters explain in the 2nd api "PUT /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}",the parameter "cluster_template_id" is in the path not in the body,maybe it could be in body ,but it's not optional parameter
bug id:1633121
there is something wrong about response parameters explain in the 2nd api "PUT /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}",the last two response parameter "id" and "name" should be explain as "the UUID of the cluster template" and "the name of the cluster template" not the cluster,that is to say the word template is absent,it's similar with the bug "1633112".
bug id:1633125
there is something wrong about request parameters explain in the api "DELETE /v1.1/{tenant_id}/cluster-templates/{cluster_template_id}",the parameter "cluster_template_id" is in the path not in the body.
bug id:1633130
there is something wrong about response parameters explain in the 4th api "GET /v1.1/{tenant_id}/cluster-templates",the last two response parameter "id" and "name" should be explain as "the UUID of the cluster template" and "the name of the cluster template" not the cluster,that is to say the word "template" is absent.
bug id:1633132
there is something wrong about request parameters explain in the 5th api "POST /v1.1/{tenant_id}/cluster-templates",the parameter "tenant_id" is in the path not in the body,the word "body" in the colum "in" should change to "path".
bug id:1633133
there is something wrong about response parameters explain in the 5th api "POST /v1.1/{tenant_id}/cluster-templates",the last two response parameter "id" and "name" should be explain as "the UUID of the cluster template" and "the name of the cluster template" not the cluster,that is to say the word "template" is absent.
bug id:1633138
there is something misunderstanding about response parameters explain in the 6th api "GET /v1.1/{tenant_id}/clusters",the response parameter "count" is not stands for "The number of nodes in the cluste",it should be the number of nodes or instances in every node groups,the number of nodes in cluster should caculate the sum of "count" value in all node groups.besides ,the "management_public_key" explaining as "The SSH key for the management network." is not correct,it stands for "the master node's public ssh key in the cluster",it has nothing with the management network
bug id:1633152
the api "DELETE /v1.1/{tenant_id}/clusters/{cluster_id}" ,the request parameter "cluster_id" is not optional,it can't be absent.
the error appears in these api "GET /v1.1/{tenant_id}/clusters/{cluster_id}","PUT /v1.1/{tenant_id}/clusters/{cluster_id}","PATCH /v1.1/{tenant_id}/clusters/{cluster_id}","GET /v1.1/{tenant_id}/clusters/{cluster_id}",in the api "GET /v1.1/{tenant_id}/clusters/{cluster_id}" when it stands for "Shows details for a cluster, by ID",obviously ,the parameter "cluster_id" can't be absent.
Fix proposed to branch: master /review. openstack. org/415806
Review: https:/