文档首页/ 推荐系统 RES/ API参考/ API/ 训练作业/ 查询训练作业

更新时间：2022-05-13 GMT+08:00

查看PDF

查询训练作业

功能介绍

查询resource_id（数据源id或场景id）下的指定类型的作业。

调试

您可以在API Explorer中调试该接口。

URI

GET /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/job-instance

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目id，获取方式请参见获取项目ID
resource_id	是	String	资源id（数据源id 或场景id）
workspace_id	是	String	工作空间id

表2 Query参数
参数	是否必选	参数类型	描述
category	是	String	类别： RECALL，召回作业 DATASOURCE，数据源作业 FILTER，过滤作业 SORTING，排序作业 EVALUATE，效果评估作业

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	否	String	内容类型，取值为application/json
X-Auth-Token	是	String	用户token，获取方式请参见获取用户Token

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
is_success	Boolean	是否成功
jobs	Array of jobs objects	作业详情
message	String	返回消息（请求成功时，不返回此字段）
error_code	String	错误码（请求成功时，不返回此字段）

表5 jobs
参数	参数类型	描述
category	String	类别。
config_info	String	配置信息。
description	String	描述。
job_id	String	作业id。
job_name	String	作业名称。
job_type	String	作业类型。
next_schedule_time	Integer	下次调度时间。
platform	String	平台。
resource_id	String	资源id。
schedule	String	调度参数。
status	String	状态。
workspace_id	String	工作空间id。
job_config	jobConfig object	作业配置。

表6 jobConfig
参数	参数类型	描述
nearline_recall_param	NearLineRecallParam object	近线召回作业参数（近线召回作业需要提供此参数）。
max_recommended_num	Integer	最大候选集个数（所有召回作业需提供此参数）。最小值：1 最大值：200
match_feature_pairs	Array of MatchFeaturePair objects	匹配特征对（属性匹配召回作业需要提供此参数）。
striping	Striping object	行条化策略（属性匹配召回作业、物品协同过滤召回作业、用户协同过滤召回作业需要提供此参数）。
match_type	String	匹配类型（属性匹配召回作业需提供此参数）： UI，基于用户推荐物品 UU，基于用户推荐用户 II，基于物品推荐物品 IU，基于物品推荐用户
matrix_factorization	MatrixFactorization object	矩阵分解参数配置（交替最小二乘协同过滤作业需提供此参数）。
behavior_frequencys	Array of BehaviorFrequency objects	行为频率信息（历史行为记忆召回作业、历史行为过滤作业需提供此参数）。
file_path	String	文件路径（人工配置候选集作业需要提供此参数）。
ucb_param	UcbParam object	UCB作业参数（UCB召回作业需要提供此参数）。
behavior_gravity	BehaviorGravity object	重力衰减因子（综合行为热度召回作业需要提供此参数）。
category	Category object	类别（综合行为热度召回作业需要提供此参数）。
behavior_logic	String	行为逻辑过滤（历史行为过滤作业需提供此参数）： AND，同时满足则过滤 OR，满足一个则过滤
features_engineering	EtlBasicParameter object	特征参数（离线特征工程作业需要提供此参数）。
sample_param	SampleParam object	样本参数（离线特征工程作业需要提供此参数）。
deep_learning_parameters	DeepLearingParam object	排序作业通用参数（LR、DEEPFM、AutoGroup需要提供此参数）。
algorithm_specify_parameters	AlgorithmSpecifyParameters object	排序算法特定参数（LR、DEEPFM、AutoGroup需要提供此参数）。
load_widetable	Boolean	导入宽表（离线数据导入作业需要提供此参数）。
load_profile	Boolean	导入画像（离线数据导入作业需要提供此参数）。
save_mode	String	保留已有宽表（离线数据导入作业需要提供此参数）： append，是 new，否 overwirte，覆盖
indicators	Array of Indicator objects	统计指标（效果评估作业需要提供此参数）。
offline_rank_job_name	String	离线排序作业名称（在线训练任务需要提供此参数）。
update_interval	Integer	更新周期（在线训练任务需要提供此参数）。
optimizer	Optimizer object	优化器（在线训练任务需要提供此参数）。
flows	Flow object	在线流程（在线训练任务需要提供此参数）。

表7 NearLineRecallParam
参数	参数类型	描述
time_limit	Boolean	时间过滤。
timeFeature	String	时间特征。
retainDays	Integer	保留期(天)。
recall_fileds	Array of RecallFiled objects	召回字段。
itemCF_job_name	String	物品协同过滤作业名称。

表8 RecallFiled
参数	参数类型	描述
name	String	字段名称。
value	Integer	使用字段值的个数。最小值：1 最大值：10 缺省值：1

