# 上传文件
上传一个文件到OBS，此方法会阻塞线程，直至上传结束。上传的根目录（目标OBS桶的位置）是用户在华为HiLens控制台上针对每个设备配置的（参见[配置数据存储位置](https://support.huaweicloud.com/usermanual-hilens/hilens_02_0041.html)），如果用户没有给设备配置这个信息，那么上传文件会失败。
- **接口调用**
  hilens.upload_file(key, filepath, mode)
  1.0.6固件版本之后请使用hilens.upload_file_to_obs(key, filepath, mode)
  
- **参数说明**
  表1参数说明 
  | **参数名称** | **是否必选** | **参数类型** | **参数描述**                                                                                                                              |
  |:---|:---|:---|:---|
  | key      | 是        | 字符串      | 上传到OBS中的具体路径，不需要网址信息，只需OBS中的文件路径即可，如 'test/output.jpg'。 注意key中，两个目录名不可为 "." 开头或结尾，亦不可出现连续的多个斜杠如"//"。 |
  | filepath | 是        | 字符串      | 待上传文件的绝对路径。                                                                                                                           |
  | mode     | 是        | 字符串      | 上传模式。两种可选："write"-覆盖方式，"append"-追加方式。                                                                                                 |
     
  
- **返回值**
  成功则返回0。否则为失败。