このページの一部またはすべての情報は、S3NS の Cloud de Confiance に適用されない場合があります。詳細については、Google Cloud との違いをご確認ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

サービスレート制限ポリシーを設定する

このページでは、リージョン内部アプリケーションロードバランサのサービスレート制限ポリシーを設定する方法について説明します。

始める前に

サービスレート制限の概要をよく理解する。
次の API を有効にします。
- ネットワークセキュリティ API（networksecurity.googleapis.com）
- Network Services API（networkservices.googleapis.com）
API を有効にするには、次のコマンドを実行します。
```
gcloud services enable \
    networksecurity.googleapis.com \
    networkservices.googleapis.com
```
リージョン内部アプリケーションロードバランサをまだ構成していない場合は、VM インスタンスグループのバックエンドを使用してリージョン内部アプリケーションロードバランサを設定するのページを参照して作成してください。

サービスレート制限ポリシーを作成する

サービスレート制限ポリシーを作成するには、ターゲットとルールを定義する YAML ファイルを作成し、gcloud network-security service-rate-limit-policies コマンドを使用してインポートします。以降のセクションでは、サービスレート制限ポリシーの例を示します。

カスタムグループに基づいてレート制限を適用する

次の例では、HTTP ヘッダーのカスタムタグ x-custom-group-tag を使用して、group1 と group2 の 2 つのグループを識別します。1 分あたりのリクエスト数（RPM）は、group1 の場合は 10,000、group2 の場合は 20,000 に制限されます。

gcloud

custom-groups-policy.yaml ファイルを作成し、ポリシーパラメータを指定します。

$ cat >custom-groups-policy.yaml <<EOF
name: projects/PROJECT_ID/locations/LOCATION/rateLimitPolicies/custom-groups-policy
description: Rate limit each API key based on custom tags.
httpRules:
# Match on traffic on the custom tag header.
- to:
    destination:
      headerSet:
        headers:
        - name: "x-custom-group-tag"
          value:
            exact: "group1"

    rateLimitActions:
      - rateLimitBucket: rl_group1_rpm_limit

- to:
    destination:
      headerSet:
        headers:
        - name: "x-custom-group-tag"
          value:
            exact: "group2"

    rateLimitActions:
      - rateLimitBucket: rl_group2_rpm_limit

rateLimitBuckets:
- name: rl_group1_rpm_limit
  # Set threshold for ALL the traffic matching this bucket.
  keys:
  - keyType: ALL

  defaultLimit:
    countLimit:
      count: 10000
      interval: 1
      intervalUnit: MINUTES

- name: rl_group2_rpm_limit
  # Set threshold for ALL the traffic matching this bucket.
  keys:
  - keyType: ALL

  defaultLimit:
    countLimit:
      count: 20000
      interval: 1
      intervalUnit: MINUTES

targets:
- resource: projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_NAME
EOF

次のように置き換えます。

PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
LOCATION: 転送ルールのロケーション。
FORWARDING_RULE_NAME: 転送ルールの名前。

前の手順で作成した YAML ファイルをインポートして、サービスレート制限ポリシーを作成します。
```
gcloud network-security service-rate-limit-policies import custom-groups-policy \
 --source=custom-groups-policy.yaml \
 --location=LOCATION \
 --project=PROJECT_ID
```
次のように置き換えます。
- PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
- LOCATION: 転送ルールのロケーション。

すべてのクライアントにレート制限を適用する

次の例では、すべてのクライアントの 1 分あたりのリクエスト数を 10,000 件に制限しています。

gcloud

all-clients-policy.yaml ファイルを作成し、ポリシーパラメータを指定します。

$ cat >all-clients-policy.yaml <<EOF
name: projects/PROJECT_ID/locations/LOCATION/rateLimitPolicies/all-clients-policy
description: Service rate limiting example.
httpRules:
  # Match on all traffic.

  # Service rate limiting bucket
- rateLimitActions:
  - rateLimitBucket: rl_default_rpm_limit

rateLimitBuckets:
- name: "rl_default_rpm_limit"
  # Match on 'ALL' requests for this bucket.
  keys:
  - keyType: ALL

  defaultLimit:
    countLimit:
      count: 10000
      interval: 1
      intervalUnit: MINUTES

targets:
- resource: projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_NAME
EOF

次のように置き換えます。

PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
LOCATION: 転送ルールのロケーション。
FORWARDING_RULE_NAME: 転送ルールの名前。

