5.1 弹性伸缩（即将下线）
5.1.3 更新策略
功能说明
该接口用于修改策略规则。
须知
告警策略支持更新，定时和周期策略不支持更新。
URI
PUT /v1/{project_id}/pe/policy/{policy_id}
参数说明请参见表5-12
表5-12 参数说明
参数名称 是否必选 描述
project_id 是 项目ID
policy_id 是 策略ID
请求消息
请求消息头
请求消息头如表5-13
表5-13 请求消息头
参数 描述 是否为必选 示例
Content-Type 内容类型 该字段内容填为
“application/
json;charset=utf-8
”
必选 application/
json;charset=utf-8
Cluster-Id 集群ID 必选
-Namespace 命名空间 必选
-
Deployment-Name 应用名 必选
-请求参数
请求参数如表5-14
表5-14 请求参数
参数名称 是否必选 参数类型 取值范围 描述
id 是 String - 策略ID
name 是 String 策略名称必须
为以0～9、a
～z、A～Z、
下划线（_）或 中划线（-）组 成的1~64位字 符串，且必须 以字母开头。
策略名称（不 支持修改）
参数名称 是否必选 参数类型 取值范围 描述 policy_type 是 String 告警策略：
ALARM 策略类型(当前 只支持告警策 略)
rule 是 参见表5-15 - 触发策略的规
则
表5-15 rule 字段数据结构说明
参数名称 是否必选 参数类型 取值范围 描述
conditions 是 参见表5-16 conditions最 多5个，最少1 个
匹配条件内 容。一个规则 可以有多个条 件，多个条件 之间的关系是
“并且”，内 部描述了多个 详细匹配条 件。一个条件 可以描述一个 metric的匹配 方式。
actions 是 参见表5-17 actions最多5
个，最少1个 指定策略匹配 成功后执行的 动作。
表5-16 conditions 字段数据结构说明
参数名称 是否必选 参数类型 取值范围 描述
metric_names
pace 是 String ● PAAS.CON
TAINER应 用指标的命 名空间
● PAAS.CUST OMMETRI CS：自定义 指标的命名 空间
指标命名空间
参数名称 是否必选 参数类型 取值范围 描述 metric_name 是 String 取值满足表达
式[a-zA-Z_:]
metric_unit 是 String - 单位
说明
随指标名称变 化而变化，具 体信息从AMS 接口获取
period 是 Integer 分别包括20，
60，300，
riods 是 Integer 1，2，3，4，
5 连续周期数
statistic 是 String 当前只支持平
均值（average）
统计方式 大于metric_thresh oldUpdate值 时触发actions
指标操作符
metric_thresh
old 是 Float [0，
2147483647] 阈值条件
表5-17 actions 字段数据结构说明
参数名称 是否必选 参数类型 取值范围 描述
type 是 String ● scale_out_
k8s
● scale_out_v m
● scale_in_k8 s
● scale_in_v m
● scale_out_
k8s、scale_out_v m表示扩 容。
● scale_in_k8 s、scale_in_v m表示缩
表5-18 parameters 字段数据结构说明
参数名称 是否必选 参数类型 取值范围 描述
scale_unit 是 Integer 在策略组的最 小实例数与最
{ "id" : "5c2eecea-32ac-42c0-be30-f73b15d68429", "name" : "policy_1",
"policy_type" : "ALARM", "rule" : {
} ] } }
响应消息
响应参数
响应参数如表5-19
表5-19 响应参数
参数名称 参数类型 描述
errorCode String 错误码
errorMessage String 详细信息
context String 修改后策略的详细信息
响应示例
{ "errorCode": 0, "errorMessage": "", "context": {
"id" : "5c2eecea-32ac-42c0-be30-f73b15d68429", "name" : "policy_1",
"policy_type" : "ALARM", "rule" : {
"conditions" : [{
"metric_namespace" : "PAAS.CONTAINER", "metric_name" : "cpuUsage",
"metric_unit" : "Percent", "period" : 60,
"evaluation_periods" : 1, "statistic" : "average", "metric_operation" : ">", "metric_threshold" : 70 }
],
"actions" : [{
"type" : "scale_out_k8s", "parameters" : { "scale_unit" : 1 }
} ] } } }
错误码
表5-20 错误码
错误码 错误信息 处理措施
SVCSTG.PE.4001101 Invalid parameter. 请检查对应的参数是否符 合要求。
SVCSTG.PE.4031012 Failed to verify the
project ID. 请检查对应的参数是否符 合要求。
SVCSTG.PE.4033008 Failed to update the scheduled or periodic policy.
请检查对应的参数是否符 合要求。
SVCSTG.PE.5001201 Failed to insert or update
data in the background. 请联系管理员解决。
SVCSTG.PE.5001203 Query error. 请联系管理员解决。
SVCSTG.PE.5003007 Failed to update the
threshold rule. 请联系管理员解决。