APIのレート制限ルール・エントリー・ポイントの取得

すべてのレート制限ルールAPI操作は、レート制限ルールフェーズのエントリポイントルールセットの RULESET_ID を必要とする。 このエントリーポイント・ルールセットは、すでに存在する場合もあるし、存在しない場合は作成する必要がある。

以下の手順に従って、レート制限ルールのエントリポイントルールセットを取得する：

1. 正しい変数を使用して API 環境をセットアップします。

2. API コマンドで使用する以下の値を変数に格納します。

   CRN:サービス・インスタンスの完全な URL-encoded Cloud Resource Name（CRN）。

   ZONE_ID: ドメイン ID。

3. すべての変数が開始されたら、エントリーポイントのルールセットを取得する：

   curl -X GET "https://api.cis.cloud.ibm.com/v1/$CRN/zones/$ZONE_ID/rulesets/phases/http_ratelimit/entrypoint" \
   --header "X-Auth-User-Token: Bearer <API_TOKEN>" \
   --header "Content-Type: application/json"
   

ルールセットIDは、成功したリクエストのレスポンスに記載される。 上記の呼び出しが404 Not Found応答を返した場合、以下のAPIを使用して、レート制限ルールフェーズのエントリポイントルールセットを作成する：

curl -x POST https://api.cis.cloud.ibm.com/v1/$CRN/zones/$ZONE_ID/rulesets \
--header "X-Auth-User-Token: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "name": "Zone-level phase entry point",
  "kind": "zone",
  "description": "Rate-limting rule entry point ruleset.",
  "phase": "http_ratelimit"
}'

APIによるレート制限ルールの作成

APIを使用してレート制限ルールを作成するには、以下の手順に従ってください：

1. 正しい変数を使用して API 環境をセットアップします。

2. API コマンドで使用する以下の値を変数に格納します。

   CRN:サービス・インスタンスの完全な URL-encoded Cloud Resource Name（CRN）。

   ZONE_ID: ドメイン ID。

   RULESET_ID:レート制限ルールのエントリポイントルールセットのID。

3. すべての変数が開始されたら、レート制限ルールを作成する：

   curl -X POST "https://api.cis.cloud.ibm.com/v1/$CRN/zones/$ZONE_ID/rulesets/$RULESET_ID/rules" \
   --header "X-Auth-User-Token: Bearer <API_TOKEN>" \
   --header "Content-Type: application/json" \
   --data '{
     "description": "My rate limiting rule",
     "expression": "(http.request.uri.path matches \"^/api/\")",
     "action": "block",
     "ratelimit": {
       "characteristics": [
         "cf.colo.id",
         "ip.src"
       ],
       "period": 60,
       "requests_per_period": 100,
       "mitigation_timeout": 600
     }
   }'
   

APIによるレート制限ルールの更新

APIを使用して既存のレート制限ルールを更新するには、以下の手順に従ってください：

1. 正しい変数を使用して API 環境をセットアップします。

2. API コマンドで使用する以下の値を変数に格納します。

   CRN:サービス・インスタンスの完全な URL-encoded Cloud Resource Name（CRN）。

   ZONE_ID: ドメイン ID。

   RULESET_ID:レート制限ルールのエントリポイントルールセットのID。

   RULE_ID:変更するレート制限ルールのID。

3. すべての変数が開始されたら、レート制限ルールを更新する：

   curl -X PATCH "https://api.cis.cloud.ibm.com/v1/$CRN/zones/$ZONE_ID/rulesets/$RULESET_ID/rules/$RULE_ID" \
   --header "X-Auth-User-Token: Bearer <API_TOKEN>" \
   --header "Content-Type: application/json" \
   --data '{
     "enabled": true,
     "description": "rate limit IPs for API"
   }'
   

APIによるレート制限ルールの削除

APIを使用して既存のレート制限ルールを削除するには、以下の手順に従ってください：

1. 正しい変数を使用して API 環境をセットアップします。

2. API コマンドで使用する以下の値を変数に格納します。

   CRN:サービス・インスタンスの完全な URL-encoded Cloud Resource Name（CRN）。

   ZONE_ID: ドメイン ID。

   RULESET_ID:レート制限ルールのエントリポイントルールセットのID。

   RULE_ID:変更するレート制限ルールのID。

3. すべての変数が開始されたら、レート制限ルールを削除する：

   curl -X DELETE "https://api.cis.cloud.ibm.com/v1/$CRN/zones/$ZONE_ID/rulesets/$RULESET_ID/rules/$RULE_ID" \
   --header "X-Auth-User-Token: Bearer <API_TOKEN>" \
   --header "Content-Type: application/json"
   

コンソールのセクションのどれかに当てはまりますか？