华为云用户手册

响应示例 状态码： 200 请求成功 { "memory" : 15880352, "user_name" : "chace", "created_at" : "2022-02-16 11:01:23 GMT+08:00", "firmware_version" : "2.0.0", "type" : "General ARM Device", "host_ips" : [ "10.90.47.209" ], "firmware_name" : "HiLens_Device_Agent", "npu_num" : 1, "updated_at" : "2022-02-17 15:55:50 GMT+08:00", "id" : "hilens-989c34eeaeda4a5380b7d9f2b101f7f1", "state" : "FAIL", "active_content" : [ "fed6966c29e94bd18cd65debf25e9992", "466b3f957a8448f99a390531d615ee5c" ], "os_version" : "#1 SMP Mon Mar 16 00:02:15 UTC 2020", "cpu" : 16, "enable_npu" : false, "log_configs" : [ { "size" : 50, "type" : "LTS", "component" : "app", "rotate_num" : 5 } ], "enable_gpu" : false, "gpu_num" : 0, "tags" : { }, "enable_container" : true, "active_status" : "ACTIVATED", "npu_info" : { }, "os_type" : "Linux", "name" : "hilens-209", "os_name" : "linux", "arch" : "aarch64"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 租户Token。获取方法请参见 获取Token 表3 请求Body参数 参数 是否必选 参数类型 描述 order_id 否 String 订单ID，小型轻型设备激活时使用的订单 cpu_order_id 否 String 订单ID，大型设备使用CPU时激活的订单 npu_gpu_order_id 否 String 订单ID，大型设备使用GPU/NPU时激活的订单

请求示例 分页查询HiLens控制台专业版设备列表 GET https://{endpoint}/v3/{project_id}/ai-mgr/nodes?offset=0&limit=10&provider=hilensRequest Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应示例 状态码： 200 请求成功 { "count" : 26, "nodes" : [ { "firmware_status" : null, "cluster_node_type" : "cluster_controller", "cpu" : 16, "created_at" : "2022-02-16 11:01:23 GMT+08:00", "type" : "General ARM Device", "gpu_num" : 0, "firmware_upgrade_record" : null, "host_ips" : [ "10.90.47.209" ], "tags" : { }, "firmware_name" : "HiLens_Device_Agent", "cluster_id" : "hilens-cf7d36a328334a7599f4004fe917adcb", "active_status" : "ACTIVATED", "npu_num" : 1, "name" : "hilens-209", "id" : "hilens-989c34eeaeda4a5380b7d9f2b101f7f1", "state" : "RUNNING", "upgrade_firmware_version" : null, "cluster_node_state" : "RUNNING" }, { "firmware_status" : null, "cluster_node_type" : null, "cpu" : 0, "created_at" : "2022-02-16 10:33:05 GMT+08:00", "type" : "General ARM Device", "gpu_num" : 0, "firmware_upgrade_record" : null, "host_ips" : [ ], "tags" : { }, "firmware_name" : null, "cluster_id" : null, "active_status" : "INACTIVE", "npu_num" : 0, "name" : "ddp-test111", "id" : "hilens-1027a354fd1c4f2b81fba6d6081ce19f", "state" : "UNCONNECTED", "upgrade_firmware_version" : null, "cluster_node_state" : null }, { "firmware_status" : null, "cluster_node_type" : null, "cpu" : 0, "created_at" : "2022-02-13 21:25:32 GMT+08:00", "type" : "General x86 Device", "gpu_num" : 0, "firmware_upgrade_record" : null, "host_ips" : [ ], "tags" : { }, "firmware_name" : null, "cluster_id" : null, "active_status" : "INACTIVE", "npu_num" : 0, "name" : "my-test-device", "id" : "hilens-3f665c35ea3b471880c1499e05a3c630", "state" : "UNCONNECTED", "upgrade_firmware_version" : null, "cluster_node_state" : null }, { "firmware_status" : null, "cluster_node_type" : "cluster_controller", "cpu" : 16, "created_at" : "2022-02-11 17:07:32 GMT+08:00", "type" : "General ARM Device", "gpu_num" : 0, "firmware_upgrade_record" : null, "host_ips" : [ "10.90.47.208" ], "tags" : { }, "firmware_name" : "HiLens_Device_Agent", "cluster_id" : "hilens-cf7d36a328334a7599f4004fe917adcb", "active_status" : "ACTIVATED", "npu_num" : 1, "name" : "hilens-208", "id" : "hilens-4f7ff1e5da1c4051861e50b336efde0b", "state" : "RUNNING", "upgrade_firmware_version" : null, "cluster_node_state" : "FAIL" }, { "firmware_status" : null, "cluster_node_type" : null, "cpu" : 48, "created_at" : "2022-02-10 20:44:43 GMT+08:00", "type" : "General x86 Device", "gpu_num" : 3, "firmware_upgrade_record" : null, "host_ips" : [ "10.216.139.114" ], "tags" : { }, "firmware_name" : "HiLens_Device_Agent_x86", "cluster_id" : null, "active_status" : "ACTIVATED", "npu_num" : 0, "name" : "egypt-x86-test-114", "id" : "hilens-e2423376a61e4265a2ffd253a3493b35", "state" : "FAIL", "upgrade_firmware_version" : null, "cluster_node_state" : null } ]}

请求示例 新建配置项 POST https://{endpoint}/v3/{project_id}/ai-mgr/configmaps{ "configmap" : { "configs" : [ { "key" : "string", "value" : "string" } ], "created_at" : "string", "description" : "string", "id" : "string", "name" : "string", "project_id" : "string", "tags" : [ { "key" : "string", "value" : "string" } ], "type" : "string", "updated_at" : "string", "workspace_id" : "string" }, "workspace_id" : "string"}

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 configmap ConfigMap object 配置项详情 workspace_id String 工作空间ID，默认为注册账号/子账号的default工作空间，可通过专业版HiLens控制台展开工作空间列表获取到工作空间ID 表9 ConfigMap 参数 参数类型 描述 configs Array of Config objects 配置列表 created_at String 创建时间 description String 描述 id String 配置项ID name String 名称 project_id String 项目ID tags Array of Tag objects 标签列表 type String 类型 updated_at String 更新时间 workspace_id String 工作空间ID 表10 Config 参数 参数类型 描述 key String 配置项key，最大长度63个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” value String 配置项value，每个值最大长度10000个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” 表11 Tag 参数 参数类型 描述 key String 标签键，最大长度36个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” value String 标签值，每个值最大长度43个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_”

响应示例 状态码： 200 请求成功 { "configmap" : { "configs" : [ { "key" : "string", "value" : "string" } ], "created_at" : "string", "description" : "string", "id" : "string", "name" : "string", "project_id" : "string", "tags" : [ { "key" : "string", "value" : "string" } ], "type" : "string", "updated_at" : "string", "workspace_id" : "string" }, "workspace_id" : "string"}

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 租户Token。获取方法请参见获取Token 表4 请求Body参数 参数 是否必选 参数类型 描述 configmap 是 ConfigMap object 配置项详情 workspace_id 否 String 工作空间ID，默认为注册账号/子账号的default工作空间，可通过专业版HiLens控制台展开工作空间列表获取到工作空间ID 表5 ConfigMap 参数 是否必选 参数类型 描述 configs 是 Array of Config objects 配置列表 created_at 否 String 创建时间 description 否 String 描述 id 否 String 配置项ID name 是 String 名称 project_id 否 String 项目ID tags 是 Array of Tag objects 标签列表 type 否 String 类型 updated_at 否 String 更新时间 workspace_id 否 String 工作空间ID 表6 Config 参数 是否必选 参数类型 描述 key 是 String 配置项key，最大长度63个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” value 是 String 配置项value，每个值最大长度10000个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” 表7 Tag 参数 是否必选 参数类型 描述 key 是 String 标签键，最大长度36个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_” value 是 String 标签值，每个值最大长度43个字符，删除时如果value有值按照key/value删除，如果value没值，则按照key删除。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_”

状态码 状态码如表1那所示。 表1 状态码 状态码 编码 状态码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTP的新版本协议。 200 OK 接口调用成功。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

请求示例 获取指定workspace_id的工作空间详情 GET https://{endpoint}/v3/{project_id}/ai-mgr/workspaces/{workspace_id}Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 workspace_id String 工作空间id ma_workspace_id String 对应的Modelarts工作空间的id project_id String 项目ID name String 工作空间名称 description String 工作空间描述 enterprise_project_id String 企业项目ID enterprise_project_name String 企业项目名称 create_time Long 创建时间 update_time Long 更新时间 owner String 创建者 user_id String 创建者的USER_ID used_flag String 正在被使用

响应示例 状态码： 200 请求成功 { "workspace_id" : "0", "ma_workspace_id" : null, "project_id" : "fff47e1722f94c4e98531bae56821372", "name" : "default", "description" : null, "enterprise_project_id" : "0", "enterprise_project_name" : "default", "create_time" : 1598094655508, "update_time" : 1598094655508, "owner" : 123, "user_id" : "19a1ef99f8ed4d4ab38be5085adaf84a", "used_flag" : null}

请求示例 升级设备固件 PUT https://{endpoint}/v3/{project_id}/node-manager/node/{node_id}/firmware/{firmware_id}Request Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 目前华为HiLens服务支持以下地区和终端节点，请您根据业务需要选择对应区域的终端节点。 表1 华为HiLens的终端节点 区 域名 称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 hilens.cn-north-4.myhuaweicloud.com HTTPS 父主题： 使用前必读

URI PUT /v3/{project_id}/node-manager/node/{node_id}/firmware/{firmware_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID node_id 是 String 设备ID，从专业版HiLens控制台设备管理查询设备列表获取 firmware_id 是 String 固件ID,，从专业版HiLens控制台固件管理查询固件列表获取

请求示例 删除某个作业 DELETE https://{endpoint}/v3/{project_id}/ai-mgr/deployments/{deployment_id}/tasks/{task_id}Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

URI DELETE /v3/{project_id}/ai-mgr/deployments/{deployment_id}/tasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 deployment_id 是 String 部署ID，从专业版HiLens控制台部署管理获取部署列表获取 project_id 是 String 项目ID。获取方法请参见获取项目ID task_id 是 String 作业ID，从专业版HiLens控制台作业管理获取作业列表获取

URI DELETE /v3/{project_id}/ai-mgr/nodes/{node_id} 表1 路径参数 参数 是否必选 参数类型 描述 node_id 是 String 设备ID，从专业版HiLens控制台设备管理查询设备列表获取 project_id 是 String 项目ID。获取方法请参见获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 force_delete 否 Boolean 是否强制删除，true代表是，false代表否

请求示例 删除专业版HiLens控制台上的设备 DELETE https://{endpoint}/v3/{project_id}/ai-mgr/nodes/{node_id}Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 order_id String 订单ID 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

URI DELETE /v3/{project_id}/{resource_type}/{resource_id}/tags/{key} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参见获取项目ID resource_id 是 String 资源ID，不同资源（节点，部署，配置项，密钥）有不同的资源ID resource_type 是 String 资源类型（节点，部署，配置项，密钥） key 是 String 标签键，最大长度36个字符。不能为空，只能包含大小写字母，数字，中划线“-”，下划线“_”

请求示例 删除对应资源的标签 DELETE https://{endpoint}/v3/{project_id}/{resource_type}/{resource_id}/tags/{key}Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-4", ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

响应示例 状态码： 200 请求成功，当批量更新部署节点个数小于20个的时候，返回结果result字段非空，当大于20个的时候，result字段为空，此时可通过回调机制获取部署结果。 { "template" : { "configs" : { "migration" : false, "host_network" : false, "host_pid" : false, "restart_policy" : "Always", "toleration_seconds" : 0 }, "apps" : [ { "name" : "example1-skill-name", "args" : [ ], "command" : [ "--log_dir=/train --learning_rate=0.01 --batch_size=150" ], "resources" : { "limits" : { "cpu" : "0.25", "memory" : "128" }, "requests" : { } }, "envs" : [ { "name" : "IVA_SVC_CONFIG", "value" : "{\"algorithm\":{\"multiTask\":\"no\",\"algType\":\"hilens\"},\"cloud\":{\"disEndpoint\":\"https://dis.cn-north-7.myhuaweicloud.com\",\"region\":\"cn-north-7\"},\"svcInstanceId\":\"modelbox-instance-xxxx\"}" } ], "msgs" : [ ], "ports" : [ { "container_port" : 10, "host_port" : 23, "host_ip" : "10.10.10.10" } ], "privileged" : false, "volumes" : [ { "name" : "tmp", "type" : "emptyDir", "source" : "memory", "destination" : "/tmp", "read_only" : false }, { "name" : "run", "type" : "emptyDir", "source" : "memory", "destination" : "/run", "read_only" : false }, { "name" : "cgroup", "type" : "hostPath", "source" : "/sys/fs/cgroup", "destination" : "/sys/fs/cgroup", "read_only" : true } ], "app_url" : "xxx", "is_modelbox" : true } ] }, "reason" : null, "ready_replicas" : 0, "replicas" : 1, "description" : "", "created_at" : "2022-01-25 15:57:07 GMT+08:00", "source" : "userdefined", "api_version" : null, "node_ids" : [ "hilens-e17b497c3a00406f89f605e5c16b40d7" ], "result" : [ { "node_id" : "hilens-e17b497c3a00406f89f605e5c16b40d7" } ], "cluster_id" : "", "updated_at" : "2022-01-25 15:57:07 GMT+08:00", "project_id" : "fff47e1722f94c4e98531bae56821372", "name" : "example1", "id" : "hilens-9eebd2c03a2e48a6a47949fcb4f3f66f", "state" : "CREATING"}

请求示例 更新自定义技能 https://{endpoint}/v3/8c79e1e7ff39437680a67783feb0e815/ai-mgr/deployments/8c79e1e7ff39437680a67783feb0e811{ "deployment" : { "replicas" : 1, "template" : { "configs" : { "restart_policy" : "Always", "host_network" : false }, "apps" : [ { "privileged" : false, "resources" : { "limits" : { "cpu" : "0.25", "memory" : "128" }, "requests" : { } }, "name" : "iamge", "app_url" : "xxx" } ] } }}

URI PUT /v3/{project_id}/ai-mgr/deployments/{deployment_id} 表1 路径参数 参数 是否必选 参数类型 描述 deployment_id 是 String 部署ID project_id 是 String 项目ID，获取方法请参见获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 provider 否 String 平台提供者，分别为hilens及ief。当为hilens时，请求部署在hilens平台的相关数据。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。获取方法请参见获取Token 表3 请求Body参数 参数 是否必选 参数类型 描述 version 否 String 技能版本，可选，当下发的技能版本和当前部署的版本不一致的时候，根据技能模板参数更新部署 patch 否 Patch object 增量更新的部署参数 表4 Patch 参数 是否必选 参数类型 描述 envs 否 Array of Env objects 环境变量更新 表5 Env 参数 是否必选 参数类型 描述 name 是 String 环境变量的key，由大小写字母或下划线开头，由数字、大小写字母、下划线组成，最大长度2048个字符，不允许重复 value 否 String 环境变量的value，最大长度20480个字符。value、value_from和field_path必须三选一使用 value_from 否 ValueFrom object 环境变量可使用配置项和密钥导入。value、value_from和field_path必须三选一使用 field_path 否 String 该参数目前只支持赋值"status.hostIP"，即引用边缘节点的IP地址作为环境变量。value、value_from和field_path必须三选一使用 表6 ValueFrom 参数 是否必选 参数类型 描述 configmap 否 ConfigsMap object 环境变量引用配置项时使用。使用ValueFrom时，secret与configmap必须二选一 secret 否 DeploymentSecrets object 环境变量引用密钥时使用。使用ValueFrom时，secret与configmap必须二选一 表7 ConfigsMap 参数 是否必选 参数类型 描述 key 是 String 配置项的名称，以英文字母或中划线开头，由英文字母、数字、点号、中划线和下划线组成，长度1到63个字符。 name 是 String 配置项的属性名，以英文小写字母开头，由中文字符，英文字母，数字，下划线和中划线组成，不能以中划线结尾，长度4-64位。 表8 DeploymentSecrets 参数 是否必选 参数类型 描述 name 否 String 密钥的名称，以英文小写字母开头，由中文字符，英文字母，数字，下划线和中划线组成，不能以中划线结尾，长度4-64位 key 否 String 密钥的属性名，以英文字母和中划线开头，由英文字母、数字、点号、中划线和下划线组成，长度1-63位

响应示例 状态码： 200 请求成功，当批量更新部署节点个数小于20个的时候，返回结果result字段非空，当大于20个的时候，result字段为空，此时可通过回调机制获取部署结果。 { "template" : { "configs" : { "migration" : false, "host_network" : false, "host_pid" : false, "restart_policy" : "Always", "toleration_seconds" : 0 }, "apps" : [ { "name" : "example1-skill-name", "args" : [ ], "command" : [ "--log_dir=/train --learning_rate=0.01 --batch_size=150" ], "resources" : { "limits" : { "cpu" : "0.25", "memory" : "128" }, "requests" : { } }, "envs" : [ { "name" : "IVA_SVC_CONFIG", "value" : "{\"algorithm\":{\"multiTask\":\"no\",\"algType\":\"hilens\"},\"cloud\":{\"disEndpoint\":\"https://dis.cn-north-7.myhuaweicloud.com\",\"region\":\"cn-north-7\"},\"svcInstanceId\":\"modelbox-instance-xxxx\"}" } ], "msgs" : [ ], "ports" : [ { "container_port" : 10, "host_port" : 23, "host_ip" : "10.10.10.10" } ], "privileged" : false, "volumes" : [ { "name" : "tmp", "type" : "emptyDir", "source" : "memory", "destination" : "/tmp", "read_only" : false }, { "name" : "run", "type" : "emptyDir", "source" : "memory", "destination" : "/run", "read_only" : false }, { "name" : "cgroup", "type" : "hostPath", "source" : "/sys/fs/cgroup", "destination" : "/sys/fs/cgroup", "read_only" : true } ], "app_url" : "xxx", "is_modelbox" : true } ] }, "reason" : null, "ready_replicas" : 0, "replicas" : 1, "description" : "", "created_at" : "2022-01-25 15:57:07 GMT+08:00", "source" : "userdefined", "api_version" : null, "node_ids" : [ "hilens-e17b497c3a00406f89f605e5c16b40d7" ], "result" : [ { "node_id" : "hilens-e17b497c3a00406f89f605e5c16b40d7" } ], "cluster_id" : "", "updated_at" : "2022-01-25 15:57:07 GMT+08:00", "project_id" : "fff47e1722f94c4e98531bae56821372", "name" : "example1", "id" : "hilens-9eebd2c03a2e48a6a47949fcb4f3f66f", "state" : "CREATING"}

请求示例 基于技能版本参数更新部署信息 PATCH https://{endpoint}/v3/{project_id}/ai-mgr/deployments/{deployment_id}{ "version" : "0.0.2"} 增量更新部署中的环境变量 PATCH https://{endpoint}/v3/{project_id}/ai-mgr/deployments/{deployment_id}Request Header: Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...Request Body:{ "patch": { "envs": [ { "name": "aaaaaaaaaaaaaaaaa1", "value": "1" }, { "name": "aaaaaaaaaaaaaaaa2", "value": "2" }, { "name": "yyyyyyyyyyyyyyyy1", "field_path": "status.hostIP" } ] }}

请求示例 更新某个作业 POST https://{endpoint}/v3/{project_id}/ai-mgr/deployments/{deployment_id}/task/{task_id}{ "business" : "string", "data" : { "streams" : [ { "common" : { }, "input" : { "data" : { }, "type" : "string" }, "outputs" : [ { "data" : { }, "type" : "string" } ] } ], "task_id" : "string", "start_time_info" : { "start_time" : "string", "frequency" : "string", "mode" : "string", "day_time_frame" : [ { "start" : "string", "stop" : "string" } ], "single_time_frame" : [ { "start" : "string", "stop" : "string" } ] } }, "description" : "string", "instance_id" : "string", "name" : "string", "timestamp" : "string"}