前の手順で作成した YAML ファイルをインポートして、サービスレート制限ポリシーを作成します。
```
gcloud network-security service-rate-limit-policies import all-clients-policy \
 --source=all-clients-policy.yaml \
 --location=LOCATION \
 --project=PROJECT_ID
```
次のように置き換えます。
- PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
- LOCATION: 転送ルールのロケーション。

ホストと API キーに基づいてレート制限を適用する

次の例では、x-api-key HTTP ヘッダーから取得された API キーの一意の値ごとに、ホスト example.com を宛先とする API を 5 分あたり 1,000 リクエストにレート制限します。特別な API キー abc123 の上限は、5 分あたり 10,000 リクエストに引き上げられます。

gcloud

host-and-api-key-policy.yaml ファイルを作成し、ポリシーパラメータを指定します。

$ cat >host-and-api-key-policy.yaml <<EOF
name: projects/PROJECT_ID/locations/LOCATION/rateLimitPolicies/host-and-api-key-policy
description: Rate limit each api key.
httpRules:
  # Match on traffic to example.com
- to:
    destination:
      hosts:
      - exact: "example.com"

  rateLimitActions:
    - rateLimitBucket: rl_default_rpm_limit

rateLimitBuckets:
- name: rl_default_rpm_limit
  # Identify API key from its header, say 'x-api-key'.
  keys:
  - header: "x-api-key"
    keyType: HTTP_HEADER

  defaultLimit:
    countLimit:
      count: 1000
      interval: 5
      intervalUnit: MINUTES

  # Override the threshold for specific API key 'abc123'.
  userOverrides:
  - overrideKey:
      httpHeaders:
      - header: "x-api-key"
        value: "abc123"
    limit:
      countLimit:
        count: 10000
        interval: 5
        intervalUnit: MINUTES

targets:
- resource: projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_NAME
EOF

次のように置き換えます。

PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
LOCATION: 転送ルールのロケーション。
FORWARDING_RULE_NAME: 転送ルールの名前。

前の手順で作成した YAML ファイルをインポートして、サービスレート制限ポリシーを作成します。
```
gcloud network-security service-rate-limit-policies import host-and-api-key-policy \
 --source=host-and-api-key-policy.yaml \
 --location=LOCATION \
 --project=PROJECT_ID
```
次のように置き換えます。
- PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
- LOCATION: 転送ルールのロケーション。

URL パスとクライアント名に基づいてレート制限を適用する

次の例では、クライアント証明書の共通名で識別される各クライアントの /public パスでホストされている API を 1 分あたり 100 件のリクエストに制限します。

gcloud

path-and-client-name-policy.yaml ファイルを作成し、ポリシーパラメータを指定します。

$ cat >path-and-client-name-policy.yaml <<EOF
name: projects/PROJECT_ID/locations/LOCATION/rateLimitPolicies/path-and-client-name-policy
description: Simple API rate limiting example.
httpRules:
  # Match on traffic to /public .
- to:
    destination:
      paths:
      - exact: "/public"

  # Default RPM bucket
  rateLimitActions:
  - rateLimitBucket: rl_default_rpm_limit

rateLimitBuckets:
- name: "rl_default_rpm_limit"
  # Identify client by its client cert name
  keys:
  - keyType: PRINCIPAL
    principalType: CLIENT_CERT_COMMON_NAME
  defaultLimit:
    countLimit:
      count: 100
      interval: 1
      intervalUnit: MINUTES

targets:
- resource: projects/PROJECT_ID/regions/LOCATION/forwardingRules/FORWARDING_RULE_NAME

EOF

次のように置き換えます。

PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
LOCATION: 転送ルールのロケーション。
FORWARDING_RULE_NAME: 転送ルールの名前。

前の手順で作成した YAML ファイルをインポートして、サービスレート制限ポリシーを作成します。
```
gcloud network-security service-rate-limit-policies import path-and-client-name-policy \
 --source=path-and-client-name-policy.yaml \
 --location=LOCATION \
 --project=PROJECT_ID
```
次のように置き換えます。
- PROJECT_ID: 実際の Cloud de Confiance プロジェクト ID。
- LOCATION: 転送ルールのロケーション。

次のステップ

サービスレート制限ポリシーのログについて

サービス レート制限ポリシーを設定する

始める前に

サービス レート制限ポリシーを作成する

カスタム グループに基づいてレート制限を適用する

gcloud

すべてのクライアントにレート制限を適用する

gcloud

ホストと API キーに基づいてレート制限を適用する

gcloud

URL パスとクライアント名に基づいてレート制限を適用する

gcloud

次のステップ

サービスレート制限ポリシーを設定する

サービスレート制限ポリシーを作成する

カスタムグループに基づいてレート制限を適用する