文档首页/ 推荐系统 RES/ API参考/ API/ 在线服务/ 修改在线服务参数

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

查看PDF

修改在线服务参数

功能介绍

修改指定在线服务的元数据内容。

调试

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

URI

PUT /v2.0/{project_id}/workspaces/{workspace_id}/resources/{resource_id}/service-instance/{job_id}

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

表2 Query参数
参数	是否必选	参数类型	描述
Content-Type	是	String	内容类型，取值为application/json。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户token，获取方式请参见获取用户Token。

表4 请求Body参数
参数	是否必选	参数类型	描述
category	是	String	类别。
description	否	String	描述。
job_config	是	jobConfig object	作业配置。
job_name	是	String	作业名称。
job_type	是	String	作业类型。
schedule	是	String	调度参数。

表5 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	在线流程（在线训练任务需要提供此参数）。

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

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

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

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

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

**表11** 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

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

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

**表14** Category
参数	是否必选	参数类型	描述
user_meta_list	否	Array of strings	用户特征。
item_meta_list	否	Array of strings	物品特征。

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

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

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

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

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

**表20** 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	重新训练。

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

**表22** 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

**表23** 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

**表24** 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需要提供此参数)。

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

**表26** IndicatorParam
参数	是否必选	参数类型	描述
customize_parameter	否	CustomizeParameter object	自定义参数。
customize_formula	否	CustomizeFormula object	自定义公式。

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

**表28** CustomizeFormula
参数	是否必选	参数类型	描述
alias	否	String	别名。
formula	否	String	公式。

**表29** 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	需要置顶的候选集列表。

**表30** AttrPairRules
参数	是否必选	参数类型	描述
attr_pairs	否	Array of AttrPair objects	属性对。

**表31** AttrPair
参数	是否必选	参数类型	描述
party_a	否	String	被推荐对象的属性名。
party_b	否	String	被推荐对象的属性名。

**表32** Deduplication
参数	是否必选	参数类型	描述
attributes	否	Array of strings	属性。

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

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

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

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

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

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

**表39** AttrValue
参数	是否必选	参数类型	描述
name	是	String	属性名称。
value	是	String	属性值。

响应参数

状态码： 200

**表40** 响应Body参数
参数	参数类型	描述
is_success	Boolean	是否成功
message	String	返回消息
error_code	String	错误码（请求成功时，不返回此字段）

请求示例

更新推理服务

/v2.0/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/workspaces/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/resources/testuuidxxxxxxxxxxxxxxxxxxxxxxxx/service-instance/testuuidxxxxxxxxxxxxxxxxxxxxxxxx

{
  "job_name" : "res-test-service2",
  "description" : "inference service",
  "category" : "SERVICE",
  "job_type" : "infer",
  "job_config" : {
    "flows" : [ {
      "name" : "flow1",
      "model_version" : "1.0.11",
      "rules" : [ {
        "table_name" : "tesAlsCF-UIREC",
        "rule_ratio" : 100,
        "priority" : "1"
      } ],
      "filter_sets" : [ "tesFilter-FILTER" ]
    } ]
  }
}

响应示例

状态码： 200

{
  "is_success" : true,
  "message" : "Succeed to update instance."
}

状态码

状态码	描述
200	OK

错误码

请参见错误码。

父主题： 在线服务

上一篇：查询在线服务详情

下一篇：删除在线服务

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消

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

智能客服提问云社区提问

修改在线服务参数

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

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

7*24

备案

专业服务

退订

建议反馈

售前咨询热线