# SDK简介
ModelArts服务软件开发工具包（ModelArts SDK）是对ModelArts服务提供的REST API进行的Python封装，以简化用户的开发工作。用户直接调用ModelArts SDK即可完成训练作业等任务。
ModelArts SDK目前只提供Python语言的SDK，推荐使用3.10.x版本。
#### 使用场景
ModelArts SDK目前仅支持在ModelArts开发环境Notebook和本地PC两种环境使用。不支持在ModelArts 的训练作业和推理在线服务中使用。
- ModelArts SDK已经集成在ModelArts开发环境Notebook中，可以直接使用，无需进行Session鉴权。 登录ModelArts控制台，在"开发空间 \> Notebook"中创建Notebook实例，在Terminal或ipynb文件中直接调用ModelArts SDK的接口。在Notebook中调用SDK，可直接参考接口说明，执行OBS管理、作业管理、模型管理和服务管理等操作。
  
- ModelArts SDK支持在本地安装配置使用。使用时，需进行Session鉴权。
  1. 本地安装SDK。如果本地未安装SDK，可参考[（可选）本地服务器安装ModelArts SDK](https://support.huaweicloud.com/sdkreference-modelarts/modelarts_04_0004.html)安装；如果本地已安装，则无需再次安装。
  
  2. 进行Session鉴权。可参见[（可选）Session鉴权](https://support.huaweicloud.com/sdkreference-modelarts/modelarts_04_0123.html)完成鉴权。鉴权完成后，即可开始使用。
   
 
#### SDK版本说明
表1ModelArts SDK版本说明 
| 发布时间    | 版本号    | 说明                                                           |
|:---|:---|:---|
| 2023-04 | 1.4.18 | 1.4.18版本在SDK旧版本基础上优化集成，主要新增DLI Spark任务提交能力，支持服务部署到推理新版专属资源池。 |
   
#### 支持的区域
如果在开发环境使用SDK，则所有区域均支持；如果下载至本地使用，支持的区域如下：
- 华北-北京一（cn-north-1）
- 华北-北京二（cn-north-2）
- 华北-北京四（cn-north-4）
- 华北-乌兰察布二零一（cn-north-5）
- 华北-乌兰察布一（cn-north-9）
- 西南-贵阳一（cn-southwest-2）
- 东北-大连（cn-northeast-1）
- 华东-上海二（cn-east-2）
- 华东-上海一（cn-east-3）
- 华南-广州（cn-south-1）
- 中国-香港（ap-southeast-1）
- 亚太-新加坡（ap-southeast-3）