云服务器内容精选

  • 响应示例 成功响应示例 { "spec_code": "modelarts.vm.gpu.v100", "user_image_url": "100.125.5.235:20202/jobmng/custom-cpu-base:1.0", "user_command": "bash -x /home/work/run_train.sh python /home/work/user-job-dir/app/mnist/mnist_softmax.py --data_url /home/work/user-job-dir/app/mnist_data", "gpu_type": "nvidia-v100", "dataset_version_id": "2ff0d6ba-c480-45ae-be41-09a8369bfc90", "engine_name": "TensorFlow", "is_success": true, "nas_mount_path": "/home/work/nas", "worker_server_num": 1, "nas_share_addr": "192.168.8.150:/", "train_url": "/test/minst/train_out/out1/", "nas_type": "nfs", "spec_id": 4, "parameter": [ { "label": "learning_rate", "value": 0.01 } ], "log_url": "/usr/log/", "config_name": "config123", "app_url": "/usr/app/", "create_time": 1559045426000, "dataset_id": "38277e62-9e59-48f4-8d89-c8cf41622c24", "volumes": [ { "nfs": { "id": "43b37236-9afa-4855-8174-32254b9562e7", "src_path": "192.168.8.150:/", "dest_path": "/home/work/nas", "read_only": false } }, { "host_path": { "src_path": "/root/work", "dest_path": "/home/mind", "read_only": false } } ], "cpu": "64", "model_id": 4, "boot_file_url": "/usr/app/boot.py", "dataset_name": "dataset-test", "pool_id": "pool9928813f", "config_desc": "This is a config desc test", "gpu_num": 1, "data_source": [ { "type": "obs", "data_url": "/test/minst/data/" } ], "pool_name": "pnt1", "dataset_version_name": "dataset-version-test", "core": "8", "engine_type": 1, "engine_id": 3, "engine_version": "TF-1.8.0-python2.7", "data_url": "/test/minst/data/"} 失败响应示例 { "is_success": false, "error_message": "Error string", "error_code": "ModelArts.0105"}
  • 响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 说明 is_success Boolean 请求是否成功。 error_message String 调用失败时的错误信息。 调用成功时无此字段。 error_code String 调用失败时的错误码,具体请参见错误码。调用成功时无此字段。 config_name String 训练作业参数的名称。 config_desc String 训练作业参数的描述信息。 worker_server_num Integer 训练作业worker的个数。 app_url String 训练作业的代码目录。 boot_file_url String 训练作业的代码启动文件。 model_id Long 训练作业的模型ID。 parameter JSON Array 训练作业的运行参数,为“label-value”格式;当为 自定义镜像 训练作业的时候,此参数为容器环境变量。详情请查看表8 spec_id Long 训练作业资源规格ID。 data_url String 训练作业的数据集。 dataset_id String 训练作业的数据集ID。 dataset_version_id String 训练作业的数据集版本ID。 data_source JSON Array 训练作业使用的多数据集。详情请查看表4。 engine_type Integer 训练作业的引擎类型。 engine_name String 训练作业的引擎名称。 engine_id Long 训练作业的引擎ID。 engine_version String 训练作业使用的引擎版本。 train_url String 训练作业的输出文件OBS路径URL,默认为空,如“/usr/train/”。 log_url String 训练作业的日志OBS输出路径URL,默认为空。如:“/usr/train/”。 user_image_url String 自定义镜像训练作业的自定义镜像的SWR-URL。 user_command String 自定义镜像训练作业的自定义镜像的容器的启动命令。 spec_code String 训练作业资源规格。 gpu_type String 资源规格gpu的类型。 create_time Long 训练作业参数创建时间 。 cpu String 资源规格CPU内存。 gpu_num Integer 资源规格gpu的个数。 core String 资源规格的核数。 dataset_name String 训练作业的数据集名称。 dataset_version_name String 训练作业的数据集名称。 pool_id String 资源池ID。 pool_name String 资源池名称。 volumes JSON Array 训练作业可使用的存储卷。具体请参见表5。 nas_mount_path String SFS Turbo (NAS) 训练本地挂载路径。如:“/home/work/nas”。 nas_share_addr String SFS Turbo (NAS) 共享路径。如:“192.168.8.150:/”。 nas_type String 当前仅支持 nfs。如:“nfs”。 表4 data_source属性列表 参数 参数类型 说明 dataset_id String 训练作业的数据集ID。 dataset_version String 训练作业的数据集版本ID。 type String 数据集类型。 “obs”:表示使用OBS的数据。 “dataset”:表示使用数据集的数据。 data_url String OBS的桶路径。
  • URI GET /v1/{project_id}/training-job-configs/{config_name} 参数说明如表1所示。 表1 路径参数 参数 是否必选 参数类型 说明 project_id 是 String 用户项目ID。获取方法请参见获取项目ID和名称。 config_name 是 String 训练作业参数的名称。 表2 Query参数 参数 是否必选 参数类型 说明 config_type 否 String 指定要查询的配置类型,可选值有以下两种 “custom”为查询用户自定义配置。 “sample”为查询示例配置,默认为“custom”。
  • 响应示例 获取参数模板列表成功。 { "count": 3, "configurations": [ { "id": "b000d7c91f1749da87315700793a11d4pr14", "name": "Default- GaussDB -EE-1.0-Dist-Combined (4 replicas)", "description": "Default parameter template for GaussDB-Enterprise Edition-1.0-Distributed-combined (4 replicas)", "created": "2022-03-23 07:20:11", "updated": "2022-03-23 07:20:11", "datastore_version": "V2.0-1.0", "datastore_name": "GaussDB", "ha_mode": "combined", "user_defined": false }, { "id": "8d99f260ea1b4493a1b349e7abce5c09pr14", "name": "Default-Finance-Edition-GaussDB-1.3-Combined", "description": "Default parameter template for Finance Edition GaussDB 1.3-Combined", "created": "2022-03-23 07:20:11", "updated": "2022-03-23 07:20:11", "datastore_version": "V2.0-1.1", "datastore_name": "GaussDB", "ha_mode": "combined", "user_defined": false }, { "id": "0f44b65521a8414d8b8811df810d94ccpr14", "name": "Default-Finance-Disaster-GaussDB-1.3-Combined", "description": "Default parameter template for Finance Disaster GaussDB 1.3-Combined", "created": "2022-03-23 07:20:11", "updated": "2022-03-23 07:20:11", "datastore_version": "V2.0-1.2", "datastore_name": "GaussDB", "ha_mode": "combined", "user_defined": false }]}
  • URI GET https://{Endpoint}/v3.2/{project_id}/configurations?offset={offset}&limit={limit} 表1 参数说明 参数 是否必选 参数类型 描述 project_id 是 String 参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 offset 否 Integer 参数解释: 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。例如:该参数指定为0,limit指定为10,则只展示第1~10条数据。 约束限制: 不涉及。 取值范围: [0, 2^31-1] 默认取值: 默认为0(偏移0条数据,表示从第一条数据开始查询)。 limit 否 Integer 参数解释: 查询记录数。例如该参数设定为10,则查询结果最多只显示10条记录。 约束限制: 不涉及。 取值范围: [1, 100] 默认取值: 默认为100。
  • 配置项详细信息列表 MAS-DB-SDK配置分为props、etcd、sources、router四部分,在SpringBoot项目中配置项使用驼峰风格,详细信息如下表: 表1 props配置项 名称 说明 默认值 备注 props.appId MAS应用ID 空 MAS服务应用列表页中“应用ID”列对应值。 props.monitorId MAS监控器ID 空 MAS服务DB监控页中“监控ID”列对应值。 props.databaseName MAS监控DB名称 空 MAS服务DB监控页选择应用单击“编辑”中连接池配置下“数据库名称”列对应值。 props.decipherClassName 密码解析类 com.huawei.devspore.mas.password.DefaultDecipher 需要实现基类 。com.huawei.devspore.mas.password.Decipher props.version 配置文件版本号 空 当前固定填v1。 props.azs 服务所属AZ信息 空 路由算法为本地读单边写时必填。 props配置项中的值都是取自于本服务在MAS服务注册时展示的值。 props配置项中的值与在MAS服务中的来源请参考props、etcd配置项在MAS服务中如何查询。 表2 etcd配置项 名称 说明 默认值 备注 etcd.address ETCD地址 空 MAS服务总览页单击ETCD连接地址后的查看详情获取。 etcd.apiVersion ETCD接口版本 v3 固定值v3。 etcd.username ETCD用户名 空 MAS服务总览页单击ETCD连接地址后的查看详情获取。 etcd.password ETCD密码 空 MAS服务总览页单击ETCD连接地址后的查看详情获取。 etcd.httpsEnable ETCD是否启用https false 根据ETCD实际情况选择,最新版本的MAS服务etcd均为https,此处需要配置为true,并配置证书路径。 etcd.certificatePath 启用https时证书存放路径 空 https证书存放路径。也支持不使用证书,此时不需要配置该配置项。 etcd配置项中的值都是取自于本服务在MAS服务etcd展示的值。 props配置项中的值与在etcd中的来源请参考props、etcd配置项在MAS服务中如何查询。 etcd.apiVersion填写固定值V3。 etcd.httpsEnable的值取决于ETCD页面“etcd集群地址”访问是http,这里值为false;访问是https,这里值为true。查看方法参考props、etcd配置项在MAS服务中如何查询。 表3 sources数据源配置项 名称 说明 默认值 备注 sources.ds1 数据库节点名称:ds1 空 与MAS服务中连接池中的命名一致。 sources.ds1.driverClassName 数据库驱动类名 空 驱动名称,自定义。 sources.ds1.jdbcUrl 数据库连接地址 空 与MAS服务中连接池中各节点下数据库连接地址一致。 sources.ds1.username 数据库用户名 空 与MAS服务中连接池中各节点下数据库用户名一致。 sources.ds1.password 数据库密码 空 如果密码为加密,需要自定义实现解密类配置:props.decipherClassName sources.ds1.type 数据源类型 空 支持类型如下: com.zaxxer.hikari.HikariDataSource org.apache.commons.dbcp2.BasicDataSource com.alibaba.druid.pool.DruidDataSource sources.ds1.props 数据源类型其他参数 空 根据自己选择的数据源类型配置。 props: connection-timeout: 1000 validation-timeout: 1000 sources主要配置本项目中涉及的一组或者多组数据源,所以上表中"ds1"为数据源的节点名称,如果有多组数据源,按照同样的格式配置多组即可。 对接MAS服务,各组数据源的节点名称与MAS服务中连接池中的命名一致。 无对接MAS服务,各组数据源的节点名称应命名为具有区别意义的名称。 表4 router路由配置 名称 说明 默认值 备注 router.active 默认数据源的激活节点 - - router.routeAlgorithm 路由策略 single-read-write 单边读写single-read-write。 router.nodes.ds1.loadBalance 读写分离负载均衡算法 空 可选项: RANDOM是随机。 ROUND_ROBIN是轮询。 router.nodes.ds1.master 主数据源 空 当slaves为空时,读写流量都在master 当slaves不为空时,读流量在slaves,写流量,DDL,事务操作在master。 router.nodes.ds1.slaves 读写分离读数据源列表 空 - router.nodes.ds1.azs 该数据中心所属AZ信息 空 路由算法为本地读单边写,且未对接MAS平台时必填。 router.nodes配置罗列本项目中数据源路由节点,所以上表中“ds1”为数据源路由节点名称,如果有多组数据源,按照同样的格式配置多组即可。 节点router.nodes.ds1.master下配置的源名称为“表3 sources数据源配置项”中的“sources.ds1”主节点的值。 节点router.nodes.ds1.slaves下配置的源名称为“表3”中的“sources.ds1”从节点的值。 router.active对应值为router.nodes的一个节点名称。 父主题: 参数配置说明