Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una regola di limitazione della frequenza.

• I campi obbligatori nei dati JSON sono match, threshold, period e action:
  • match: Determina quale traffico viene conteggiato dalla regola di limitazione della velocità ai fini del raggiungimento della soglia.
    • request: Corrisponde alle richieste di tipo " HTTP ".
      • methods: HTTP I metodi possono essere un sottoinsieme di [POST,PUT] oppure tutti quelli presenti su [_ALL_]. Questo campo non è obbligatorio per creare una regola di limite di frequenza. I valori validi sono GET, POST, PUT, DELETE, PATCH, HEAD, _ALL_.
      • schemes: HTTP Schemi: può trattarsi di uno solo [HTTPS], di entrambi [HTTP e HTTPS] oppure di tutti e tre [_ALL_]. Questo campo non è obbligatorio.
      • url: Il modello " URL " da abbinare, composto dall'host e dal percorso, ad esempio example.org/path. I caratteri jolly vengono espansi per corrispondere al traffico applicabile, le stringhe di query non hanno una corrispondenza. Utilizza * per tutto il traffico verso la tua zona. La lunghezza massima è 1024.
    • response: Individua le risposte di tipo " HTTP " prima che vengano restituite al client. Se questo valore è definito, l'intero conteggio del traffico avviene in questa fase.
      • status: HTTP Codici di stato: è possibile specificarne uno solo [403], più codici [401,403] oppure indicare tutti i codici omettendo questo valore. Questo campo non è obbligatorio. Il valore minimo è 100 e quello massimo è 999.
      • headers: Array di intestazioni di risposta da confrontare. Se una risposta non soddisfa i criteri relativi all'intestazione, la richiesta non viene conteggiata ai fini della regola di limitazione della frequenza. I criteri di corrispondenza dell'intestazione includono le seguenti proprietà.
        • name: Il nome dell'intestazione della risposta da cercare.
        • op: L'operatore utilizzato nella ricerca; "eq" significa "uguale a", "ne" significa "non uguale a". I valori validi sono eq e ne.
        • value: Il valore dell'intestazione, che corrisponde esattamente.
  • threshold: La soglia che attiva le misure di mitigazione del limite di velocità, associate a un periodo di tempo. Ad esempio, la soglia per periodo. Il valore minimo è 2 e quello massimo è 1000000.
  • period: Il tempo, in secondi, necessario per contare il traffico corrispondente. Se il conteggio supera la soglia entro tale periodo, l'azione viene eseguita. Il valore minimo è 10 e quello massimo è 86400.
  • action: L'azione eseguita quando viene superata la soglia del traffico corrispondente entro il periodo definito.
    • mode: Il tipo di azione eseguita. I valori validi sono: simulate, ban, challenge, js_challenge.
    • timeout: Il tempo, espresso in secondi e come numero intero, necessario per eseguire l'azione di mitigazione. Il timeout può essere uguale o superiore al periodo. Questo campo è valido solo quando la modalità è “ simulate ” o “ ban ”. Il valore minimo è 10 e quello massimo è 86400.
    • response: Tipo di contenuto e corpo personalizzati da restituire. Questo sovrascrive l'errore personalizzato per la zona. Questo campo non è obbligatorio. L'omissione risulta nella pagina di errore HTML predefinita. Questo campo è valido solo quando la modalità è simulate o ban.
      • content_type: Il tipo di contenuto del corpo del messaggio, che deve essere uno dei seguenti: text/plain, text/xml, application/json.
      • body: Il corpo che tornerà. Il contenuto qui fornito deve essere conforme a content_type. La lunghezza massima è 10240.
• I campi facoltativi sono id, disabled, description, correlate e bypass:
  • id: Identificatore della regola limitante la velocità.
  • disabled: Se questa regola di limitazione della velocità è attualmente disattivata.
  • description: Una nota che puoi utilizzare per descrivere il motivo alla base di una regola di limitazione della velocità.
  • correlate: Se abilitare la limitazione della velocità basata su NAT.
    • by: Il valore valido è nat.
  • bypass: Criteri che consentono di aggirare il limite di velocità. Ad esempio, per indicare che non si deve applicare un limite di frequenza a una serie di URL.
    • name: Il valore valido è url.
    • value: L'URL da bypassare.

Dati JSON di esempio:

