Alibaba Cloud Service Mesh:ASMGlobalRateLimiter フィールドの説明

フィールド

タイプ

必須

説明

host

string

はい

グローバル速度制限サービスが存在するクラスターのドメイン名。

port

int

はい

グローバル速度制限サービスの gRPC サービスポート。

timeout

Duration

いいえ

メッシュプロキシがグローバル速度制限サービスに接続するためのタイムアウト期間。例: seconds: 1 および nanos: 1000。nanos はナノ秒を示します。

フィールド

タイプ

必須

説明

name

string

はい

速度制限ルールの名前。

match

RatelimitMatch

はい

一致基準。

limit

GlobalServiceLimitConfig

はい

速度制限しきい値の構成。

limit_overrides

GlobalRateLimitOverrideConfig[]

いいえ

構成済みの速度制限しきい値をオーバーライドするかどうかを指定します。このフィールドを使用して、特定のリクエストに対して個別に速度制限しきい値を指定できます。複数の速度制限しきい値オーバーライドを構成できます。

フィールド

タイプ

必須

説明

vhost

VirtualHostMatch

はい

仮想ホストの一致基準です。

フィールド

種類

必須

説明

単位

文字列

はい

速度制限時間の単位。有効な値：

• MINUTE：分

• SECOND：秒

クォータ

int

はい

単位時間あたりに許可されるリクエストの総数。

フィールド

タイプ

必須

説明

request_match

RequestMatcher

はい

速度制限しきい値のオーバーライド構成が適用される際にリクエストが一致する必要がある条件。オーバーライド構成で指定された速度制限しきい値は、条件に一致するリクエストにのみ適用されます。

limit

GlobalServiceLimitConfig

はい

速度制限しきい値のオーバーライド構成で指定された速度制限しきい値。

フィールド

タイプ

必須

説明

name

string

はい

一致させる仮想ホストの名前です。

port

int

いいえ

一致させるリクエスト ポートです。

route

RouteMatch

いいえ

一致させるリクエスト ポートに対応するルートの名前です。

フィールド

タイプ

必須

説明

name_match

string

いいえ

一致させるルートの名前。このフィールドは、仮想サービス内の単一のルートを指定します。

header_match

HeaderMatcher[]

いいえ

一致させるサービスリクエストのヘッダー。複数のヘッダーを設定できます。

フィールド

タイプ

必須

説明

header_match

HeaderMatcher[]

いいえ

リクエストを照合するためのヘッダー。複数のヘッダーを設定できます。

remote_address

RemoteAddressMatcher

いいえ

リクエストを照合するための送信元 IP アドレス。

query_match

QueryParameterMatcher[]

いいえ

リクエストを照合するためのクエリパラメーター。複数のクエリパラメーターを設定できます。

フィールド

タイプ

必須

説明

address

string

はい

リクエストを照合するための送信元 IP アドレス。

v4_prefix_mask_len

uint32

いいえ

IPv4 アドレス範囲を照合する場合、このフィールドに IPv4 アドレスのサブネットマスク長を入力し、address フィールドに IPv4 アドレスを入力します。 サブネットマスクを使用した後に計算されたアドレス範囲が照合されます。

v6_prefix_mask_len

uint32

いいえ

IPv6 アドレス範囲を照合する場合、このフィールドに IPv6 アドレスのサブネットマスク長を入力し、address フィールドに IPv6 アドレスを入力します。 サブネットマスクを使用した後に計算されたアドレス範囲が照合されます。

フィールド

タイプ

必須

説明

name

string

いいえ

ヘッダーの名前。

一致モードに基づいていずれかのフィールドを指定します

regex_match

string

いいえ

ヘッダー一致を実行するために使用される正規表現。 ヘッダー値は、指定された正規表現と一致する必要があります。

exact_match

string

いいえ

ヘッダー一致を実行するために使用される値。 ヘッダー値は、指定された値と完全に一致する必要があります。

prefix_match

string

いいえ

ヘッダー一致を実行するために使用されるプレフィックス。 ヘッダー値は、指定された文字で始まる必要があります。

suffix_match

string

いいえ

ヘッダー一致を実行するために使用されるサフィックス。 ヘッダー値は、指定された文字で終わる必要があります。

present_match

bool

いいえ

• このパラメーターを true に設定すると、リクエストにヘッダーが存在するかどうかによってヘッダー一致が実行されます。 指定された名前のヘッダーは、リクエストに存在する必要があります。

• このパラメーターを false に設定すると、ヘッダーが存在しないかどうかによってヘッダー一致が実行されます。 指定された名前のヘッダーは、リクエストに存在できません。

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

いいえ

クエリパラメーターの一致を実行するときに、大文字と小文字を区別するかどうかを指定します。