# 查询训练作业下的成功模型 - listJobInstanceHistory #### 功能介绍 查询训练作业下的成功模型 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-tics/tics_05_0025.html)。 #### URI GET /v1/{project_id}/leagues/{league_id}/fl-job-instances 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，最大长度32，由字母和数字组成 | | league_id | 是 | String | 空间ID，最大长度32，由字母和数字组成 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 是 | Integer | 起始位置，最小值0，最大值2的32次方-1 | | limit | 是 | Integer | 查询个数，最小值0，最大值100 | | job_id | 否 | String | 作业id，最大长度32，由字母和数字组成 | | filter | 否 | String | ''''''''''''''过滤条件，最大值256 { "startTime": "", "endTime": "", "jobName": "", "creatorName": "", "desc": false, "status": \[ "NEW", "ACCEPTED", "RUNNING", "SUCCEEDED", "FAILED", "TERMINATED", "PENDING" \], "job_instance_type": \[ "SQL", "HFL", "VFL_TRAIN", "VFL_EVALUATE", "VFL_ID_TRUNCATION", "VFL_FEATURE_SELECTION", "VFL_SAMPLE_ALIGNMENT", "VFL_PREDICT" \], "agentId": "", "orderBy": "", "algorithmType": \[ "XG_BOOST", "LIGHT_BGM", "LOGISTIC_REGRESSION", "NEURAL_NETWORK" \], "jobInstanceId": "" }'''''''''''''' | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。由一个或多个字母数字+-=符号组成。 通过调用接口获取用户Token接口获取。 | | X-Language | 是 | String | 根据自己偏好的语言来获取不同语言的返回内容，zh-cn或者en_us | | Content-Type | 是 | String | 发送的实体的MIME类型。推荐用户默认使用application/json，有其他取值时会在具体接口中专门说明。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Long | 总个数，最小值0，最大值2的32次方-1 | | lists | Array of [TicsJobInstanceVo] objects | 作业列表，最大100 | 表5TicsJobInstanceVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 实例id，最大长度32 | | status | String | 作业、任务状态:NEW新建，SUBMITING提交中，ACCEPTED已接收，DEPLOYING部署中，RUNNING运行中，SUCCEEDED成功，FAILED失败，TERMINATED中止，TERMINATING中止中，PENDING等待中 | | ext | String | 参数等额外信息，最大长度512 | | job_name | String | 作业名称，最大长度128 | | job_instance_type | String | 作业类型。HFL横向联邦，SQL联邦分析，VFL_EVALUATE联邦评估，VFL_FEATURE_SELECTION特征选择，VFL_ID_TRUNCATIONId截断，VFL_PREDICT联邦预测，VFL_SAMPLE_ALIGNMENT样本对齐，VFL_TRAIN联邦训练 | | round_id | Integer | 作业执行总轮数，最小值0，最大值1000 | | start_time | String | 开始时间 | | end_time | String | 结束时间 | | result_ext | String | 参数等额外信息，最大长度512 | | job_partner | String | 参与方信息，最大长度128 | | is_single_predict | Boolean | 单方还是双方预测 | | metrics | String | 联邦学习模型评估指标 | #### 请求示例 查询训练作业下的成功模型 ``` get https://x.x.x.x:12345/v1/{project_id}/leagues/{league_id}/fl-job-instances?offset=0&filter=10 ``` #### 响应示例 **状态码：200** 查询训练作业下的成功模型 ``` { "total" : 1, "lists" : [ { "id" : "06e5d8fb7af6461793968e5365179929", "status" : "SUCCEEDED", "ext" : "{\"tree_num\":5,\"batch_size\":1,\"learning_task_type\":\"CLASSIFICATION\",\"label_agent\":\"c2efd9850deb44e3a64b00e555ddb04f\",\"epoch\":1,\"datasets\":\"c2efd9850deb44e3a64b00e555ddb04f.guest_f1_50w_1.tics002,edc8357011b0449ca985daabd531083c.host_f50_50w_1.space_creator\",\"label\":\"label\",\"predict_threshold\":\"0.5\",\"features\":\"c2efd9850deb44e3a64b00e555ddb04f.guest_f1_50w_1.f50,edc8357011b0449ca985daabd531083c.host_f50_50w_1.f0,edc8357011b0449ca985daabd531083c.host_f50_50w_1.f1,edc8357011b0449ca985daabd531083c.host_f50_50w_1.f2,edc8357011b0449ca985daabd531083c.host_f50_50w_1.f3,edc8357011b0449ca985daabd531083c.host_f50_50w_1.f49\",\"tree_depth\":5,\"label_dataset\":\"guest_f1_50w_1\",\"learning_rate\":\"0.5\",\"job_creation_agent\":\"edc8357011b0449ca985daabd531083c\",\"split_num\":5}", "job_name" : "xg_50&1_50w", "job_instance_type" : "VFL_TRAIN", "round_id" : 1, "start_time" : "2022-02-22T06:27:29.000+00:00", "end_time" : "2022-02-22T07:26:25.000+00:00", "result_ext" : "{\"round\":1,\"recall\":0.786,\"precision\":0.825,\"ks\":0.623,\"accuracy\":0.812,\"f1\":0.805,\"auc\":0.885}", "job_partner" : "tics002,space_creator" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询训练作业下的成功模型 | | 401 | 操作无权限 | | 500 | 内部服务器错误 |