華為云計算 云知識 更新轉發(fā)規(guī)則UpdateL7rule
更新轉發(fā)規(guī)則UpdateL7rule

 

功能介紹

更新轉發(fā)規(guī)則。通過修改轉發(fā)規(guī)則可以改變流量的匹配規(guī)則。

調試

您可以在API Explorer中直接運行調試該接口。

URI

PUT /v2/{project_id}/elb/l7policies/{l7policy_id}/rules/{l7rule_id}

表1 參數(shù)說明

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

操作用戶的項目ID。

獲取方法詳見獲取項目ID。

l7policy_id

String

轉發(fā)策略id。

l7rule_id

String

轉發(fā)規(guī)則id。

請求消息

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

rule

Rule object

轉發(fā)規(guī)則對象。詳見表3。

表3 rule字段說明

參數(shù)

是否必選

參數(shù)類型

描述

compare_type

String

轉發(fā)匹配方式:

type為HOST_NAME時,取值范圍:

  • EQUAL_TO:精確匹配;

type為PATH時,取值范圍:

  • REGEX:正則匹配;
  • STARTS_WITH:前綴匹配;
  • EQUAL_TO:精確匹配。

admin_state_up

Boolean

轉發(fā)規(guī)則的管理狀態(tài);

該字段為預留字段,暫未啟用。默認為true。

invert

Boolean

是否反向匹配;

取值范圍:true/false。默認值:false;

該字段為預留字段,暫未啟用。

key

String

匹配內容的鍵值。默認為null。

該字段為預留字段,暫未啟用。

支持的最大字符長度:255

value

String

匹配內容的值。不能包含空格。

支持的最大字符長度:128

  • 當type為HOST_NAME時,取值范圍:String (100),字符串只能包含英文字母、數(shù)字、“-”或“.”,且必須以字母或數(shù)字開頭。
  • 當type為PATH時,取值范圍:String (128)。當轉發(fā)規(guī)則的compare_type為STARTS_WITH、EQUAL_TO時,字符串只能包含英文字母、數(shù)字、_~';@^-%#&$.*+?,=!:| \/()[]{},且必須以"/"開頭。

響應消息

表4 響應參數(shù)

參數(shù)

參數(shù)類型

描述

rule

Rule object

轉發(fā)規(guī)則對象。詳見 表5。

表5 rule字段說明

參數(shù)

參數(shù)類型

描述

id

String

轉發(fā)規(guī)則ID

tenant_id

String

轉發(fā)規(guī)則所在的項目ID。

支持的最大字符長度:255

project_id

String

此參數(shù)和tenant_id參數(shù)含義一樣,均指轉發(fā)規(guī)則所在的項目ID。

admin_state_up

Boolean

轉發(fā)規(guī)則的管理狀態(tài);

該字段為預留字段,暫未啟用。取值范圍:true/false。

  • true表示開啟。
  • false表示關閉。

type

String

轉發(fā)規(guī)則的匹配類型。

取值范圍:

  • HOST_NAME:匹配請求中的域名;
  • PATH:匹配請求中的路徑;

compare_type

String

轉發(fā)匹配方式:

type為HOST_NAME時,取值范圍:

  • EQUAL_TO:精確匹配;

type為PATH時,取值范圍:

  • REGEX:正則匹配;
  • STARTS_WITH:前綴匹配;
  • EQUAL_TO:精確匹配。

invert

Boolean

是否反向匹配;

取值范圍:true/false。默認值:false;

該字段為預留字段,暫未啟用。

key

String

匹配內容的鍵值。默認為null。

該字段為預留字段,暫未啟用。

支持的最大字符長度:255

value

String

匹配內容的值。

支持的最大字符長度:128

  • 當type為HOST_NAME時,取值范圍:String (100),字符串只能包含英文字母、數(shù)字、“-”或“.”,且必須以字母或數(shù)字開頭。
  • 當type為PATH時,取值范圍:String (128)。當轉發(fā)規(guī)則的compare_type為STARTS_WITH、EQUAL_TO時,字符串只能包含英文字母、數(shù)字、_~';@^-%#&$.*+?,=!:| \/()[]{},且必須以"/"開頭。

provisioning_status

String

該字段為預留字段,暫未啟用。

轉發(fā)規(guī)則的配置狀態(tài),可以為ACTIVE。

請求示例

  • 請求樣例 更新轉發(fā)規(guī)則
    PUT https://{Endpoint}/v2/a31d2bdcf7604c0faaddb058e1e08819/elb/
    l7policies/5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586/rules/c6f457b8-bf6f-45d7-be5c-a3226945b7b1 { "rule": { "compare_type": "STARTS_WITH", "value": "/ccc.html" } }

響應示例

  • 響應樣例
    {
        "rule": {
            "compare_type": "STARTS_WITH", 
            "provisioning_status": "ACTIVE",
            "admin_state_up": true, 
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "invert": false, 
            "value": "/ccc.html", 
            "key": null, 
            "type": "PATH", 
            "id": "c6f457b8-bf6f-45d7-be5c-a3226945b7b1"
        }
    }

返回碼

請參見狀態(tài)碼