表9 MatchFeaturePair
参数	参数类型	描述
user_feature_name	String	用户特征。
item_feature_name	String	物品特征。
weight	Double	权重。
match_count	Boolean	匹配个数度量。

**表10** Striping
参数	参数类型	描述
nearest_neighborhood	Integer	最近领域个数。
band	Integer	相似程度。最小值：1 最大值：20
row	Integer	相似距离。最小值：1 最大值：10

**表11** MatrixFactorization
参数	参数类型	描述
implicit_vector_rank	Integer	隐向量维度。最小值：1 最大值：100
regular_param	Double	优化正则化系数。最小值：1.0E-8 最大值：1
max_iterator_num	Integer	迭代次数。最小值：1 最大值：50

**表12** BehaviorFrequency
参数	参数类型	描述
behavior_type	String	行为类型： view，曝光 click，点击 collect，收藏 uncollect，取消收藏 search_click，搜索后点击 comment，评论 share，分享 like，点赞 dislike，点衰 grade，评分 consume，消费 use，观看视频/听音乐/阅读 download，下载 tip，打赏 subscribe，关注
lower_limit	Integer	最小次数。最小值：1
upper_limit	Integer	最大次数。最小值：1
time_interval	Integer	时间区间。最小值：1

**表13** UcbParam
参数	参数类型	描述
alpha	Double	折中参数。最小值：0 最大值：1
min_used_num	Integer	最小行为次数。最小值：30 最大值：1000

**表14** BehaviorGravity
参数	参数类型	描述
weaken_factor	Double	衰减因子。最小值：0.1 最大值：5
view_type	String	行为次数统计方法： pv，访问量 uv，独立访客
algo_type	String	算法类型: normal，通用 time，时间

**表15** Category
参数	参数类型	描述
user_meta_list	Array of strings	用户特征。
item_meta_list	Array of strings	物品特征。

**表16** EtlBasicParameter
参数	参数类型	描述
user_features	Array of FeatureTransformation objects	用户特征。
item_features	Array of FeatureTransformation objects	物品特征。
rank_etl_filter	RankETLFilter object	过滤参数。

**表17** FeatureTransformation
参数	参数类型	描述
attr	Attribute object	特征。
discrete_method	String	离散方法： equal_distance_discrete，等距离散 user_define_discrete，自定义离散 normalize，归一化 null，不离散
params	Object	具体处理参数。

**表18** Attribute
参数	参数类型	描述
name	String	名称。
data_type	String	数据类型。
other_uses	Array of strings	其他用途。

**表19** RankETLFilter
参数	参数类型	描述
filter_type	String	行为去重方式： abs_weight，权重绝对值 date，日期
time_type	String	时间类型： day，天 week，周 month，月
is_monday_first	Boolean	周一是否是第一天。

**表20** SampleParam
参数	参数类型	描述
divide_type	String	训练集测试集划分方式： TIME，时间比例 RAMDOM，个数比例
train_rate	Double	训练数据占比。最小值：0.01 最大值：1
test_rate	Double	测试数据占比。最小值：0.01 最大值：1

**表21** DeepLearingParam
参数	参数类型	描述
initial_parameters	Initial object	初始化参数。
optimize_parameters	Optimizer object	优化参数。
regular_parameters	Regular object	正则化参数。
max_iterations	Integer	最大迭代轮数。最小值：1 最大值：1000
early_stop_iterations	Integer	提前终止训练轮数。最小值：1 最大值：1000
batch_size	Integer	批量大小。最小值：1
dataset_split_parts	Integer	训练数据集切分数量。最小值：1 最大值：10
restart_train	Boolean	重新训练。

**表22** Initial
参数	参数类型	描述
initial_method	String	初始化方法。
mean_value	Double	平均值。最小值：-1 最大值：1
standard_deviation	Double	标准差。最小值：0 最大值：1
min_value	Double	最小值。最小值：-1 最大值：0
max_value	Double	最大值。最小值：0 最大值：1

**表23** Optimizer
参数	参数类型	描述
type	String	优化器类型。
learning_rate	Double	学习率。
initial_accumulator_value	Double	初始梯度累加和。最小值：0 最大值：1
lambda1	Double	L1正则项系数。最小值：0 最大值：1
lambda2	Double	L2正则项系数。最小值：0 最大值：1
epsilon	Double	数值稳定常量。最小值：0 最大值：1
decay_rate	Double	衰减因子。最小值：0 最大值：1
decay_steps	Double	衰减步长。最小值：1

**表24** Regular
参数	参数类型	描述
l2_regularization	Double	L2正则项系数。最小值：0 最大值：1
regular_loss_compute_mode	String	正则损失计算方式。
embed_l2_regularization	Double	隐向量层L2正则化系数。最小值：0 最大值：1
wide_l2_regularization	Double	wide部分L2正则化系数。最小值：0 最大值：1
structure_l2_regularization	Double	结构化部分L2正则化系数。最小值：0 最大值：1