{
   "id": "92f17202ed8bd63d69a66b86a49a8f6b",
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono specificati, viene utilizzata l'istanza di contesto indicata da ibmcloud cis instance-set INSTANCE.

--output

Il formato di output. Attualmente, " json " è l'unico valore supportato.

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

RATELIMIT_RULE_ID

L'ID della regola di limitazione della velocità. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzata per descrivere una regola di limitazione della velocità.

• I campi obbligatori nei dati JSON sono match, threshold, period e action:
  • match: Determina quale traffico viene conteggiato dalla regola di limitazione della velocità ai fini del raggiungimento della soglia.
    • request: Corrisponde alle richieste di tipo " HTTP ".
      • methods: HTTP I metodi possono essere un sottoinsieme di [POST,PUT] oppure tutti quelli presenti su [ALL]. Questo campo non è obbligatorio per creare una regola di limite di frequenza. I valori validi sono GET, POST, PUT, DELETE, PATCH, HEAD, ALL.
      • schemes: HTTP Schemi: può essere uno solo [HTTPS], entrambi [HTTP,HTTPS] oppure tutti [_ALL_]. Questo campo non è obbligatorio.
      • url: Il modello “ URL ” da abbinare era composto dall’host e dal percorso, ad esempio example.org/path. I caratteri jolly vengono espansi per corrispondere al traffico applicabile, le stringhe di query non hanno una corrispondenza. Utilizza * per tutto il traffico verso la tua zona. La lunghezza massima è 1024.
    • response: Individua le risposte di tipo " HTTP " prima che vengano restituite al client. Se questo campo è definito, il conteggio completo del traffico avviene in questa fase.
      • status: HTTP Codici di stato: è possibile specificarne uno solo [403], più codici [401,403] oppure indicare tutti i codici omettendo questo valore. Questo campo non è obbligatorio. Il valore minimo è 100 e quello massimo è 999.
      • headers: Array di intestazioni di risposta da confrontare. Se una risposta non soddisfa i criteri relativi all'intestazione, la richiesta non viene conteggiata ai fini della regola di limitazione della frequenza. Una serie di criteri di corrispondenza delle intestazioni comprende le seguenti proprietà.
        • name: Il nome dell'intestazione della risposta da cercare.
        • op: L'operatore utilizzato nella ricerca; "eq" significa "uguale a", "ne" significa "non uguale a". I valori validi sono eq e ne.
        • value: Il valore dell'intestazione, che corrisponde esattamente.
  • threshold: La soglia che attiva le misure di mitigazione del limite di velocità, che vengono combinate con il periodo. Ad esempio, la soglia per periodo. Il valore minimo è 2 e quello massimo è 1000000.
  • period: Il tempo, in secondi, necessario per contare il traffico corrispondente. Se il conteggio supera la soglia entro tale periodo, l'azione viene eseguita. Il valore minimo è 1 e quello massimo è 3600.
  • action: L'azione viene eseguita quando viene superata la soglia del traffico corrispondente entro il periodo definito.
    • mode: Il tipo di azione eseguita. I valori validi sono simulate, ban, challenge, js_challenge.
    • timeout: Il tempo, in secondi, espresso come numero intero, necessario per eseguire l'azione di mitigazione. Il timeout è uguale o superiore al periodo. Questo campo è valido solo quando la modalità è simulate o ban. Il valore minimo è 10 e quello massimo è 86400.
    • response: Tipo di contenuto e corpo personalizzati da restituire. Questo sovrascrive l'errore personalizzato per la zona. Questo campo non è obbligatorio. L'omissione risulta nella pagina di errore HTML predefinita. Questo campo è valido solo quando la modalità è simulate o ban.
      • content_type: Il tipo di contenuto del corpo del messaggio, che deve essere uno dei seguenti: text/plain, text/xml, application/json.
      • body: Il corpo che tornerà. Il contenuto qui fornito deve essere conforme a content_type. La lunghezza massima è 10240.
• I campi facoltativi sono disabled, description, correlate e bypass:
  • disabled: Se questa regola di limitazione della velocità è attualmente disattivata.
  • description: Una nota che puoi utilizzare per descrivere il motivo alla base di una regola di limitazione della velocità.
  • correlate: Se abilitare la limitazione della velocità basata su NAT.
    • by: Il valore valido è nat.
  • bypass: Criteri che consentono di aggirare il limite di velocità. Ad esempio, per indicare che non si deve applicare un limite di frequenza a una serie di URL.
    • name: Il valore valido è url.
    • value: L'URL da bypassare.

Dati JSON di esempio:

{
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}

-i, --instance

Il nome o l'ID dell'istanza. Se non viene specificato, viene utilizzata l'istanza di contesto indicata da ibmcloud cis instance-set INSTANCE.

--output

Specificare il formato di output; è supportato solo il formato " JSON ".

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

RATELIMIT_RULE_ID

L'ID della regola di limitazione della frequenza. Obbligatorio.

-i, --instance

Il nome o l'ID dell'istanza. Se non viene specificato, viene utilizzata l'istanza di contesto indicata da ibmcloud cis instance-set INSTANCE.

Per ulteriori informazioni, consultare la sezione " Limitazione della velocità tramite CLI ".