
# 创建集群策略实例 - CreateClusterPolicyInstance
#### 功能介绍
创建集群策略实例
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。
#### URI
POST /v1/clusters/{clusterid}/policyinstance
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| clusterid | 是    | String | 集群id |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                              |
|:---|:---|:---|:---|
| X-Auth-Token | 否    | String | 身份认证信息，调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值 |
| Content-Type | 是    | String | 消息体的类型（格式），仅支持application/json                                  |
   
表3请求Body参数 
| 参数                   | 是否必选 | 参数类型             | 描述                   |
|:---|:---|:---|:---|
| constraintTemplateID | 否    | String           | 策略模板的ID              |
| enforcementAction    | 否    | String           | 策略执行方式，当前支持warn和deny |
| namespaces           | 否    | Array of strings | 生效的命名空间              |
| parameters           | 否    | Object           | 策略实例的参数              |
   
#### 响应参数
**状态码：201**
表4响应Body参数 
| 参数    | 参数类型   | 描述   |
|:---|:---|:---|
| jobID | String | 任务id |
   
**状态码：400**
表5响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
**状态码：404**
表6响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
**状态码：500**
表7响应Body参数 
| 参数 | 参数类型   | 描述 |
|:---|:---|:---|
| -  | String | -  |
   
#### 请求示例
创建集群策略实例
```
POST https://ucs.myhuaweicloud.com/v1/clustergroups/{clustergroupid}/policyinstance
{
  "enforcementAction" : "deny",
  "namespaces" : [ "default" ],
  "parameters" : {
    "exemptImages" : [ "test" ],
    "procMount" : "Default"
  },
  "constraintTemplateID" : "f14d4210-adf8-11ed-9f9c-0255ac100186"
}
```
#### 响应示例
**状态码：201**
创建策略实例的任务id
```
{
  "jobID" : "ae4e4da4-92f7-48c9-822d-6a9978d30d16"
}
```
#### 状态码
| 状态码 | 描述                |
|:---|:---|
| 201 | 创建策略实例的任务id       |
| 400 | 客户端请求错误，服务器无法执行请求 |
| 404 | 资源不存在             |
| 500 | 服务器内部错误           |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。
