# 文件传输（推荐）
![](https://support.huaweicloud.com/sdkreference-modelarts/public_sys-resources/note_3.0-zh-cn.png)
该接口支持上传本地文件和文件夹至OBS，支持下载OBS文件和文件夹至本地，推荐使用该接口。
#### 示例代码
在ModelArts Notebook平台，Session鉴权无需输入鉴权参数。其它平台的Session鉴权请参见[Session鉴权](https://support.huaweicloud.com/sdkreference-modelarts/modelarts_04_0123.html)。
```
from modelarts.session import Session 
session = Session()  
# 1. 上传本地文件至OBS 
session.obs.copy(src_path='/home/ma-user/file1.txt', dst_path='obs://bucket-name/dir1/file1.txt')
# 2. 下载OBS文件至本地 
session.obs.copy(src_path='obs://bucket-name/dir1/file1.txt', dst_path='/home/ma-user/file1.txt')
# 3. 上传本地文件夹至OBS 
session.obs.copy(src_path='/home/ma-user', dst_path='obs://bucket-name/dir1', keep_last_dir=True)
# 4. 下载OBS文件夹至本地 
session.obs.copy(src_path='obs://bucket-name/dir1', dst_path='/home/ma-user', keep_last_dir=True)
```
表1请求参数说明 
| 参数            | 是否必选 | 参数类型    | 描述                                              |
|:---|:---|:---|:---|
| session       | 是    | Object  | 会话对象。                                           |
| src_path      | 是    | String  | 源文件或源文件夹路径，当源路径为OBS路径时，必须以obs://作为路径前缀。         |
| dst_path      | 是    | String  | 目的文件或目的文件夹路径，当目的路径为OBS路径时，必须以obs://作为路径前缀。      |
| keep_last_dir | 否    | Boolean | 默认为True，复制文件夹时是否将源文件夹最后一级目录复制至目的文件夹下，仅对文件夹复制有效。 |
   
表2失败响应说明 
| 参数         | 参数类型   | 描述                    |
|:---|:---|:---|
| error_code | String | 调用失败时的错误码。调用成功时无此字段。  |
| error_msg  | String | 调用失败时的错误信息。调用成功时无此字段。 |