# 配置AI开发平台连接器 AI开发平台连接器用于对接华为云ModelArts云服务。 ModelArts是面向开发者的一站式AI开发平台，为机器学习与深度学习提供海量数据预处理及半自动化标注、大规模分布式Training、自动化模型生成，及端-边-云模型按需部署能力，帮助用户快速创建和部署模型，管理全周期AI工作流。 #### 创建AI开发平台连接 1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。 2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。 3. 选择"AI开发平台"连接器。 4. 在弹窗中配置连接信息，完成后单击"确定"。 | 参数 | 说明 | |:---|:---| | 连接名称 | 填写连接器实例名称。 | | 访问密钥ID | 当前账号的AK（Access Key ID）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 | | 秘密访问密钥 | 当前账号的SK（Secret Access Key）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 | | 描述 | 填写连接器的描述信息，用于识别不同的连接器。 | #### 支持的动作 - 批量删除节点 - 查询节点列表 - 查询资源实时利用率 - 资源统计池 - 资源池监控 - 删除资源池 - 查询资源池 - 创建资源池 - 查询资源池列表 #### 配置参数 表1批量删除节点 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | pool_name | 资源池名称。 | | region_id | 区域ID。 | | deleteNodeNames | 待删除的节点名称列表。 | 表2查询节点列表 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | pool_name | 资源池名称。 | | region_id | 区域ID。 | | continue | 分页查询时上一页位置。 | | limit | 分页单次查询返回数。 | 表3查询资源实时利用率 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | region_id | 区域ID。 | 表4资源池统计 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | region_id | 区域ID。 | | workspaceId | 工作空间，默认值为0。 | 表5资源池监控 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | pool_name | 资源池名称。 | | region_id | 区域ID。 | | time_range | 查询时间范围，默认值"-1.-1.60"。格式为startTimeInMillis.endTimeInMillis.durationInMinutes，参数解释： - startTimeInMillis: 查询的开始时间，格式为UTC毫秒，如果指定为-1，服务端将按(endTimeInMillis - durationInMinutes \* 60 \* 1000)计算开始时间。 - endTimeInMillis: 查询的结束时间，格式为UTC毫秒，如果指定为-1，服务端将按(startTimeInMillis + durationInMinutes \* 60 \* 1000)计算结束时间，如果计算出的结束时间大于当前系统时间，则使用当前系统时间。 - durationInMinutes：查询时间的跨度分钟数。 取值范围大于0并且大于等于(endTimeInMillis - startTimeInMillis) / (60 \* 1000) - 1 当开始时间与结束时间都设置为-1时，系统会将结束时间设置为当前时间UTC毫秒值，并按(endTimeInMillis - durationInMinutes \* 60 \* 1000)计算开始时间。如：-1.-1.60(表示最近60分钟)约束：单次请求中，查询时长与周期需要满足以下条件: durationInMinutes \* 60 / period \<= 1440。 | | statistics | 统计方式。可选值如下： - maximum：最大值统计，默认值 - minimum：最小值统计 - sum：求和统计 - average：平均值统计 - sampleCount：采样统计 | | period | 监控数据粒度，单位为秒。可选值如下： - 60：粒度为1分钟，默认值 - 300：粒度为5分钟 - 900：粒度为15分钟 - 3600：粒度为1小时 | 表6删除资源池 | 参数 | 说明 | |:---|:---| | X-ModelArts-User-ID | 实际的外部租户ID，如果有的话，工作空间鉴权以该ID为准。 | | project_id | 项目ID。 | | pool_name | 资源池名称。 | | region_id | 区域ID。 | 表7查询资源池 | 参数 | 说明 | |:---|:---| | X-ModelArts-User-ID | 实际的外部租户ID，如果有的话，工作空间鉴权以该ID为准。 | | project_id | 项目ID。 | | pool_name | 资源池名称。 | | region_id | 区域ID。 | 表8创建资源池 | 参数 | 说明 | |:---|:---| | X-ModelArts-User-ID | 实际的外部租户ID，如果有的话，工作空间鉴权以该ID为准。 | | project_id | 项目ID。 | | region_id | 区域ID。 | | apiVersion | API版本。可选值如下： v2 | | kind | 资源类型。可选值如下： Pool：资源池 | | metadata | 资源池的metadata信息。 | | labels | 资源池的标签信息。 | | os.modelarts/workspace.id | 工作空间ID，默认值0。 | | os.modelarts/name | 用户指定的pool名称。 | | annotations | 资源池的注释信息。 | | os.modelarts/description | 资源池的描述信息。 | | os.modelarts/billing.mode | 计费模式，可选值如下： - 0：按需计费。 - 1：包周期计费。 | | os.modelarts/period.num | 包周期订购周期，比如2。当计费模式为包周期时该参数必传。 | | os.modelarts/period.type | 包周期订购类型。可选值如下： - 2：月 - 3：年 当计费模式为包周期时该参数必传。 | | os.modelarts/auto.renew | 是否自动续费。可选值如下： 0：不自动续费，默认值 | | os.modelarts/promotion.info | 用户在cbc选择的折扣信息。 | | os.modelarts/service.console.url | 订购订单支付完成后跳转的url地址。 | | os.modelarts/order.id | 订单ID，包周期资源池创建或者计费模式变更的时候该参数必需。 | | spec | 资源池的描述信息。 | | type | 资源池类型。可选值如下： Dedicate：物理资源池，独立的网络，支持网络打通，定制驱动，定制作业类型。 | | scope | 资源池支持的作业类型。至少选择一种，物理资源池支持全部选择。可选值如下： - Train：训练作业。 - Infer：推理作业。 - Notebook：Notebook作业。 | | resources | 资源池中的资源规格信列表，包括资源规格和相应规格的资源数量。 | | flavor | 资源规格，比如：modelarts.vm.gpu.t4u8。 | | count | 相应规格资源数量。 | | network | 资源池网络参数。物理资源池时必选。 | | name | 网络名称，即网络详情中的metadata.name字段的值。 用户接口通过指定网络名称创建网络，系统会自动创建子网，用户无法创建子网。默认将创建在第一个子网下。 | | jobFlavors | 资源池支持的作业规格信息列表，内容为作业规格名称。 | | driver | 资源池的驱动信息。 | | gpuVersion | GPU驱动版本，物理资源池中含有GPU规格时可填，例如"440.33"。 | | npuVersion | NPU驱动版本，物理资源池中含有ascend规格时可填，例如"C78"。 | | updateStrategy | 驱动升级策略。可选值如下： - force：强制升级，立即升级节点驱动，可能影响节点上正在运行的作业。 - idle：安全升级，待节点上没有作业运行时进行驱动升级。 | 表9查询资源池列表 | 参数 | 说明 | |:---|:---| | project_id | 项目ID。 | | region_id | 区域ID。 | | workspaceId | 工作空间ID，默认值为0。 | | labelSelector | 标签筛选。 | | status | 资源池状态。可选值如下： - created：成功创建的资源池。 - failed：创建失败的资源池，创建失败的资源池记录保留3天。 - creating：创建中的资源池 为空则返回当前有效的资源池，包括创建中和创建成功的资源池。 |