# 导入kie配置 - ImportKieConfigurations
#### 功能介绍
导入kie配置。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CSE/doc?api=UploadKie)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项               | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                       | 别名                | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cse:config:upload | write | -           | [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | cse:config:modify | -      |
     
  
 
#### URI
POST /v1/{project_id}/kie/file
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户子项目的唯一标识。字符长度为1\~64。 |
   
表2Query参数 
| 参数       | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| override | 否    | String | 覆盖策略。 **取值范围** **：** - force： 强制覆盖。  - abort：遇到第一个重复时终止导入后续的kv。  - skip：跳过重复的key。   **默认取值：** force |
| label    | 否    | String | 指定label导入，格式为：{标签key}:{标签value}，如果不填则按body的label导入。                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 请求参数
表3请求Header参数 
| 参数                      | 是否必选 | 参数类型   | 描述                                                                                                  |
|:---|:---|:---|:---|
| X-Auth-Token            | 是    | String | 用户Token。                                                                                            |
| X-Enterprise-Project-ID | 否    | String | 如果不带则默认企业项目为"default"，ID为"0"。 **默认取值：** 0 |
| Content-Type            | 是    | String | 该字段内容填为"application/json;charset=UTF-8" 。                                                           |
| Accept                  | 是    | String | 该字段内容填为"application/json"。                                                                          |
   
表4FormData参数 
| 参数          | 是否必选 | 参数类型 | 描述                                                                   |
|:---|:---|:---|:---|
| upload_file | 是    | File | 导入文件内容的格式必须为键值对映射，例如:{"data":\[{"key1":"value1","key2":"value2"}\]}} |
   
#### 响应参数
**状态码： 200**
表5响应Body参数 
| 参数      | 参数类型                                                                                                | 描述              |
|:---|:---|:---|
| success | Array of [GetKieConfigs] objects | 导入成功的配置项列表。     |
| failure | Array of [failure] objects             | 导入失败的配置项及其错误列表。 |
   
 表6GetKieConfigs 
| 参数              | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| id              | String  | 配置项的id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| key             | String  | 配置项的key。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| labels          | Object  | 配置项的标签。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| value           | String  | 配置项的值。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| value_type      | String  | 配置项value的类型。 **取值范围** **：** - text  - yaml  - json  - properties  - ini  - xml   |
| status          | String  | 配置项的状态。 **取值范围** **：** - disabled：配置不可用。  - enabled：配置可用。                                                                                                                                                                                                                                                                              |
| create_time     | Integer | 创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| update_time     | Integer | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| create_revision | Long    | 创建配置的版本号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| update_revision | Long    | 修改配置的版本号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表7failure 
| 参数            | 参数类型   | 描述            |
|:---|:---|:---|
| key           | String | 导入失败配置的key。   |
| labels        | Object | 导入失败配置的label。 |
| error_code    | String | 导入失败的错误码。     |
| error_message | String | 导入失败的原因。      |
   
**状态码： 400**
表8响应Body参数 
| 参数         | 参数类型   | 描述      |
|:---|:---|:---|
| error_code | String | 错误码。    |
| error_msg  | String | 错误信息。   |
| detail     | String | 详细定位信息。 |
   
**状态码： 500**
表9响应Body参数 
| 参数         | 参数类型   | 描述      |
|:---|:---|:---|
| error_code | String | 错误码。    |
| error_msg  | String | 错误信息。   |
| detail     | String | 详细定位信息。 |
   
#### 请求示例
```
POST https://{endpoint}/v3/{project_id}/kie/file
{
  }
```
#### 响应示例
**状态码： 200**
success
```
{
  "success" : [ {
    "id" : "8a9e6a5d-8d65-48fb-a40c-5150c8479da8",
    "key" : "string",
    "labels" : {
      "key" : "value"
    },
    "value" : "string",
    "value_type" : "text",
    "status" : "enabled",
    "create_time" : 1623139038,
    "update_time" : 1623139038,
    "create_revision" : 13,
    "update_revision" : 13
  } ],
  "failure" : [ {
    "key" : "string",
    "labels" : {
      "key" : "value"
    },
    "error_code" : "SVCSTG.004xxxxx",
    "error_message" : "Invalid parameters"
  } ]
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | success  |
| 400 | 错误的请求。   |
| 500 | 服务器内部错误。 |
   
#### 错误码
请参见[CSE错误码](https://support.huaweicloud.com/api-cse/cse_06_0109.html)。