**表25** AlgorithmSpecifyParameters
参数	参数类型	描述
latent_vector_length	Integer	隐向量长度(DEEPFM需要提供此参数)。最小值：1 最大值：100
architecture	Array of integers	神经网络结构(DEEPFM需要提供此参数)。
active_function	String	激活函数(DEEPFM需要提供此参数,AutoGroup需要提供此参数)。
value_keep_probability	Double	神经元值保留概率(DEEPFM需要提供此参数,AutoGroup需要提供此参数)。最小值：0 最大值：1
embed_size	Array of integers	各阶隐向量长度(AutoGroup需要提供此参数)。
mlp_architecture	Array of integers	神经网络结构(AutoGroup需要提供此参数)。
max_order	Integer	最大交互阶数(AutoGroup需要提供此参数)。
hash_sizes	Array of integers	哈希长度(AutoGroup需要提供此参数)。
hash_compensation	Array of numbers	特征交互层惩罚项系数(AutoGroup需要提供此参数)。
use_wide_part	Boolean	使用线性部分(AutoGroup需要提供此参数)。
structure_optimizer	Optimizer object	优化器参数(AutoGroup需要提供此参数)。
merge_multi_hot	Boolean	融合多值特征(AutoGroup需要提供此参数)。
fix_structure	Boolean	固定哈希结构(AutoGroup需要提供此参数)。

**表26** Indicator
参数	参数类型	描述
indicator_name	String	指标名称： clickPVRate，点击PV率 clickUVRate，点击UV率 customize，自定义
indicator_params	IndicatorParam object	指标参数（自定义指标需要提供）。

**表27** IndicatorParam
参数	参数类型	描述
customize_parameter	CustomizeParameter object	自定义参数。
customize_formula	CustomizeFormula object	自定义公式。

**表28** CustomizeParameter
参数	参数类型	描述
alias	String	别名。
behavior_type	String	行为类型。
threshold	Double	阈值。最小值：0 最大值：1
deduplication	String	去重。

**表29** CustomizeFormula
参数	参数类型	描述
alias	String	别名。
formula	String	公式。

**表30** Flow
参数	参数类型	描述
flow_id	String	流程id。
attr_pair_rules_filter	Array of AttrPairRules objects	属性对过滤。
attr_pair_rules_reserve	Array of AttrPairRules objects	属性对保留。
deduplication_list	Array of Deduplication objects	属性去重。
attribute_info	AttributeInfo object	综合排序信息。
bloom_filter_conf	BloomFilterConf object	布隆过滤器配置。
group_attr	String	分组打散属性。
pre_deal	Boolean	在排序前去重。
rank_setting	String	排序配置信息。
rules	Rule object	候选集融合。
filter_sets	Array of strings	过滤配置信息。
attr_value_rules_filter	Array of AttrValueRules objects	属性值过滤。
attr_value_rules_reserve	Array of AttrValueRules objects	属性值保留。
ctr_job	String	排序作业（使用点击率预估时需要提供此参数）。
ratio	Integer	流量占比。最小值：1 最大值：100
toppings	Array of strings	需要置顶的候选集列表。

**表31** AttrPairRules
参数	参数类型	描述
attr_pairs	Array of AttrPair objects	属性对。

**表32** AttrPair
参数	参数类型	描述
party_a	String	被推荐对象的属性名。
party_b	String	被推荐对象的属性名。

**表33** Deduplication
参数	参数类型	描述
attributes	Array of strings	属性。

**表34** AttributeInfo
参数	参数类型	描述
rank_feature_pairs	Array of RankFeaturePair objects	属性匹配对。
numerical_attrs	Array of NumericalAttr objects	属性权重。
num_statistics_type	String	统计方式： ORDER，顺序 ABS，绝对值

**表35** RankFeaturePair
参数	参数类型	描述
feature_name_a	String	待推荐对象的属性。
feature_name_b	String	被推荐对象的属性。
weight	Float	权重。最小值：0.01 最大值：1

**表36** NumericalAttr
参数	参数类型	描述
name	String	特征名。
weight	Float	权重。最小值：0.001 最大值：1

**表37** BloomFilterConf
参数	参数类型	描述
behaviors	Array of strings	待过滤行为类型。
interval	Integer	过滤时间。最小值：1 最大值：7

**表38** Rule
参数	参数类型	描述
table_name	String	候选集表名。
rule_ratio	Integer	规则占比。最小值：1 最大值：100
priority	Integer	优先级。最小值：1 最大值：10

