# 获取集群证书（已废弃） - CreateClusterCert
#### 功能介绍
该API用于获取指定集群的证书信息。该API已废弃，请使用[获取集群证书](https://support.huaweicloud.com/api-cce/cce_02_0248.html)。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-cce/cce_02_0099.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cce/cce_02_0395.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                                  | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                               | 别名                                                                                                                 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cce:cluster:generateClientCredential | Read | cluster \*  | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | - cce:cluster:get   | -      |
     
  
 
#### URI
GET /api/v3/projects/{project_id}/clusters/{cluster_id}/clustercert
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                    |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html)  |
| cluster_id | 是    | String | 集群 ID，获取方式请参见[如何获取接口URI中参数](https://support.huaweicloud.com/api-cce/cce_02_0271.html) |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 消息体的类型（格式） 枚举值： - **application/json;charset=utf-8**  - **application/json**   |
| X-Auth-Token | 是    | String | 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值，获取方式请参见[获取token](https://support.huaweicloud.com/api-cce/cce_02_0004.html)。 最大长度：**16384**                                                                                                                 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数              | 参数类型                                                         | 描述                                                                     |
|:---|:---|:---|
| kind            | String                                                       | API类型，固定值"Config"，该值不可修改。 缺省值：**Config** |
| apiVersion      | String                                                       | API版本，固定值"v1"。                                                         |
| preferences     | String                                                       | 当前未使用该字段，当前默认为空。                                                       |
| clusters        | Array of [Clusters] objects | 集群列表。                                                                  |
| users           | Array of [Users] objects       | 存放了指定用户的一些证书信息和ClientKey信息。                                            |
| contexts        | Array of [Contexts] objects | 上下文列表。                                                                 |
| current-context | String                                                       | 当前上下文，若存在publicIp（虚拟机弹性IP）时为 external; 若不存在publicIp为 internal。         |
   
 表4Clusters 
| 参数      | 参数类型                                                     | 描述                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| name    | String                                                   | 集群名字。 - 若不存在publicIp（虚拟机弹性IP），则集群列表的集群数量为1，该字段值为"internalCluster"。  - 若存在publicIp，则集群列表的集群数量大于1，所有扩展的cluster的name的值为"externalCluster"。   |
| cluster | [ClusterCert] object | 集群信息。                                                                                                                                                                                                                                                                                                                            |
   
 表5ClusterCert 
| 参数                         | 参数类型    | 描述                                                 |
|:---|:---|:---|
| server                     | String  | 服务器地址。                                             |
| certificate-authority-data | String  | 证书授权数据。                                            |
| insecure-skip-tls-verify   | Boolean | 不校验服务端证书，在 cluster 类型为 externalCluster 时，该值为 true。 |
   
 表6Users 
| 参数   | 参数类型                                       | 描述                          |
|:---|:---|:---|
| name | String                                     | 当前为固定值"user"。               |
| user | [User] object | 存放了指定用户的一些证书信息和ClientKey信息。 |
   
 表7User 
| 参数                      | 参数类型   | 描述                      |
|:---|:---|:---|
| client-certificate-data | String | 客户端证书。                  |
| client-key-data         | String | 包含来自TLS客户端密钥文件的PEM编码数据。 |
   
 表8Contexts 
| 参数      | 参数类型                                             | 描述                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|
| name    | String                                           | 上下文的名称。 - 若不存在publicIp（虚拟机弹性IP），则集群列表的集群数量为1，该字段值为"internal"。  - 若存在publicIp，则集群列表的集群数量大于1，所有扩展的context的name的值为"external"。   |
| context | [Context] object | 上下文信息。                                                                                                                                                                                                                                                                                                                     |
   
 表9Context 
| 参数      | 参数类型   | 描述            |
|:---|:---|:---|
| cluster | String | 上下文cluster信息。 |
| user    | String | 上下文user信息。    |
   
#### 请求示例
无
#### 响应示例
**状态码： 200**
表示成功获取指定集群的证书。证书文件格式参见kubernetes v1.Config结构
```
{
  "kind" : "Config",
  "apiVersion" : "v1",
  "preferences" : { },
  "clusters" : [ {
    "name" : "internalCluster",
    "cluster" : {
      "server" : "https://192.168.1.7:5443",
      "certificate-authority-data" : "Q2VydGlmaWN******kQgQ0VSVElGSUNBVEUtLS0tLQo="
    }
  } ],
  "users" : [ {
    "name" : "user",
    "user" : {
      "client-certificate-data" : "LS0tLS1CRUdJTi******RklDQVRFLS0tLS0K",
      "client-key-data" : "LS0tLS1CRUdJTiBSU******BLRVktLS0tLQo="
    }
  } ],
  "contexts" : [ {
    "name" : "internal",
    "context" : {
      "cluster" : "internalCluster",
      "user" : "user"
    }
  } ],
  "current-context" : "internal"
}
```
#### 状态码
| 状态码 | 描述                                           |
|:---|:---|
| 200 | 表示成功获取指定集群的证书。证书文件格式参见kubernetes v1.Config结构 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cce/ErrorCode.html)。