创建转发规则

POST

/v4/elb/create-rule

网络/负载均衡负载均衡

创建转发规则

请求参数

Body 参数application/json

action

object

规则目标

必需

type

string

必需

默认规则动作类型。取值范围：forward、redirect、deny(目前暂不支持配置为deny)

forwardConfig

object

可选

转发配置，当type为forward时，此字段必填

redirectListenerID

string

可选

重定向监听器ID，当type为redirect时，此字段必填

conditions

object

匹配规则数据

必需

serverNameConfig

object

可选

服务名称（type为server_name时必传）

type

string

必需

server_name 、url_path

urlPathConfig

object

可选

匹配路径（type为url_path时必传）

description

string

描述

可选

listenerID

string

监听器ID

必需

regionID

string

区域ID

必需

priority

integer <int32>

可选

底层不支持传参或修改，实际无效果

clientToken

string

可选

公有云需要暂无实际作用（非必填，并且此字段在私有云不具有实际意义）

示例

{
    "action": {
        "type": "string",
        "forwardConfig": {
            "targetGroups": [
                {
                    "targetGroupID": "string",
                    "weight": 0
                }
            ]
        },
        "redirectListenerID": "string"
    },
    "conditions": {
        "serverNameConfig": {
            "serverName": "string"
        },
        "type": "string",
        "urlPathConfig": {
            "matchType": "string",
            "urlPaths": "string"
        }
    },
    "description": "string",
    "listenerID": "string",
    "regionID": "string",
    "priority": 0,
    "clientToken": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/elb/create-rule' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": {
        "type": "string",
        "forwardConfig": {
            "targetGroups": [
                {
                    "targetGroupID": "string",
                    "weight": 0
                }
            ]
        },
        "redirectListenerID": "string"
    },
    "conditions": {
        "serverNameConfig": {
            "serverName": "string"
        },
        "type": "string",
        "urlPathConfig": {
            "matchType": "string",
            "urlPaths": "string"
        }
    },
    "description": "string",
    "listenerID": "string",
    "regionID": "string",
    "priority": 0,
    "clientToken": "string"
}'

返回响应

🟢200successful operation

application/json

Body

errorCode

string

错误码

可选

returnObj

object

返回结果

可选

string

转发规则ID

可选

statusCode

integer <int32>

可选

状态码 800 正常，900 错误

description

string

描述

必需

message

string

消息

必需

示例

{
    "errorCode": "string",
    "returnObj": {
        "ID": "string"
    },
    "statusCode": 0,
    "description": "string",
    "message": "string"
}

停止监听器

更新转发规则