服务网格 ASM：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

否

正则表达式匹配。

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

否

正则表达式匹配查询参数的内容。

contains_match

string

否

包含匹配查询参数的内容，即要求查询参数的内容必须包含某个子串。

present_match

bool

否

• 配置为true，表示进行存在性匹配，即存在指定的查询参数即可，不关注内容。

• 不能配置false，配置为false等同于不配置，需要指定其它匹配条件。

ignore_case

bool

否

是否在匹配查询参数时忽略大小写。