创建一条伸缩策略

POST

/v4/scaling/rule/create

OperationId：ruleCreate

创建一条伸缩策略

请求参数

Body 参数application/json

regionID

string

资源池ID

必需

operateUnit

integer <int32>

必需

操作的单位个数（1）百分比（2）

cooldown

integer <int32>

可选

冷却时间告警策略时必填，单位：秒

operateCount

integer <int32>

操作数量（大于0）

必需

action

integer <int32>

必需

执行动作增加（1）减少（2）设置为N（3）

type

integer <int32>

必需

策略类型告警（1）定时（2）周期（3）

groupID

string

伸缩组ID

必需

name

string

规则名称

必需

executionTime

string

可选

触发时间 type为2、3时必填 TZ格式

effectiveFrom

string

可选

周期策略生效开始时间 type=3时必填 TZ格式

effectiveTill

string

可选

周期策略生效截止时间 type=3时必填 TZ格式

cycle

string

可选

周期月（1）周（2）天（3），type=3时必填

day

array[string]

可选

周/月的第几天，type=3且cycle为1、2时必填

triggerObj

object

可选

新建告警规则传规则内容

name

string

告警规则名称

可选

metricName

string

监控项

可选

statistics

string

可选

聚合方法：avg、max、min

comparisonOperator

string

可选

比较符：eq,gt,ge,lt,le

threshold

string

阈值

可选

0-100

period

string

可选

监控周期，例：5m、10m

evaluationCount

string

连续出现次数

可选

示例

// type=1 创建告警策略
// cooldown必选，triggerObj必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "cooldown": 300,
    "operateCount": 1,
    "action": 1,
    "type": 1,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test1-5",
    "triggerObj": {
        "statistics": "max",
        "name": "as-alarm-f88f",
        "period": "5m",
        "threshold": 50,
        "evaluationCount": 1,
        "comparisonOperator": "ge",
        "metricName": "cpu_util"
    }
}

// type=2 创建定时策略
// executionTime必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "executionTime": "2022-10-13 15:05:00",
    "operateCount": 1,
    "action": 1,
    "type": 2,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test1-4",
}

// type=3 创建周期策略
// executionTime、effectiveFrom、effectiveTill、cycle必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "executionTime": "2023-10-13 15:21:00",
    "effectiveFrom": "2023-10-13 15:44:00",
    "operateCount": 1,
    "action": 1,
    "type": 3,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test-Type3",
    "cycle": 3
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/scaling/rule/create' \
--header 'Content-Type: application/json' \
--data-raw '// type=1 创建告警策略
// cooldown必选，triggerObj必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "cooldown": 300,
    "operateCount": 1,
    "action": 1,
    "type": 1,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test1-5",
    "triggerObj": {
        "statistics": "max",
        "name": "as-alarm-f88f",
        "period": "5m",
        "threshold": 50,
        "evaluationCount": 1,
        "comparisonOperator": "ge",
        "metricName": "cpu_util"
    }
}

// type=2 创建定时策略
// executionTime必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "executionTime": "2022-10-13 15:05:00",
    "operateCount": 1,
    "action": 1,
    "type": 2,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test1-4",
}

// type=3 创建周期策略
// executionTime、effectiveFrom、effectiveTill、cycle必选
{
    "regionID": "TestRegionID",
    "operateUnit": 1,
    "executionTime": "2023-10-13 15:21:00",
    "effectiveFrom": "2023-10-13 15:44:00",
    "operateCount": 1,
    "action": 1,
    "type": 3,
    "groupID": "3697e730-9095-11ed-ac87-0242ac130008",
    "name": "zjy-policy-test-Type3",
    "cycle": 3
}'

返回响应

🟢200successful operation

application/json

Body

returnObj

object

返回对象

可选

ruleID

string

创建成功的策略id

可选

statusCode

integer <int32>

状态码

可选

message

string

消息

必需

description

string

描述

必需

errorCode

string

错误码

必需

示例

{
    "returnObj": {
        "ruleID": "3664a38a-540d-11ed-8599-0242ac120006"
    },
    "statusCode": 800
}

修改于 2024-05-13 10:08:43

查询伸缩活动详情

修改一条伸缩策略