# 查询超参搜索所有trial的结果 - ShowAutoSearchTrials #### 功能介绍 查询超参搜索所有trial的结果接口用于获取指定超参搜索任务中所有trial的详细结果。 该接口适用于以下场景：当用户需要查看超参搜索任务中所有trial的性能指标和状态信息时，可以通过此接口获取详细结果。使用该接口的前提条件是超参搜索任务已存在且用户具有相应的权限。查询操作完成后，接口将返回所有trial的详细结果信息。若超参搜索任务不存在或用户无权限操作，接口将返回相应的错误信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowAutoSearchTrials)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | modelarts:trainJob:get | Read | trainJob \* | g:ResourceTag/\ | - | - | | modelarts:trainJob:get | Read | - | - modelarts:poolType - modelarts:poolId | - | - | #### URI GET /v2/{project_id}/training-jobs/{training_job_id}/autosearch-trials 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释** ：用户项目ID。获取方法请参见[获取项目ID和名称](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制**：不涉及。 **取值范围**：1 - 64字符，字母、数字和中划线。 **默认取值**：不涉及。 | | training_job_id | 是 | String | **参数解释** ：训练作业ID。获取方法请参见[查询训练作业列表](https://support.huaweicloud.com/api-modelarts/ListTrainingJobs.html#ZH-CN_TOPIC_0000002723741806)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 否 | Integer | **参数解释**：返回的数据条目数。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 | | offset | 否 | Integer | **参数解释**：分页列表的起始页。 **约束限制**：最小为0。例如设置为0，则表示从第一页开始查询。 **取值范围**：不涉及。 **默认取值**：默认为0。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释**：超参搜索所有trial结果的个数。 **取值范围**：不涉及。 | | count | Integer | **参数解释**：超参搜索所有trial结果的当前页展示个数。 **取值范围**：不涉及。 | | limit | Integer | **参数解释**：超参搜索所有trial结果的当前页展示个数最大值。 **取值范围**：不涉及。 | | offset | Integer | **参数解释**：超参搜索所有trial结果的当前页数。 **取值范围**：不涉及。 | | group_by | String | **参数解释**：分类。 **取值范围**：不涉及。 | | items | [items] object | **参数解释**：超参搜索列表。 | 表4items | 参数 | 参数类型 | 描述 | |:---|:---|:---| | header | Array of strings | **参数解释**：超参搜索所有trial结果的字段信息。 | | data | Array\\> | **参数解释**：超参搜索所有trial结果的每条数据列表。 | #### 请求示例 如以下查询training_job_id为5b60a667-1438-4eb5-9705-85b860e623dc的作业的所有trial的信息。 ``` GET https://{endpoint}/v2/{project_id}/training-jobs/5b60a667-1438-4eb5-9705-85b860e623dc/autosearch-trials ``` #### 响应示例 **状态码：200** ``` { "total" : 8, "count" : 8, "limit" : 50, "offset" : 0, "group_by" : "", "items" : { "header" : [ "", "done", "pid", "config", "trial_id", "training_iteration", "time_total_s", "worker_index", "reward_attr", "status", "acc", "loss", "best_reward" ], "data" : [ [ "0", "True", "314", "batch_size: 32\nlearning_rate: 0.05512301741232006\ntrial_index: 0\nparam/batch_size: 32\nparam/learning_rate: 0.05512301741232006", "ae544174", "2", "19.477163314819336", "", "0.0625", "TERMINATED", "0.0625", "tensor(0.0754, device='cuda:0', requires_grad=True)", "0.0625" ], [ "1", "True", "315", "batch_size: 32\nlearning_rate: 0.0785570955603036\ntrial_index: 1\nparam/batch_size: 32\nparam/learning_rate: 0.0785570955603036", "ae548666", "2", "3.601897954940796", "", "0.0", "TERMINATED", "0.0", "tensor(0.0760, device='cuda:0', requires_grad=True)", "0.0" ], [ "2", "True", "312", "batch_size: 16\nlearning_rate: 0.04015387428829642\ntrial_index: 2\nparam/batch_size: 16\nparam/learning_rate: 0.04015387428829642", "ae54c0ea", "2", "3.5978384017944336", "", "0.1875", "TERMINATED", "0.1875", "tensor(0.1469, device='cuda:0', requires_grad=True)", "0.1875" ], [ "3", "True", "313", "batch_size: 32\nlearning_rate: 0.0340820322164706\ntrial_index: 3\nparam/batch_size: 32\nparam/learning_rate: 0.0340820322164706", "ae5503c0", "2", "3.641200304031372", "", "0.25", "TERMINATED", "0.25", "tensor(0.0716, device='cuda:0', requires_grad=True)", "0.25" ], [ "4", "True", "470", "batch_size: 32\nlearning_rate: 0.03656488928171769\ntrial_index: 4\nparam/batch_size: 32\nparam/learning_rate: 0.03656488928171769", "bef46590", "2", "3.6120550632476807", "", "0.09375", "TERMINATED", "0.09375", "tensor(0.0740, device='cuda:0', requires_grad=True)", "0.09375" ], [ "5", "True", "499", "batch_size: 32\nlearning_rate: 0.008413169003970163\ntrial_index: 5\nparam/batch_size: 32\nparam/learning_rate: 0.008413169003970163", "bef578f4", "2", "3.6379287242889404", "", "0.1875", "TERMINATED", "0.1875", "tensor(0.0723, device='cuda:0', requires_grad=True)", "0.1875" ], [ "6", "True", "528", "batch_size: 64\nlearning_rate: 0.06297447200613912\ntrial_index: 6\nparam/batch_size: 64\nparam/learning_rate: 0.06297447200613912", "bef5c584", "2", "3.711118221282959", "", "0.046875", "TERMINATED", "0.046875", "tensor(0.0381, device='cuda:0', requires_grad=True)", "0.046875" ], [ "7", "True", "557", "batch_size: 32\nlearning_rate: 0.04426479392014276\ntrial_index: 7\nparam/batch_size: 32\nparam/learning_rate: 0.04426479392014276", "bef60684", "2", "3.6971280574798584", "", "0.0625", "TERMINATED", "0.0625", "tensor(0.0778, device='cuda:0', requires_grad=True)", "0.0625" ] ] } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | ok | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。