Alibaba Cloud Service Mesh：ASMGlobalRateLimiter CRD說明

欄位

類型

是否必選

說明

workloadSelector

map<string, string>

是

通過一個或多個標籤，指明限流配置生效的一組特定的工作負載。標籤搜尋的範圍限制在資源所在的配置命名空間。更多資訊，請參見Workload Selector。

isGateway

bool

否

限流配置生效的工作負載是否為網關，預設為false。

rateLimitService

RateLimitServiceConfig

是

限流服務配置。

configs

GlobalRateLimiterConfig[]

是

全域限流配置，可配置多條。

欄位

類型

是否必選

說明

host

string

是

限流服務Service的叢集網域名稱。

port

int

是

限流服務的Service gRPC連接埠。

timeout

Duration

否

網格代理串連限流服務的逾時時間。例如seconds: 1或nanos: 1000。nanos表示納秒。

欄位

類型

是否必選

說明

name

string

是

單條限流配置的名稱。

match

RatelimitMatch

是

匹配條件。

limit

GlobalServiceLimitConfig

是

限流閾值配置。

limit_overrides

GlobalRateLimitOverrideConfig[]

否

限流閾值覆蓋配置。可通過該欄位針對特定的請求指定單獨的限流閾值。支援配置多個覆蓋配置。

欄位

類型

是否必選

說明

vhost

VirtualHostMatch

是

VirtualHost匹配條件。

欄位

類型

是否必選

說明

unit

string

是

限流計量時間單位。取值：

• MINUTE：分

• SECOND：秒

quota

int

是

單位時間內允許的請求總量。

欄位

類型

是否必選

說明

request_match

RequestMatcher

是

限流閾值覆蓋配置指定的請求匹配條件。只有匹配條件的請求會應用覆蓋配置中的限流閾值。

limit

GlobalServiceLimitConfig

是

限流閾值覆蓋配置指定的請求限流閾值。

欄位

類型

是否必選

說明

name

string

是

匹配的VirtualHost名稱。

port

int

否

匹配的請求連接埠。

route

RouteMatch

否

匹配的請求介面對應的路由名稱。

欄位

類型

是否必選

說明

name_match

string

否

匹配的路由名稱，對應VirtualService下的單條路由名稱。

header_match

HeaderMatcher[]

否

匹配服務要求的Header，支援配置多個。

欄位

類型

是否必選

說明

header_match

HeaderMatcher[]

否

匹配請求的header，支援配置多個。

remote_address

RemoteAddressMatcher

否

匹配請求的源IP。

query_match

QueryParameterMatcher[]

否

匹配請求的查詢參數（query params），支援配置多個。

欄位

類型

是否必選

說明

address

string

是

匹配的請求源的IP地址。

v4_prefix_mask_len

unit32

否

如果需要匹配IPv4位址範圍，在此欄位填寫IPv4地址子網路遮罩長度，並在address處填寫IPv4地址。將會匹配address在掩碼後的位址範圍。

v6_prefix_mask_len

unit32

否

如果需要匹配IPv6位址範圍，在此欄位填寫IPv6地址子網路遮罩長度，並在address處填寫IPv6地址。將會匹配address在掩碼後的位址範圍。

欄位

類型

是否必選

說明

name

string

否

Header名稱。

任選其一

regex_match

string

否

Regex匹配。

exact_match

string

否

精確匹配。

prefix_match

string

否

首碼匹配，以什麼開頭進行匹配。

suffix_match

string

否

尾碼匹配，以什麼結尾進行匹配。

present_match

bool

否

• 配置為true，表示存在Header即可，無需關注Header Value的取值。

• 配置為false，表示不存在Header。

invert_match

bool

否

預設為false。

• 配置為true，表示上述匹配結果取反。

• 配置為false，表示遵循上述匹配結果。

欄位

類型

是否必選

說明

name

string

是

查詢參數的名稱。

任選其一

exact_match

string

否

精確匹配查詢參數的內容。

prefix_match

string

否

首碼匹配查詢參數的內容。

suffix_match

string

否

尾碼匹配查詢參數的內容。

regex_match

string

否

Regex匹配查詢參數的內容。

contains_match

string

否

包含匹配查詢參數的內容，即要求查詢參數的內容必須包含某個子串。

present_match

bool

否

• 配置為true，表示進行存在性匹配，即存在指定的查詢參數即可，不關注內容。

• 不能配置false，配置為false等同於不配置，需要指定其它匹配條件。

ignore_case

bool

否

是否在匹配查詢參數時忽略大小寫。