**表39** AttrValueRules
参数	参数类型	描述
attr_values_a	Array of AttrValue objects	被推荐对象的属性-值配置。
attr_values_b	Array of AttrValue objects	待推荐对象的属性-值配置。

**表40** AttrValue
参数	参数类型	描述
name	String	属性名称。
value	String	属性值。

请求示例

查询指定类型的作业

/v2.0/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/workspaces/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/resources/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/job-instance?category=RECALL

-

响应示例

状态码： 200

{
  "jobs" : [ {
    "workspace_id" : "a79b01afa69d4ddc943aa3423fc43531",
    "resource_id" : "c27aea2b50004187a36fdbd136368895",
    "job_id" : "0516d537a82c460caf2b78ebd638eb3b",
    "job_name" : "ab",
    "description" : "",
    "platform" : "OFFLINE",
    "category" : "RECALL",
    "job_type" : "ItemCf",
    "status" : "FAILED",
    "job_config" : {
      "striping" : {
        "nearest_neighborhood" : 100.0,
        "band" : 4.0,
        "row" : 5.0
      },
      "max_recommended_num" : 100.0,
      "schedule" : "00 50 01 * * ?"
    },
    "enable" : 0,
    "smnEnable" : 0
  }, {
    "workspace_id" : "a79b01afa69d4ddc943aa3423fc43531",
    "resource_id" : "c27aea2b50004187a36fdbd136368895",
    "job_id" : "2bb9cce018364e9992537d0776009222",
    "job_name" : "r2",
    "description" : "00",
    "platform" : "OFFLINE",
    "category" : "RECALL",
    "job_type" : "AttributeMatch",
    "status" : "CANCELED",
    "job_config" : {
      "striping" : {
        "nearest_neighborhood" : 20.0,
        "band" : 4.0,
        "row" : 5.0
      },
      "max_recommended_num" : 100.0,
      "schedule" : "00 50 01 * * ?",
      "match_type" : "User-Item",
      "match_feature_pairs" : [ {
        "user_feature_name" : "age",
        "item_feature_name" : "category",
        "alias" : "a",
        "weight" : 1.0
      } ]
    },
    "enable" : 1,
    "smnEnable" : 0
  }, {
    "workspace_id" : "a79b01afa69d4ddc943aa3423fc43531",
    "resource_id" : "c27aea2b50004187a36fdbd136368895",
    "job_id" : "929d25d76a6f45b3a06490074949484b",
    "job_name" : "r4",
    "description" : "",
    "platform" : "OFFLINE",
    "category" : "RECALL",
    "job_type" : "ItemCf",
    "status" : "FAILED",
    "job_config" : {
      "striping" : {
        "nearest_neighborhood" : 100.0,
        "band" : 4.0,
        "row" : 5.0
      },
      "max_recommended_num" : 100.0,
      "schedule" : "00 50 01 * * ?"
    },
    "enable" : 1,
    "smnEnable" : 0
  }, {
    "workspace_id" : "a79b01afa69d4ddc943aa3423fc43531",
    "resource_id" : "c27aea2b50004187a36fdbd136368895",
    "job_id" : "ca3fa69dbbaa4dcea3a0f5d466af0742",
    "job_name" : "a",
    "description" : "",
    "platform" : "OFFLINE",
    "category" : "RECALL",
    "job_type" : "ItemCf",
    "status" : "FAILED",
    "job_config" : {
      "striping" : {
        "nearest_neighborhood" : 100.0,
        "band" : 4.0,
        "row" : 5.0
      },
      "max_recommended_num" : 100.0,
      "schedule" : "00 50 01 * * ?"
    },
    "enable" : 1,
    "smnEnable" : 0
  }, {
    "workspace_id" : "a79b01afa69d4ddc943aa3423fc43531",
    "resource_id" : "c27aea2b50004187a36fdbd136368895",
    "job_id" : "f79e55ca4e314d4188fab3045554efa8",
    "job_name" : "r3",
    "description" : "",
    "platform" : "OFFLINE",
    "category" : "RECALL",
    "job_type" : "BhvHistory",
    "status" : "RUNNING",
    "job_config" : {
      "behavior_frequencys" : [ {
        "time_interval" : 30.0,
        "behavior_type" : "view",
        "lower_limit" : 1.0,
        "upper_limit" : 1.0
      } ],
      "max_recommended_num" : 100.0,
      "schedule" : "00 50 01 * * ?"
    },
    "enable" : 1,
    "smnEnable" : 0
  } ],
  "is_success" : true
}

状态码

状态码	描述
200	OK

错误码

请参见错误码。

父主题： 训练作业

上一篇：新建多个训练作业

下一篇：修改训练作业参数

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询训练作业

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线