数学规划求解器
创建任务
创建数学规划求解器-数学规划求解器任务， 该接口为异步操作，返回任务ID，任务的状态及结果请通过查询任务详情接口获取
URI
POST /v2/{project_id}/optverse/optverse-mpsolver/tasks
请求参数
备注：以下信息由用户提供
备注：以下信息由用户提供
求解器开放参数如下：
|
名称 |
类型 |
必选 |
描述 |
|---|---|---|---|
|
method |
int |
否 |
求解算法。[0,2]
|
|
timeLimit |
double |
否 |
求解时间上限，单位为秒。取值范围[0.0, 1e+20](1e+20) |
|
gap |
double |
否 |
仅对MIP问题有效。[0, 1]，默认值为0.0 |
响应参数
状态码： 201
创建成功响应信息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_id |
String |
任务编号 |
状态码： 400
客户端错误响应信息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
无 |
String |
响应错误信息，详见错误码列表 |
请求示例
{
"input_json": {
"input": {
"type": "obs",
"data": {
"bucket": "oroas-bi-data",
"object": "oroas-optvsolver/input/dcmulti.mps"
}
},
"output": {
"type": "obs",
"data": {
"bucket": "oroas-bi-data",
"object": "oroas-optvsolver/output"
}
},
"parameters": {
"time_limit": 60.0,
"gap": 0.0
}
}
}
或
{
"input_json": {
"input": {
"type": "base64",
"data": {
"content": "Kk5BTUU6ICAgICAgICAgZG....==",
"file_type": ".mps"
}
},
"output": {},
"parameters": {
"time_limit": 60.0,
"gap": 0.0
}
}
}
响应示例
成功响应示例
{
"task_id": "40axxxx-701a-47cf-8b56-648xxxxxxd25"
}
参数说明如表12所示。
{
"error_code": "JOB_MANAGER.12020007",
"error_msg": "The task input valid error, inputJson is null."
}
功能介绍
该API用于查询并显示数学规划求解器任务详情
URI
GET /v2/{project_id}/optverse/optverse-mpsolver/tasks/{task_id}
请求参数
|
名称 |
类型 |
IN |
必选 |
描述 |
|---|---|---|---|---|
|
X-Auth-Token |
string |
header |
是 |
用户凭证 |
|
project_id |
string |
path |
是 |
项目ID |
|
service_type |
string |
path |
是 |
子服务类型,针对不同服务, 用户侧不需单独赋值 |
|
task_id |
string |
path |
是 |
待查询任务id |
响应参数
状态码： 200
创建成功响应信息
|
参数 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
task_id |
sring |
是 |
任务id |
|
input_json |
string |
是 |
求解器不涉及表5 |
|
input |
是 |
求解器输入文件信息 |
|
|
output |
是 |
求解器输出文件信息 |
|
|
status |
string |
是 |
任务状态，包括：
|
|
progress |
string |
是 |
返回求解器日志。求解状态在日志最后显示，可能的状态包括： - Unknown: 未知状态，可能处于问题读取过程中，或其他未定义状态 - Time limit reached: 达到时间上限 - Memory limit reached: 达到宿主机内存上限 - Optimal solution found: 找到最优解（或达到目标gap） - Problem is infeasible: 问题不可行 - Problem is unbounded: 问题无边界 - Problem is infeasible or unbounded: 问题不可行或无边界 |
|
output_json |
string |
是 |
求解器服务不涉及 |
|
output_file_base64 |
string |
是 |
求解器服务不涉及 |
|
start_time |
String |
是 |
任务开始执行时间 |
|
end_time |
String |
是 |
任务结束时间 |
|
create_time |
String |
是 |
任务创建时间 |
状态码： 400
任务不存在
|
参数 |
参数类型 |
是否必选 |
描述 |
|---|---|---|---|
|
- |
- |
是 |
任务{0}不存在 |
响应示例
{
"task_id": "344fxxxx-0xxx-4xxx-a248-ce26cff7xxxx",
"input_json": null,
"obs_input_url": {
"bucket": "example_bucket",,
"object": " path/to/input/example.mps "
},
"obs_output_url": {
"bucket": "example_bucket",,
"object": "path/to/output/344fd304-0937-4d25-a248-ce26cff78388_completeResult.sol"
},
"status": "Running",
"progress": null,
"output_json": null,
"output_file_base64": null,
"start_time": "2023-00-00T07:19:35Z",
"end_time": null,
"create_time": "2023-00-00T07:19:33.607Z"
}
