# 简单上传文件
#### 功能介绍
通过"文件管理"接口"upload_uploadFile"可以将本地的文件上传至工业数字模型驱动引擎（Industrial Digital Model Engine，简称iDME）中。完成文件上传后，可在调用数据实例的创建/更新接口时，将文件与该数据实例进行关联，从而实现对象化管理文件。
"upload_uploadFile"接口最大支持上传100MB文件。如需上传大于100MB的文件，请使用[分块上传](https://support.huaweicloud.com/bestpractice-idme/idme_bestpractice_0054.html)接口。
本文仅指导您如何通过API方式上传简单文件。关于如何创建/更新数据实例的接口请参见[全量数据服务](https://support.huaweicloud.com/usermanual-idme/idme_clientog_0154.html)。
#### URI
- URI格式： POST http://**{Endpoint}** /rdm_**{appID}**_app/services/rdm/basic/api/upload/uploadFile
  
- 参数说明：
  表1URI参数说明 
  | 参数            | 是否必填 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                  |
  |:---|:---|:---|:---|
  | Endpoint      | 是    | String  | 承载REST服务端点的服务器域名或IP地址。                                                                                                                                                                                                                                                                                                                              |
  | appID         | 是    | String  | 应用ID。                                                                                                                                                                                                                                                                                                                                               |
  | modelNumber   | 是    | String  | 数据模型的编码。                                                                                                                                                                                                                                                                                                                                            |
  | modelName     | 是    | String  | 数据模型的英文名称。                                                                                                                                                                                                                                                                                                                                          |
  | dataType      | 否    | String  | 数据模型的类型。 - entity：数据实体  - relation：关系实体              |
  | attributeName | 是    | String  | 数据模型的属性英文名称。                                                                                                                                                                                                                                                                                                                                        |
  | applicationId | 是    | String  | 应用ID。                                                                                                                                                                                                                                                                                                                                               |
  | username      | 否    | String  | 用户名。                                                                                                                                                                                                                                                                                                                                                |
  | storageType   | 是    | Integer | 文件的存储类型。 - 0：对象存储  - 1：BLOB                                  |
  | instanceId    | 否    | String  | 数据实例的唯一编码。                                                                                                                                                                                                                                                                                                                                          |
  | exaAttr       | 是    | String  | 是否为扩展属性。 - 0：非扩展属性  - 1：扩展属性                      |
  | clsNodeId     | 否    | String  | 分类节点的ID，用于区分该类型属性是直接绑定到数据模型的扩展属性，还是绑定到分类节点的扩展属性。 如未设置此参数，默认表示该属性为绑定到数据模型的扩展属性。此参数仅在 "exaAttr"为"1"时生效。                                                                                                                                                                                               |
  | encrypted     | 否    | Boolean | 是否加密。当"storageType"设置为"0"时，需要设置此参数。 - true：加密  - false：不加密   |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户的token。 |
   
表3请求Body参数 
| 参数    | 是否必选 | 参数类型              | 描述         |
|:---|:---|:---|:---|
| files | 是    | MultipartFile\[\] | 需要上传的文件列表。 |
| file  | 否    | MultipartFile     | 需要上传的文件。   |
   
#### 响应参数
表4响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| result | String | 调用是否成功。 - SUCCESS：成功  - FAIL：失败   |
| data   | List   | 调用的返回结果。                                                                                                                                                                                                                                                                                                                         |
| errors | List   | 异常信息列表。                                                                                                                                                                                                                                                                                                                          |
   
#### 请求示例
```
POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/rdm/basic/api/upload/uploadFile?applicationId=fce01234567d41828cf3473b07fa7ae2&attributeName=LargeFiles&dataType=entity&encrypted=false&exaAttr=1&modelName=Industrial_File&modelNumber=DM00127283&storageType=0&username=XDM_User
X-Auth-Token: ABCDEFG.... 
[MultipartFile Form files]
```
#### 响应示例
```
{
    "result": "SUCCESS",
    "data": [
        "563740223079452672"
    ],
    "errors": []
}
```