Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Crea un'applicazione di accesso per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-app-create DNS_DOMAIN_ID --name exampleCreate --domain example.com --session-duration 12h

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutte le applicazioni di accesso per i domini 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-apps DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra i dettagli dell'applicazione di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

--name

Il nome dell'applicazione. Obbligatorio.

--domain

Il dominio e il percorso bloccati da Access. Obbligatorio.

--session-duration

Definisce il periodo di validità dei token emessi per questa applicazione. I valori validi sono 30m, 6h, 12h, 24h, 168h e 730h.

-i, --instance

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

--output

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

Esempi

Aggiorna l'applicazione di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-update DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name exampleUpdate --domain example.com --session-duration 24h

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

-i, --instance

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

Esempi

Elimina l'applicazione di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--name

Il nome del certificato. Obbligatorio.

--ca-cert-file

Il file Root CA dei certificati. Obbligatorio.

--associated-hostnames

I nomi host per i quali viene richiesto questo certificato.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso.

-i, --instance

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

Esempi

Crea un certificato di accesso per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificate-create DNS_DOMAIN_ID --name example --ca-cert-file CERT_FILE --associated-hostnames example.com

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutti i certificati di accesso per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_CERTIFICATE_ID

L'ID del certificato di accesso. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra i dettagli del certificato di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_CERTIFICATE_ID

L'ID del certificato di accesso. Obbligatorio.

--name

Il nome del certificato. Obbligatorio.

--associated-hostnames

I nomi host per i quali viene richiesto questo certificato. Obbligatorio.

I nomi host associati vengono reimpostati se non specificati da associated-hostnames.

-i, --instance

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

--output

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

Esempi

Aggiornare il certificato di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-update DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID --name example --associated-hostnames example.com

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_CERTIFICATE_ID

L'ID del certificato di accesso. Obbligatorio.

-i, --instance

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

Esempi

Elimina il certificato di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Ottieni le impostazioni dei certificati di accesso per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-f, --feature

Funzione delle impostazioni del certificato. Valori validi:

client_certificate_forwarding

Il payload del certificato client e la relativa firma SHA256 vengono inoltrati ai server di origine tramite le intestazioni CF-Client-Cert-DER_BASE64 e CF-Client-Cert-SHA256.

-v, --value

Il valore impostato per la funzione per i certificati.

client_certificate_forwarding

Specificare se inoltrare o meno il nome host del certificato client. Ad esempio, -v host1=on,host2=on,host3=off.

-i, --instance

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

--output

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

Esempi

Aggiorna le impostazioni dei certificati di accesso per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings-update DNS_DOMAIN_ID -f client_certificate_forwarding -v mtls1.example.com=on,mtls2.example.com=off

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

--name

Il nome della politica. Obbligatorio.

--decision

Definisce l'azione che Access intraprende se la politica corrisponde all'utente. Il valore valido è non_identity. Obbligatorio.

--include

La regola inclusa della politica. I valori validi sono certificate e common_name. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Crea una politica di accesso per l'applicazione a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy-create DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name examplePolicy --decision non_identity --include certificate --include common_name=test

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutte le politiche di accesso per l'applicazione di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

ACCESS_POLICY_ID

L'ID della politica di accesso. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra i dettagli della politica di accesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

ACCESS_APPLICATION_ID

L'ID dell'applicazione di accesso. Obbligatorio.

ACCESS_POLICY_ID

L'ID della politica di accesso. Obbligatorio.

-i, --instance

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

Esempi

Elimina la politica di accesso 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--all

Eliminazione di tutti file memorizzati nella cache. Questa opzione è reciprocamente esclusiva con --file.

--file

Rimuovere in modo granulare uno o più file specificando gli URL. Questa opzione è reciprocamente esclusiva con --all.

--tag

Rimuovere in modo granulare uno o più file mediante il Cache-Tag. Questa opzione è reciprocamente esclusiva con --all. Solo piani aziendali

--host

Rimuovere in modo granulare uno o più file specificando l'host. Questa opzione è reciprocamente esclusiva con --all. Solo piani aziendali

--prefix

Rimuovere in modo granulare uno o più file mediante un prefisso. Questa opzione è reciprocamente esclusiva con --all. Solo piani aziendali

-f, --force

Eliminazione di tutti i file memorizzati nella cache senza richiesta di conferma.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da ibmcloud cis instance-set.

--output

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

Esempi

Cancella tutto il file delle risorse memorizzato nella cache per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-purge DNS_DOMAIN_ID --all --force

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da ibmcloud cis instance-set.

--output

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

Esempi

Ottieni le impostazioni di memorizzazione nella cache per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--caching-level

Specificare in quali condizioni URL si desidera fornire all'utente le risorse memorizzate nella cache. I valori validi sono no-query-string, query-string-independent e query-string-dependent.

• no-query-string: Fornisce risorse dalla cache solo quando non è presente una stringa di query.
• query-string-independent: Fornisce la stessa risorsa a tutti, indipendentemente dalla stringa di query.
• query-string-dependent: Fornisce una risorsa diversa ogni volta che la stringa di query cambia.

--browser-expiration

Specifica per quanto tempo desideri che il browser conservi le risorse nella cache.

• I valori validi sono respect-existing-header, 30s, 1M, 5M, 20M, 30M, 1h, 2h, 4h, 8h, 16h, 1d 3d, 8d, 16d, 1m, 6m e 1y.
• 30s, 1M, 5M e 20M sono disponibili solo per le istanze con piano Enterprise o Security.
• 30s significa 30 seconds.
• 30M significa 30 minutes.
• 1h significa 1 hour.
• 1d significa 1 day.
• 1m significa 1 month.
• 1y significa 1 year.

--development-mod

Ignora tutte le cache edge ed invia il traffico verso i server di origine.

--serve-stale-content

Continua a fornire agli utenti i contenuti memorizzati nella cache quando i server di origine sono offline, anche se i contenuti sono scaduti.

--query-string-sort: Nella cache, CIS considera i file con le stesse stringhe di query come lo stesso file, indipendentemente dall'ordine delle stringhe di query.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da ibmcloud cis instance-set.

--output

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

Esempi

Aggiorna le impostazioni di memorizzazione nella cache per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings-update DNS_DOMAIN_ID --caching-level no-query-string --browser-expiration 1h

Opzioni comando

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

Esempio

ibmcloud cis custom-lists lists

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

Esempio

ibmcloud cis custom-lists list LIST_ID --output json

Opzioni comando

--kind

Tipo di elenco personalizzato. I valori validi sono ip, asn e hostname.

--name

Il nome dell'elenco.

--description

Descrizione dell'elenco.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un elenco personalizzato.

I campi obbligatori nei dati JSON sono:

kind tipo di elenco personalizzato. I valori validi sono ip, asn e hostname.

name il nome dell'elenco.

Il campo opzionale è:

"description": Descrizione dell'elenco.

Dati JSON di esempio:

{
  "kind": "ip",
  "name": "string",
  "description": "string"
}

Esempi

ibmcloud cis custom-lists list-create --kind ip --name iplistone --instance INSTANCE

ibmcloud cis custom-lists list-create --json @example.json --instance INSTANCE

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

--description

Descrivete brevemente l'elenco.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

json

Il file JSON o la stringa JSON utilizzati per descrivere un elenco personalizzato.

Il campo opzionale è:

"description": Per descrivere brevemente l'elenco.

Dati JSON di esempio:

  {
    "description": "string"
  }

Esempi

ibmcloud cis custom-lists list-update LIST_ID --description "description example"

ibmcloud cis custom-lists list-update LIST_ID --json @example.json

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

-f, --force

Tentativo di eliminare un elenco personalizzato senza richiedere conferma.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

Esempio

ibmcloud cis custom-lists list-delete LIST_ID

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

Esempio

ibmcloud cis custom-lists items LIST_ID

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

ITEM_ID

L'ID dell'elemento dell'elenco personalizzato.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

Esempio

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

--asn

Il valore ASN.

--ip

L'indirizzo IPv4.

--hostname

Il nome host.

--comment

Per fornire un breve commento sull'argomento.

-i, --instance

Il nome o l'ID dell'istanza. Se l'istanza o l'ID non sono impostati, viene usata l'istanza del contesto specificata da cis instance-set INSTANCE.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un elenco personalizzato.

I campi obbligatori nei dati JSON sono:

items: Elenco di voci di elenco personalizzate da creare.

asn: L'ASN.

hostname il nome dell'host.

ip: L'indirizzo dell' IPv4.

comment: fornire un breve commento sull'argomento.

Dati JSON di esempio:

  [
    {
      "asn": 19604,
      "comment": "My list of developer IPs.",
      "hostname": "cloud.ibm.com",
      "ip": "172.64.0.0/13"
    }
  ]

Esempi di comando

ibmcloud cis custom-lists item-create LIST_ID --ip 192.0.0.3

ibmcloud cis custom-lists item-create LIST_ID --json @example.json

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un elenco personalizzato.

I campi obbligatori nei dati JSON sono:

items: Elenco di voci di elenco personalizzate da creare.

asn il valore ASN.

hostname il nome dell'host.

ip: L'indirizzo dell' IPv4.

comment: fornire un breve commento sull'argomento.

Dati JSON di esempio:

   [
     {
       "asn": 19604,
       "comment": "My list of developer IPs.",
       "hostname": "cloud.ibm.com",
       "ip": "172.64.0.0/13"
     }
   ]

-f, --force

Tentativo di eliminare un elenco personalizzato senza richiedere conferma.

--output value

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

-i, --instance

Il nome o l'ID dell'istanza. Se il valore o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

Esempio

ibmcloud cis custom-lists item-update LIST_ID --json @example.json -f

Opzioni comando

LIST_ID

L'ID dell'elenco personalizzato.

--item-id

CUSTOM_LIST_ITEM_ID è l'ID dell'elemento dell'elenco personalizzato.

-f, --force

Tentativo di eliminare un elenco personalizzato senza richiedere conferma.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un elenco personalizzato.

I campi obbligatori nei dati JSON sono:

items elenco di elementi dell'elenco personalizzato da eliminare in base all'ID.

id iD univoco dell'elemento dell'elenco personalizzato.

Dati JSON di esempio:

  {
    "items": [
      {
        "id": "70c2009751b24ffc9ed1ab462ba957b4"
      }
    ]
  }

Esempi

ibmcloud cis custom-lists item-delete LIST_ID --item-id CUSTOM_LIST_ITEM_ID --force

ibmcloud cis custom-lists item-delete LIST_ID --json @example.json --force

Opzioni comando

OPERATION_ID

L'ID dell'operazione dell'elenco personalizzato.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

Esempio

ibmcloud cis custom-lists operation OPERATION_ID --output json

Opzioni comando

PAGE_ID

Il nome del tipo Pagina personalizzata. I valori validi sono basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Obbligatorio.

PAGE_URL

Un URL associato con la pagina personalizzata. Ad esempio, http://www.example.com/example.html. Il valore default significa che viene utilizzata la pagina predefinita. Obbligatorio.

-d, --domain

ID dominio DNS.

-i,- --instance

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

--output

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

Esempi

Aggiorna la pagina basic_challenge per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page-update basic_challenge http://www.example.com/example.html -d DNS_DOMAIN_ID

Opzioni comando

PAGE_ID

Il nome del tipo Pagina personalizzata. I valori validi sono basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors e 500_errors. Obbligatorio.

-d, --domain

ID dominio DNS.

-i, --instance

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

--output

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

Esempi

Ottieni la pagina basic_challenge per il dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Opzioni comando

-d, --domain

ID dominio DNS.

-i, --instance

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

--output

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

Esempi

Elenco delle pagine personalizzate esistenti per il dominio DNS_DOMAIN_ID.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--name

Nome del record DNS.

--type

Tipo di record DNS

--content

Contenuto record DNS

--ttl

TTL (Time to Live) per il record DNS. Un valore pari a 1 indica che si tratta di un automatic. Il valore predefinito è 1.

--proxied

Controlla se il traffico passa attraverso le funzioni di sicurezza e prestazioni su CIS. CIS Il proxy gestisce il traffico solo per i record A, AAAA e CNAME. I valori validi sono true e false.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un record DNS. I tipi di record DNS supportati sono: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Per i modelli A, AAAA, CNAME, NS, TXT:
  • I campi obbligatori nei dati JSON sono name, type, content.
  • I campi facoltativi sono ttl e proxied:
    • proxied Controlla se il traffico passa attraverso le funzioni di sicurezza e prestazioni su CIS. CIS I proxy gestiscono esclusivamente il traffico relativo ai record A, AAAA e CNAME.

Dati JSON di esempio:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}

• Per il tipo " PTR ":
  • I campi obbligatori nei dati JSON sono name, type, content.
  • Il campo facoltativo è ttl.

Dati JSON di esempio:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• Per il tipo " MX ":
  • I campi obbligatori nei dati JSON sono name, type, content.
  • I campi facoltativi sono ttl e priority.

Dati JSON di esempio:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}

• Per il tipo " LOC ":
  • I campi obbligatori nei dati JSON sono name, type, data:
    • data:
      • lat_degrees: Gradi di latitudine.
      • lat_minutes: Minuti di latitudine
      • lat_seconds: Secondi di latitudine.
      • lat_direction: Direzione della latitudine.
      • long_degrees: Gradi di longitudine.
      • long_minutes: Minuti di longitudine.
      • long_seconds: Secondi di longitudine.
      • long_direction: Direzione della longitudine.
      • altitude: Altitudine del luogo in metri.
      • size: Dimensioni dell'area in metri.
      • precision_horz: Precisione orizzontale della posizione.
      • precision_vert: Precisione verticale della posizione.
    • Il campo facoltativo è ttl.

Dati JSON di esempio:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}

• Per il tipo " SRV ":
  • I campi obbligatori nei dati JSON sono type, data:
    • data: - service: un tipo di servizio, preceduto da un trattino basso. - proto: Un protocollo valido. - priority: Priorità. - weight: il peso record. - port: la porta del servizio. - target: un nome host valido.
    • Il campo facoltativo è ttl.

Dati JSON di esempio:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}

• Per il tipo CAA:
  • I campi obbligatori nei dati JSON sono name, type e data.
  • Il campo facoltativo è ttl.

Dati JSON di esempio:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un record DNS.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da ibmcloud cis instance-set.

--output

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

Esempi

Crea un record DNS nel dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record-create DNS_DOMAIN_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-create DNS_DOMAIN_ID --type A --name testA --content "127.0.0.1"

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

DNS_RECORD_ID

L'ID del record DNS. Obbligatorio.

--name

Nome del record DNS.

--type

Tipo di record DNS

--content

Contenuto record DNS

--ttl

TTL (Time to Live) per il record DNS. Un valore pari a 1 indica che si tratta di un automatic. Il valore predefinito è 1.

--proxied

Controlla se il traffico passa attraverso le funzioni di sicurezza e prestazioni su CIS. CIS Il proxy gestisce il traffico solo per i record A, AAAA e CNAME. I valori validi sono true e false.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un record DNS. I tipi di record DNS supportati sono: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA,PTR.

• Per i modelli A, AAAA, CNAME, NS, TXT:
  • I campi obbligatori nei dati JSON sono name, type, content.
  • I campi facoltativi sono ttl e proxied:
    • proxied Controlla se il traffico passa attraverso le funzioni di sicurezza e prestazioni su CIS. CIS I proxy gestiscono esclusivamente il traffico relativo ai record A, AAAA e CNAME.

Dati JSON di esempio:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}

• Per il tipo " PTR ":
  • I campi obbligatori nei dati JSON sono name, type, content.
  • Il campo facoltativo è ttl.

Dati JSON di esempio:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• Per il tipo " MX ":

  • I campi obbligatori nei dati JSON sono name, type, content.
  • I campi facoltativi sono ttl e priority.

  Dati JSON di esempio:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}

• Per il tipo " LOC ":

  • I campi obbligatori nei dati JSON sono name, type, data:
    • data:
      • lat_degrees: Gradi di latitudine.
      • lat_minutes: Minuti di latitudine
      • lat_seconds: Secondi di latitudine.
      • lat_direction: Direzione della latitudine.
      • long_degrees: Gradi di longitudine.
      • long_minutes: Minuti di longitudine.
      • long_seconds: Secondi di longitudine.
      • long_direction: Direzione della longitudine.
      • altitude: Altitudine del luogo in metri.
      • size: Dimensioni dell'area in metri.
      • precision_horz: Precisione orizzontale della posizione.
      • precision_vert: Precisione verticale della posizione.
  • Il campo facoltativo è ttl.

  Dati JSON di esempio:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}

• Per il tipo " SRV ":

  • I campi obbligatori nei dati JSON sono type, data:
    • data:
      • service: Un tipo di servizio, preceduto da un trattino basso.
      • proto: Un protocollo valido.
      • priority: Priorità.
      • weight: Il peso record.
      • port: La porta del servizio.
      • target: Un nome host valido.
  • Il campo facoltativo è ttl.

  Dati JSON di esempio:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}

• Per il tipo " CAA ":

  • I campi obbligatori nei dati JSON sono name, type, data
  • Il campo facoltativo è ttl.

  Dati JSON di esempio:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un record DNS.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da ibmcloud cis instance-set.

--output

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

Esempi

Aggiornare un record DNS nel dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --type A --name testA --content "127.0.0.1"

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

DNS_RECORD_ID

L'ID del record DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Ottenere i dettagli del record DNS nel dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

DNS_RECORD_ID

L'ID del record DNS. Obbligatorio.

-i, --instance

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

Esempi

Eliminare un record DNS dal dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--type

Tipo di record DNS da visualizzare.

--name

Valore del campo nome in base al quale applicare il filtro.

--content

Valore del campo contenuto in base al quale applicare il filtro.

--page

Numero pagina o risultati in pagina.

--per_page

Numero massimo di record DNS per pagina.

--order

Campo in base al quale ordinare l'elenco dei record DNS. I valori validi sono type, name, content, ttl e proxied.

--direction

Ordine in cui ordinare i risultati (ordine crescente o decrescente). I valori validi sono asc e desc.

--match

Se deve corrispondere a tutti i parametri di ricerca o almeno a uno. I valori validi sono any e all.

-i, --instance

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

--output

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

Esempi

Elenca tutti i record DNS del dominio DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--file

Configurazione di BIND da importare. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Importare la configurazione di BIND nel dominio DNS_DOMAIN_ID.

ibmcloud cis dns-records-import DNS_DOMAIN_ID --file bind_config_file.txt

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--file

Il file di configurazione BIND in cui vengono salvati i record DNS esportati.

-i, --instance

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

Esempi

Esporta la configurazione BIND per il dominio DNS_DOMAIN_ID.

ibmcloud cis dns-records-export DNS_DOMAIN_ID --file bind_config_file.txt

Opzioni comando

type

Specificare la configurazione del tipo di dominio. I valori validi sono full e partial (default full).

• full: Una zona completa indica che il DNS è ospitato.
• partial: Una zona parziale implica un dominio configurato con un record CNAME.

jump-start

Prova a richiamare i record DNS esistenti automaticamente.

DNS_DOMAIN_NAME

Il nome di dominio completo (FQDN) del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Aggiungi un dominio DNS_DOMAIN_NAME.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Ripristina il dominio specificato.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Sospendi il dominio specificato.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Visualizza i dettagli del dominio specificato.

ibmcloud cis domain DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

Esempi

Rimuovi il dominio specificato.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Opzioni comando

-i, --instance

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

--output

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

Esempi

Elenco dei domini per l'istanza del servizio.

ibmcloud cis domains

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

Esempi

Esegui il controllo di attivazione sul dominio specificato.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-g, --group

Visualizza le funzioni in uno stesso gruppo. I valori validi per group sono all, ` `domain, reliability, ` `performance e security``. Questa opzione è reciprocamente esclusiva con -f, --feature.

-f, --feature

Funzione delle impostazioni del dominio da controllare. Questa opzione è reciprocamente esclusiva con g, --group. I valori validi sono i seguenti:

• always_use_https: Reindirizzare tutte le richieste con lo schema http a https. Questa impostazione si applica a tutte le richieste HTTP indirizzate al dominio.
• automatic_https_rewrites: Aiutaci a risolvere il problema dei contenuti misti sostituendo http con https per tutte le risorse o i link presenti sul tuo sito web che possono essere forniti con HTTPS.
• bot_management: Individua e riduci il traffico generato dai bot sul tuo dominio.
• brotli: Quando il client che richiede una risorsa supporta l'algoritmo di compressione Brotli, CIS fornisce una versione della risorsa compressa con Brotli.
• browser_check: Verifica la presenza di minacce nelle intestazioni " HTTP " provenienti dal browser dei tuoi visitatori. Se viene rilevata una minaccia, viene inviata una pagina di blocco.
• challenge_ttl: Specificare per quanto tempo un visitatore con una reputazione IP negativa possa accedere al tuo sito web dopo aver completato una verifica.
• ciphers: Un elenco di algoritmi di cifratura consentiti per la chiusura dell' TLS, nel formato BoringSSL. Questo comando elenca i codici che sono autorizzati dai clienti. Se non vi sono algoritmi di cifratura nella lista dei consentiti, l'elenco risulta vuoto e vengono utilizzati gli algoritmi predefiniti. Vedere Suite di cifratura Edge e Suite di cifratura Origin per l'elenco delle cifrature predefinite.
• cname_flattening: Seguire un record CNAME fino alla destinazione a cui punta e restituire quell'indirizzo IP al posto del record CNAME. Per impostazione predefinita, viene appiattito solo il record CNAME alla radice del dominio.
• domain_hold: Il blocco dei domini impedisce ai team della tua organizzazione di aggiungere domini già attivi in un altro account. Solo piani aziendali
• email_obfuscation crittografa gli indirizzi e-mail della vostra pagina web per evitare che i bot possano visualizzarli, mentre gli esseri umani possono vederli.
• opportunistic_onion: Consenti agli utenti legittimi del browser Tor di accedere ai tuoi siti web.
• hotlink_protection: Proteggi le tue immagini dai link esterni.
• http2: Velocizza il tuo sito web con HTTP/2.
• http3: Velocizza il tuo sito web con HTTP/3.
• image_load_optimization: Deprecato. Migliora il tempo di caricamento per le pagine che includono immagini sui dispositivi mobili con connessioni di rete lente.
• image_size_optimization: Migliora i tempi di caricamento delle immagini ottimizzando quelle ospitate sul tuo dominio.
• image_resizing fornisce il ridimensionamento, la conversione e l'ottimizzazione su richiesta delle immagini servite attraverso la rete CIS.
• ip_geolocation: Includi il codice paese della località da cui proviene il visitatore in tutte le richieste inviate al tuo sito web.
• ipv6: Abilitare il supporto per l' IPv6 e e il gateway.
• max_upload: Il numero di visitatori che possono caricare dati sul tuo sito web in una singola richiesta.
• min_tls_version: Consenti solo connessioni HTTPS da parte dei visitatori che supportano la versione del protocollo TLS selezionata o una versione più recente.
• minify: Riduci le dimensioni dei file di codice sorgente presenti sul tuo sito web.
• mobile_redirect: Reindirizzare i visitatori che utilizzano dispositivi mobili verso un sito web ottimizzato per dispositivi mobili.
• opportunistic_encryption: La crittografia opportunistica consente ai browser di beneficiare delle migliori prestazioni di HTTP/2, segnalando loro che il tuo sito è disponibile tramite una connessione crittografata.
• origin_error_page_pass_thru: Quando la pagina di errore dell'origine è impostata su On, CIS reindirizza le pagine di errore 502 e 504 direttamente dall'origine. Solo piani aziendali
• origin_max_http_version: Impostare la versione di " HTTP " su "Origin".
• origin_post_quantum_encryption: Indica a CIS di utilizzare algoritmi di accordo delle chiavi post-quantistici (PQ) quando si connette al tuo server di origine.
• prefetch_preload: CIS precarica tutti gli URL inclusi nell'intestazione prefetch HTTP. Solo piani aziendali
• pseudo_ipv4: Aggiunge un'intestazione " IPv4 " alle richieste quando un client utilizza " IPv6 ", ma il server supporta solo " IPv4 ".
• response_buffering: Abilita o disabilita il buffering delle risposte provenienti dal server di origine. Solo piani aziendali
• script_load_optimization: Migliorare il tempo di rendering delle pagine che includono JavaScript.
• security_header: Applica una politica di sicurezza web per il tuo sito web.
• security_level: Scegli il profilo di sicurezza più adatto al tuo sito web.
• server_side_exclude: Nascondi automaticamente determinati contenuti ai visitatori sospetti.
• tls_client_auth: certificato client TLS presentato per l'autenticazione durante il pull dall'origine. Solo piani aziendali
• true_client_ip_header: CIS invia l'indirizzo IP dell'utente nell'intestazione True-Client-IP. Solo piani aziendali
• waf: Un Web Application Firewall (WAF) blocca le richieste che contengono contenuti dannosi.
• websockets: Consenti le connessioni WebSockets al tuo server di origine.
• proxy_read_timeout: Tempo massimo tra due operazioni di lettura dall'origine. Solo piani aziendali
• url_normalization: Modifica gli URL delle richieste in entrata.

-i, --instance

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

--output

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

Esempi

Ottieni le impostazioni di " ciphers " per il dominio DNS_DOMAIN_ID.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-f, --feature

Funzionalità delle impostazioni del dominio da aggiornare. Obbligatorio. Valori validi:

• always_use_https: Reindirizzare tutte le richieste con lo schema http a https. Questo reindirizzamento si applica a tutte le richieste HTTP rivolte al dominio.
• automatic_https_rewrites: Aiutaci a risolvere il problema dei contenuti misti sostituendo http con https per tutte le risorse o i link presenti sul tuo sito web che possono essere forniti con HTTPS.
• bot_management: Individua e riduci il traffico generato dai bot sul tuo dominio.
• brotli: Quando il client che richiede una risorsa supporta l'algoritmo di compressione Brotli, CIS fornisce una versione della risorsa compressa con Brotli.
• browser_check: Verifica la presenza di minacce nelle intestazioni " HTTP " provenienti dal browser dei tuoi visitatori. Se viene rilevata una minaccia, viene inviata una pagina di blocco.
• challenge_ttl: Specificare per quanto tempo un visitatore con una reputazione IP negativa possa accedere al tuo sito web dopo aver completato una verifica.
• ciphers: un elenco di cifrari per la terminazione di TLS. Queste cifrature devono essere nel formato BoringSSL.
• cname_flattening: Seguire un record CNAME fino alla destinazione a cui punta e restituire quell'indirizzo IP al posto del record CNAME. Per impostazione predefinita, viene eseguito il flattening unicamente del CNAME nella root del tuo dominio.
• domain_hold: Il blocco dei domini impedisce ai team della tua organizzazione di aggiungere domini già attivi in un altro account. Solo piani aziendali
• email_obfuscation crittografa gli indirizzi e-mail della vostra pagina web per evitare che i bot possano visualizzarli, mentre gli esseri umani possono vederli.
• opportunistic_onion: Consenti agli utenti legittimi del browser Tor di accedere ai tuoi siti web.
• hotlink_protection: Proteggi le tue immagini dai link esterni.
• http2: Velocizza il tuo sito web con HTTP/2.
• http3: Velocizza il tuo sito web con HTTP/3.
• image_load_optimization: Deprecato. Migliora il tempo di caricamento per le pagine che includono immagini sui dispositivi mobili con connessioni di rete lente.
• image_size_optimization: Migliora i tempi di caricamento delle immagini ottimizzando quelle ospitate sul tuo dominio.
• image_resizing fornisce il ridimensionamento, la conversione e l'ottimizzazione su richiesta delle immagini servite attraverso la rete CIS.
• ip_geolocation: Includi il codice paese della località da cui proviene il visitatore in tutte le richieste inviate al tuo sito web.
• ipv6: Abilitare il supporto per l' IPv6 e e il gateway.
• max_upload: Il numero di visitatori che possono caricare dati sul tuo sito web in una singola richiesta.
• min_tls_version: Consenti solo connessioni HTTPS da parte dei visitatori che supportano la versione del protocollo TLS selezionata o una versione più recente.
• minify: Riduci le dimensioni dei file di codice sorgente presenti sul tuo sito web.
• mobile_redirect: Reindirizzare i visitatori che utilizzano dispositivi mobili verso un sito web ottimizzato per dispositivi mobili.
• opportunistic_encryption: La crittografia opportunistica consente ai browser di beneficiare delle migliori prestazioni di HTTP/2, segnalando loro che il tuo sito è disponibile tramite una connessione crittografata.
• origin_error_page_pass_thru: Quando l'impostazione "Pagina di errore dell'origine" è impostata su On, CIS reindirizza le pagine di errore 502 e 504 direttamente dall'origine. Solo piani aziendali
• origin_max_http_version: Impostare la versione di " HTTP " su "Origin".
• origin_post_quantum_encryption: Indica a CIS di utilizzare algoritmi di accordo delle chiavi post-quantistici (PQ) quando si connette al tuo server di origine.
• prefetch_preload: CIS precarica tutti gli URL inclusi nell'intestazione prefetch HTTP. Solo piani aziendali
• pseudo_ipv4: Aggiunge un'intestazione " IPv4 " alle richieste quando un client utilizza " IPv6 ", ma il server supporta solo " IPv4 ".
• response_buffering: Abilita o disabilita il buffering delle risposte provenienti dal server di origine. Solo piani aziendali
• script_load_optimization: Migliorare il tempo di rendering delle pagine che includono JavaScript.
• security_header: Applica una politica di sicurezza web per il tuo sito web.
• security_level: Scegli il profilo di sicurezza più adatto al tuo sito web.
• server_side_exclude: Nascondi automaticamente determinati contenuti ai visitatori sospetti.
• tls_client_auth: certificato client TLS presentato per l'autenticazione durante il pull dall'origine. Solo piani aziendali
• true_client_ip_header: CIS invia l'indirizzo IP dell'utente nell'intestazione True-Client-IP. Solo piani aziendali
• waf: Un Web Application Firewall (WAF) blocca le richieste che contengono contenuti dannosi.
• websockets: Consenti le connessioni WebSockets al tuo server di origine.
• proxy_read_timeout: Tempo massimo tra due operazioni di lettura dall'origine.
• url_normalization: Modifica gli URL delle richieste in entrata.

-v, --value

Il valore impostato per la funzione del dominio. Obbligatorio.

• I valori validi per always_use_https sono on e off``.

• I valori validi per automatic_https_rewrites sono on e off``.

• I valori validi per bot_management sono "use_latest_model", "fight_mode", "session_score", "enable_js". Ad esempio, -v fight_mode=true,session_score=true

  • use_latest_model se abilitare l'ultima versione del modello. I valori validi per use_latest_model sono true e false``.
  • fight_mode se abilitare la modalità di lotta. I valori validi per fight_mode sono true e false``.
  • session_score se abilitare il punteggio della sessione. I valori validi per session_score sono true e false``.
  • enable_js se abilitare i rilevamenti di JavaScript. I valori validi per enable_js sono true e false``.

• I valori validi per browser_check sono on e off``.

• I valori validi per challenge_ttl sono 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• I valori validi per cname_flattening sono flatten_at_root, flatten_all.

  • flatten_at_root: Appiattire il record CNAME nel dominio principale. Questo valore è quello predefinito.
  • flatten_all: Appiattisci tutti i record CNAME presenti nel tuo dominio.

• I valori validi per domain_hold sono hold, include_subdomains e hold_after.

  • hold se abilitare il dominio hold. I valori validi per hold sono true e false``.
  • include_subdomains: Se abilitare il mantenimento del dominio. I valori validi per include_subdomains sono true e false``.
  • hold_after: Se viene specificato un intervall hold_after, la sospensione viene temporaneamente disattivata, per poi essere riattivata automaticamente dal sistema all'ora indicata.

  Per abilitare il dominio e i sottodomini, visitare: -v hold=true,include_subdomains=true. Per disattivare il blocco del dominio: -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• I valori validi per hotlink_protection sono on, off.

• I valori validi per email_obfuscation sono on, off.

• I valori validi per opportunistic_onion sono on, off.

• I valori validi per http2 sono on, off.

• I valori validi per http3 sono on, off.

• Obsoleto. I valori validi per image_load_optimization sono on, off.

• I valori validi per image_resizing sono on, off.

• I valori validi per image_size_optimization sono off, lossless, lossy.

  • off: disabilita l'ottimizzazione della dimensione dell'immagine.
  • lossless: Ridurre le dimensioni dei file immagine senza comprometterne la qualità visiva.
  • lossy: La dimensione dei file delle immagini JPEG viene ridotta tramite una compressione con perdita di dati, il che potrebbe compromettere la qualità visiva.

• I valori validi per ip_geolocation sono on, off.

• I valori validi per ipv6 sono on, off.

• I valori validi (in MB) per max_upload sono: 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Solo piani aziendali

• I valori validi per min_tls_version sono 1.0, 1.1, 1.2, 1,3.

• I valori validi per minify sono css, html, js. Ad esempio, -v css=on,html=off,js=on

  • css: Ottimizza automaticamente tutti i file CSS del tuo sito web. I valori validi per css sono on, off.
  • html: Ottimizza automaticamente tutto il codice HTML del tuo sito web. I valori validi per html sono on, off.
  • js: Ottimizza automaticamente tutti i file JS del tuo sito web. I valori validi per js sono on, off.

• I valori validi per mobile_redirect sono status, mobile_subdomain, strip_uri. Ad esempio, -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Se il reindirizzamento da dispositivo mobile è abilitato. I valori validi per status sono on e off``.
  • mobile_subdomain: Il prefisso del sottodominio verso cui desideri reindirizzare i visitatori che utilizzano dispositivi mobili (il sottodominio deve esistere).
  • strip_uri: Se abbandonare il percorso della pagina corrente e reindirizzare alla radice del sottodominio mobile URL. I valori validi per strip_uri sono true, false.

• I valori validi per opportunistic_encryption sono on, off.

• I valori validi per origin_error_page_pass_thru sono 1, 2.

• I valori validi per origin_max_http_version sono supported, preferred, off.

  • supported: Gli algoritmi post-quantistici vengono pubblicizzati, ma vengono utilizzati solo su richiesta del mittente.
  • preferred: L'opzione "Preferred" indica a CIS di inviare, se possibile, una condivisione delle chiavi post-quantistiche (PQ) nel primo messaggio all'origine (per le connessioni più veloci, quando l'origine supporta e preferisce il protocollo PQ).
  • off: Gli algoritmi post-quantistici non vengono pubblicizzati.

• I valori validi per origin_post_quantum_encryption sono on, off.

• I valori validi per brotli sono on, off.

• I valori validi per prefetch_preload sono on, off.

• I valori validi per pseudo_ipv4 sono off, add_header, overwrite_header.

  • off: disabilita Pseudo IPv4.
  • add_header: Aggiungere solo un'altra intestazione " Cf-Pseudo-IPv4 ".
  • overwrite_header: sovrascrive le intestazioni Cf-Connecting-IP e X-Forwarded-For esistenti con uno pseudo indirizzo IPv4.

• I valori validi per response_buffering sono on, off.

• I valori validi per script_load_optimization sono on, off.

• I valori validi per security_header sono enabled, max_age, include_subdomains, preload, nosniff. Ad esempio, -v enabled=true,max_age=100,include_subdomains=true,preload=true,nosniff=true

  • enabled se l'intestazione_di_sicurezza è abilitata. I valori validi per enabled sono true, false.
  • max_age: Specificare la durata (in secondi) per cui le intestazioni di sicurezza vengono memorizzate nella cache dei browser.
  • include_subdomains: Ogni dominio sottostante eredita lo stesso security_header. I valori validi per include_subdomains sono true, false.
  • preload: Se consentire ai browser di precaricare la configurazione di security_header. I valori validi per enabled sono true, false.
  • nosniff: Se inviare l'intestazion X-Content-Type-Options: nosniff. I valori validi per nosniff sono true, false.

• I valori validi per server_level sono: off, essentially_off, low, medium, high, under_attack.

• I valori validi per server_side_exclude sono on, off.

• I valori validi per tls_client_auth sono on, off.

• I valori validi per true_client_ip_header sono on, off.

• I valori validi per waf sono on, off.

• I valori validi per websockets sono on, off.

• Valori validi per proxy_read_timeout, 1-6000, predefinito: 100.

• I valori validi per ciphers sono ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-CHACHA20-POLY1305, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-CHACHA20-POLY1305, ECDHE-ECDSA-AES128-SHA256, ECDHE-ECDSA-AES128-SHA, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES128-SHA, AES128-GCM-SHA256, AES128-SHA256, AES128-SHA, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES256-SHA384, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES256-SHA, AES256-GCM-SHA384, AES256-SHA256, AES256-SHA, DES-CBC3-SHA, default. Ad esempio, -v AES256-SHA256,AES256-SHA, utilizzando -v default per ripristinare le suite di cifratura configurate al valore predefinito.

• I valori validi per " url_normalization " sono "type", "scope". Ad esempio, -v type=cis,scope=both

  • type: Seleziona il tipo di normalizzazione " URL " eseguita da CIS. I valori validi per type sono cis, rfc3986.
  • scope: Configura l'ambito della normalizzazione " URL ". I valori validi per scope sono both, incoming.

-i, --instance

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

--output

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

Esempi

Abilita l' tls_client_auth per il dominio DNS_DOMAIN_ID.

ibmcloud cis domain-settings-update DNS_DOMAIN_ID -f tls_client_auth -v on

Opzioni comando

-i, --instance

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

--output

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

Esempi

Elenca tutte le azioni delle funzioni Edge.

ibmcloud cis edge-functions-actions

Opzioni comando

--name

Nome azione. Solo piani aziendali

-i, --instance

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

Esempi

Mostra i dettagli dell'azione "Edge Functions" ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Opzioni comando

--name

Nome azione. Solo piani aziendali

--javascript-str

Stringa Javascript. Ad esempio, addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

File Javascript.

-i, --instance

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

--output

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

Esempi

Crea un'azione Edge Functions.

ibmcloud cis edge-functions-action-create --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

Opzioni comando

--name

Nome azione. Solo piani aziendali

--javascript-str

Stringa Javascript. Ad esempio, addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

File Javascript.

-i, --instance

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

--output

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

Esempi

Aggiornare un'azione di Edge Functions.

ibmcloud cis edge-functions-action-update --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

Opzioni comando

--name

Nome azione. Solo piani aziendali

-i, --instance

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

Esempi

Azione "Elimina funzioni Edge" ACTION_NAME.

ibmcloud cis edge-functions-action-delete --name ACTION_NAME

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutti i trigger delle funzioni Edge per il dominio DNS_DOMAIN_ID.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

TRIGGER_ID

L'ID del trigger. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra i dettagli del trigger delle funzioni Edge TRIGGER_ID.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

PATTERN_URL

La richiesta URL, che avvia l'azione. Obbligatorio.

name

Il nome dell'azione a cui è collegato il trigger creato. Solo piani aziendali

disable

Disabilita un trigger di funzioni Edge.

-i, --instance

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

--output

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

Esempi

Crea un trigger Edge Functions per il dominio DNS_DOMAIN_ID.

ibmcloud cis edge-functions-trigger-create DNS_DOMAIN_ID PATTERN_URL --name ACTION_NAME

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

TRIGGER_ID

L'ID del trigger. Obbligatorio.

PATTERN_URL

La richiesta URL, che avvia l'azione. Obbligatorio.

name

Il nome dell'azione a cui è associato il trigger creato. Solo piani aziendali

disable

Disabilita un trigger di funzioni Edge.

-i, --instance

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

--output

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

Esempi

Aggiornamento: le funzioni Edge si attivano all'indirizzo TRIGGER_ID.

ibmcloud cis edge-functions-trigger-update DNS_DOMAIN_ID TRIGGER_ID PATTERN_URL --name ACTION_NAME

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

TRIGGER_ID

L'ID del trigger. Obbligatorio.

-i, --instance

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

Esempi

Elimina le funzioni Edge che attivano TRIGGER_ID.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Opzioni comando

-t, --type

Tipo di regole del firewall da creare. Valori validi: access-rules, ua-rules, lockdowns. Obbligatorio.

• access-rules: le regole di accesso costituiscono un modo per consentire, verificare o bloccare le richieste al tuo sito web. Puoi applicare le regole di accesso a un solo dominio o a tutti i domini nella stessa istanza del servizio.
• ua-rules: esegue il controllo di accesso quando rileva una corrispondenza esatta di UserAgent riportato dal client. I meccanismi del controllo di accesso possono essere definiti all'interno di una regola per semplificare la gestione del traffico da particolari client. Questa opzione ti permette di personalizzare l'accesso al tuo sito.
• lockdowns: blocca l'accesso agli URL in questo dominio ai soli indirizzi o intervalli di indirizzi consentiti.

-d, --domain

ID dominio DNS. Per la regola di tipo ua-rules e lockdowns, è un parametro obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una regola del firewall. Obbligatorio.

• Per --type access-rules: i dati JSON che descrivono una regola di accesso del firewall sono i seguenti.
  • I campi obbligatori sono mode, configuration.
    • mode: Il tipo di azione da eseguire. I valori validi sono block, challenge, whitelist e js_challenge.
    • configuration: Coppia "Target/Valore" da utilizzare per questa regola.
      • target: La proprietà della richiesta a cui fare riferimento. I valori validi sono ip, ip_range, asn e country.
      • value: Il valore corrispondente all'obiettivo selezionato.
        • Per "ip", il valore è un indirizzo IP valido.
        • Per ip_range, il valore specifica un intervallo di indirizzi IP limitato a /16 e /24.
        • Per asn, il valore è un numero AS.
        • Per un paese, il valore corrisponde al codice paese.
  • I campi facoltativi sono notes.
    • notes: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

Dati JSON di esempio:

{
   "mode": "block",
   "notes": "This rule is added because of event X that occurred on date xyz",
   "configuration": {
      "target": "ip",
      "value": "127.0.0.1"
   }
}

• Per --type ua-rules: i dati JSON che descrivono una regola user-agent sono i seguenti.
  • I campi obbligatori sono mode, configuration.
    • mode: Il tipo di azione da eseguire. I valori validi sono block, challenge e js_challenge.
    • configuration: Coppia "Target/Valore" da utilizzare per questa regola.
      • target: La proprietà della richiesta a cui fare riferimento. Il valore valido è ua.
      • value: La stringa esatta UserAgent da confrontare con questa regola.
  • I campi facoltativi sono paused, description.
    • paused: Se questa regola è attualmente disattivata.
    • description: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

Dati JSON di esempio:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}

• Per --type lockdowns: I dati JSON che descrivono una regola di blocco sono i seguenti.
  • I campi obbligatori sono urls, configurations.
    • urls: URL da includere nella definizione di questa regola.
      • Sono consentiti i caratteri jolly.
      • Il modello URL immesso qui viene racchiuso tra caratteri di escape prima dell'utilizzo.
      • Questo campo limita l' URL e a semplici modelli con caratteri jolly.
    • configurations: Elenco degli indirizzi IP o degli intervalli CIDR da utilizzare per questa regola.
      • Questo campo può contenere un numero qualsiasi di configurazioni di indirizzi IP o intervalli di indirizzi IP in grado di accedere agli URL specificati.
      • target: La proprietà della richiesta a cui fare riferimento. I valori validi sono ip, e ip_range.
      • value: Indirizzi IP o CIDR. Se il campo "target" è impostato su " ip", il campo "value" deve contenere un indirizzo IP; in caso contrario, deve essere specificato in formato CIDR.
  • I campi facoltativi sono paused, description.
    • paused: Se questa regola è attualmente disattivata.
    • description: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

Dati JSON di esempio:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola del firewall.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Crea le regole del firewall.

ibmcloud cis firewall-create --type access-rules --json '{"mode": "block", "notes": "This rule is added because of event X that occurred on date xyz", "configuration": {"target": "ip", "value": "127.0.0.1"}}' --instance INSTANCE
ibmcloud cis firewall-create --type ua-rules --domain DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}' --instance INSTANCE
ibmcloud cis firewall-create --type lockdowns --domain DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}' --instance INSTANCE

Opzioni comando

• FIREWALL_RULE_ID: l'ID della regola del firewall. Obbligatorio.

-t, --type

Il tipo di regola del firewall da creare. I valori validi sono access-rules, ua-rules e lockdowns. Obbligatorio.

• access-rules: Le regole di accesso consentono di autorizzare, verificare o bloccare le richieste rivolte al proprio sito web. Puoi applicare le regole di accesso a un solo dominio o a tutti i domini nella stessa istanza del servizio.
• ua-rules: Eseguire il controllo degli accessi solo se l' UserAgent e corrisponde esattamente a quella segnalata dal client. I meccanismi del controllo di accesso possono essere definiti all'interno di una regola per semplificare la gestione del traffico da particolari client. Ciò ti consente di personalizzare l'accesso al tuo sito.
• lockdowns: Limita l'accesso agli URL di questo dominio solo agli indirizzi o agli intervalli di indirizzi autorizzati.

-d, --domain

ID dominio DNS. Per la regola di tipo ua-rules e lockdowns, è un parametro obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una regola del firewall. Obbligatorio.

• Per --type access-rules: I dati JSON che descrivono una regola di accesso del firewall sono i seguenti.
  • I campi facoltativi sono mode, notes.
    • mode: Il tipo di azione da eseguire. I valori validi sono block, challenge, whitelist e js_challenge.
    • notes: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

Dati JSON di esempio:

{
   "mode": "challenge",
   "notes": "This rule is added because of event X that occurred on date xyz",
}

• Per --type ua-rules: I dati JSON che descrivono una regola di user-agent sono i seguenti.

  • I campi obbligatori sono mode, configuration.
    • mode: Il tipo di azione da eseguire. I valori validi sono block, challenge e js_challenge.
    • configuration: Coppia "Target/Valore" da utilizzare per questa regola.
      • target: La proprietà della richiesta a cui fare riferimento. Il valore valido è ua.
      • value: La stringa esatta UserAgent da confrontare con questa regola.
  • I campi facoltativi sono paused, description.
    • paused: Se questa regola è attualmente disattivata.
    • description: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

  Dati JSON di esempio:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}

• Per --type lockdowns: I dati JSON che descrivono una regola di blocco sono i seguenti.
  • I campi obbligatori sono urls, configurations.
    • urls: URL da includere nella definizione di questa regola.
      • Sono consentiti i caratteri jolly.
      • Il modello URL immesso qui viene racchiuso tra caratteri di escape prima dell'utilizzo.
      • Questo campo limita l' URL e a semplici modelli con caratteri jolly.
    • configurations: Elenco degli indirizzi IP o degli intervalli CIDR da utilizzare per questa regola.
      • Questo campo può contenere un numero qualsiasi di configurazioni di indirizzi IP o intervalli di indirizzi IP in grado di accedere agli URL specificati.
      • target: La proprietà della richiesta a cui fare riferimento. I valori validi sono ip e ip_range.
      • value: Indirizzi IP o CIDR. Se il target è ip, il valore deve essere un indirizzo IP; in caso contrario, deve essere un indirizzo CIDR.
  • I campi facoltativi sono paused, description.
    • paused: Se questa regola è attualmente disattivata.
    • description: Alcune informazioni utili su questa regola per aiutarvi a comprenderne lo scopo.

Dati JSON di esempio:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola del firewall.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiorna le regole del firewall.

ibmcloud cis firewall-update FIREWALL_RULE_ID -t access-rules --json '{"mode": "challenge", "notes": "This rule is added because of event X that occurred on date xyz"}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}'

Opzioni comando

-t, --type

Il tipo di regola del firewall da creare. I valori validi sono access-rules, ua-rules e lockdowns. Obbligatorio.

• access-rules: Le regole di accesso consentono di autorizzare, verificare o bloccare le richieste rivolte al proprio sito web. Puoi applicare le regole di accesso a un solo dominio o a tutti i domini nella stessa istanza del servizio.
• ua-rules: Eseguire il controllo degli accessi solo se l' UserAgent e corrisponde esattamente a quella segnalata dal client. I meccanismi del controllo di accesso possono essere definiti all'interno di una regola per semplificare la gestione del traffico da particolari client. Questa azione ti permette di personalizzare l'accesso al tuo sito.
• lockdowns: Limita l'accesso agli URL di questo dominio solo agli indirizzi o agli intervalli di indirizzi autorizzati.

-d, --domain

ID dominio DNS. Per la regola di tipo ua-rules e lockdowns, è un parametro obbligatorio.

--page

Numero pagina o risultati in pagina. Il valore predefinito è 0.

--per-page

Numero massimo di regole di accesso per pagina. Il valore minimo è 5. Il valore predefinito è 20.

-i, --instance

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

--output

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

Esempi

Elenca le regole del firewall.

ibmcloud cis firewalls --type access-rules --instance INSTANCE
ibmcloud cis firewalls --type ua-rules --domain DNS_DOMAIN_ID --instance INSTANCE
ibmcloud cis firewalls --type lockdowns --domain DNS_DOMAIN_ID --instance INSTANCE

Opzioni comando

FIREWALL_RULE_ID

L'ID della regola del firewall. Obbligatorio.

-t, --type

Tipo di regola del firewall da creare. I valori validi sono access-rules, ua-rules e lockdowns.

• access-rules: Le regole di accesso consentono di autorizzare, verificare o bloccare le richieste rivolte al proprio sito web. Puoi applicare le regole di accesso a un solo dominio o a tutti i domini nella stessa istanza del servizio.
• ua-rules: Eseguire il controllo degli accessi solo se l' UserAgent e corrisponde esattamente a quella segnalata dal client. I meccanismi del controllo di accesso possono essere definiti all'interno di una regola per semplificare la gestione del traffico da particolari client. Ciò ti consente di personalizzare l'accesso al tuo sito.
• lockdowns: Limita l'accesso agli URL di questo dominio solo agli indirizzi o agli intervalli di indirizzi autorizzati.

-d, --domain

ID dominio DNS. Per la regola di tipo ua-rules e lockdowns, è un parametro obbligatorio.

-i, --instance

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

--output

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

Esempi

Ottieni i dettagli della regola del firewall.

ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

Opzioni comando

FIREWALL_RULE_ID

L'ID della regola del firewall. Obbligatorio.

-t, --type

Tipo di regola del firewall da creare. I valori validi sono access-rules, ua-rules e lockdowns. Obbligatorio.

• access-rules: Le regole di accesso consentono di autorizzare, verificare o bloccare le richieste rivolte al proprio sito web. Puoi applicare le regole di accesso a un solo dominio o a tutti i domini nella stessa istanza del servizio.
• ua-rules: Eseguire il controllo degli accessi solo se l' UserAgent e corrisponde esattamente a quella segnalata dal client. I meccanismi del controllo di accesso possono essere definiti all'interno di una regola per semplificare la gestione del traffico da particolari client. Questo campo ti permette di personalizzare l'accesso al tuo sito.
• lockdowns: Limita l'accesso agli URL di questo dominio solo agli indirizzi o agli intervalli di indirizzi autorizzati.

-d, --domain

ID dominio DNS. Per la regola di tipo ua-rules e lockdowns, è un parametro obbligatorio.

-i, --instance

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

Esempi

Elimina una regola del firewall.

ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--page

Numero pagina o risultati in pagina. Il valore predefinito è 1.

--per-page

Numero regole di firewall per pagina. Il valore minimo è 5 e il valore massimo è 100. Il valore predefinito è 25.

-i, --instance

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

--output

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

Esempi

Elencare le regole firewall esistenti nel dominio DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

FIREWALL_RULE_ID

L'ID della regola del firewall. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Per i dettagli sulla regola del firewall, visita la pagina FIREWALL_RULE_ID.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--expression

Un'espressione filtro. Ad esempio, ip.src eq 93.184.216.0.

--action

L'azione regola da eseguire. I valori validi sono log, allow, challenge, js_challenge, block e bypass.

--priority

La priorità di questa regola. I valori validi vanno da 0 a 2147483647. Il valore " 0 " indica di impostare il valore predefinito.

--description

Per descrivere in breve la regola.

--paused

Indica se la regola è attiva o meno. I valori validi sono on e off. Il valore predefinito è off.

--products

L'elenco dei prodotti di sicurezza da ignorare. I valori validi sono zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una regola del firewall.

• I campi obbligatori nei dati JSON sono expression e action.
  • expression: Un'espressione di filtro. Ad esempio, ip.src eq 93.184.216.0
  • action: L'azione da eseguire. I valori validi sono log, allow, challenge, js_challenge, block e bypass.
• I campi facoltativi sono description, priority, paused, products.
  • description: Per descrivere brevemente la regola.
  • priority: La priorità della regola. I valori validi vanno da 0 a 2147483647. Il valore " 0 " indica di impostare il valore predefinito.
  • paused: Indica se la regola è attiva o meno. I valori validi sono on e off. Il valore predefinito è off.
  • products: L'elenco dei prodotti di sicurezza da escludere. I valori validi sono zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf. Ad esempio: --products, zoneLockdown, rateLimit

Dati JSON di esempio:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola firewall.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Creare una regola firewall nel dominio DNS_DOMAIN_ID.

ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

FIREWALL_RULE_ID

L'ID della regola del firewall. Obbligatorio.

--expression

Un'espressione filtro. Ad esempio, ip.src eq 93.184.216.0.

--action

L'azione regola da eseguire. I valori validi sono log, allow, challenge, js_challenge, block e bypass.

--priority

La priorità di questa regola. I valori validi vanno da 0 a 2147483647. Il valore " 0 " indica di impostare il valore predefinito.

--description

Per descrivere in breve la regola.

--paused

Indica se la regola è attiva o meno. I valori validi sono on e off. Il valore predefinito è off.

--products

L'elenco dei prodotti di sicurezza da ignorare. I valori validi sono zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una regola del firewall.

• I campi obbligatori nei dati JSON sono expression e action.
  • expression: Un'espressione di filtro. Ad esempio, ip.src eq 93.184.216.0
  • action: L'azione da eseguire. I valori validi sono log, allow, challenge, js_challenge, block e bypass.
• I campi facoltativi sono description, priority, paused, products.
  • description: Per descrivere brevemente la regola.
  • priority: La priorità della regola. I valori validi vanno da 0 a 2147483647. Il valore " 0 " indica di impostare il valore predefinito.
  • paused: Indica se la regola è attiva o meno. I valori validi sono on e off. Il valore predefinito è off.
  • products: L'elenco dei prodotti di sicurezza da escludere. I valori validi sono zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf. Ad esempio: --products, zoneLockdown, rateLimit

I campi description, priority, e paused, che non sono impostati esplicitamente nei dati JSON, vengono sovrascritti dal valore predefinito.

Dati JSON di esempio:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola firewall.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiornare regola firewall FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

FIREWALL_RULE_ID

L'ID della regola del firewall. Obbligatorio.

-i, --instance

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

Esempi

Cancellare regola firewall FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

EXPRESSION

L'espressione del filtro. Ad esempio, ip.src eq 93.184.216.0. Obbligatorio.

-i, --instance

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

Esempi

Convalida l'espressione della regola firewall.

ibmcloud cis firewall-rule-validate DNS_DOMAIN_ID "ip.src eq 93.184.216.0"

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un bilanciatore di carico globale. Obbligatorio.

• I campi obbligatori nei dati JSON sono name, fallback_pool e default_pools:
  • name: Il nome host DNS da associare al bilanciatore di carico.
  • fallback_pool: L'ID del pool da utilizzare quando tutti gli altri pool vengono rilevati come non funzionanti.
  • default_pools: Un elenco di ID delle pool ordinati in base alla loro priorità di failover.
• I campi facoltativi sono description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: La descrizione del tuo bilanciatore di carico.
  • ttl: il TTL (time to live) della voce DNS per l'indirizzo IP restituito da questo programma di bilanciamento del carico.
  • region_pools: Una mappatura dei codici di regione e di paese a un elenco di ID di pool (ordinati in base alla loro priorità di failover) per la regione.
  • proxied: Consente di stabilire se il traffico debba passare attraverso le funzioni di sicurezza e prestazioni su CIS.
  • enabled: Se abilitare (impostazione predefinita) questo bilanciatore di carico.
  • session_affinity assicura che le richieste di un utente siano costantemente indirizzate allo stesso server di backend durante una sessione. I valori validi sono cookie e none.
  • session_affinity_ttl: Tempo, in secondi, che intercorre fino alla scadenza del cookie di affinità di sessione di questo bilanciatore di carico dopo la sua creazione. Il valore valido è compreso tra [1800, 604800]. Il valore predefinito è 82800.
  • steering_policy : I valori validi per steering_policy sono off, ` `geo, random e ` `dynamic_latency.
    • off: Utilizza default_pools.
    • geo: Utilizza region_pools/pop_pools.
    • random: Scegli un pool a caso.
    • dynamic_latency: Utilizza il tempo di andata e ritorno per selezionare il pool più vicino in default_pools (richiede controlli di integrità del pool).

Dati JSON di esempio:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}

-s, --json-str

Obsoleto. I dati JSON che descrivono un GLB (Global Load Balancer).

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Crea un bilanciatore di carico globale nel dominio DNS_DOMAIN_ID.

ibmcloud cis glb-create DNS_DOMAIN_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

GLB_ID

L'ID del bilanciatore di carico globale. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un bilanciatore di carico globale. Obbligatorio.

• I campi obbligatori nei dati JSON sono name, fallback_pool e default_pools:
  • name: Il nome host DNS da associare al bilanciatore di carico.
  • fallback_pool: L'ID del pool da utilizzare quando tutti gli altri pool vengono rilevati come non funzionanti.
  • default_pools: Un elenco di ID delle pool ordinati in base alla loro priorità di failover.
• I campi facoltativi sono description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: La descrizione del tuo bilanciatore di carico.
  • ttl: Tempo di validità (TTL) della voce DNS relativa all'indirizzo IP restituito da questo bilanciatore di carico.
  • region_pools: Una mappatura dei codici di regione e di paese a un elenco di ID di pool (ordinati in base alla loro priorità di failover) per la regione.
  • proxied: Consente di stabilire se il traffico debba passare attraverso le funzioni di sicurezza e prestazioni su CIS.
  • enabled: Se abilitare (impostazione predefinita) questo bilanciatore di carico.
  • session_affinity assicura che le richieste di un utente siano costantemente indirizzate allo stesso server di backend durante una sessione. I valori validi sono cookie e none.
  • session_affinity_ttl: Tempo, in secondi, che intercorre tra la creazione del cookie di affinità di sessione di questo bilanciatore di carico e la sua scadenza. Il valore valido è compreso tra [1800, 604800]. Il valore predefinito è 82800.
  • steering_policy : I valori validi per steering_policy sono off, ` `geo, random e ` `dynamic_latency.
    • off: Utilizza default_pools.
    • geo: Utilizza region_pools/pop_pools.
    • random: Scegli un pool a caso.
    • dynamic_latency: Utilizza il tempo di andata e ritorno per selezionare il pool più vicino in default_pools (richiede controlli di integrità del pool).

Dati JSON di esempio:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}

-s, --json-str

Obsoleto. I dati JSON che descrivono un GLB (Global Load Balancer).

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiornare il bilanciatore di carico globale GLB_ID nel dominio DNS_DOMAIN_ID.

ibmcloud cis glb-update DNS_DOMAIN_ID GLB_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

GLB_ID

L'ID del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra il bilanciatore di carico globale GLB_ID nel dominio DNS_DOMAIN_ID.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

GLB_ID

L'ID del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

Esempi

Elimina il bilanciatore di carico globale GLB_ID nel dominio DNS_DOMAIN_ID.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca i bilanciatori di carico per il dominio DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Opzioni comando

-i, --instance

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

--output

Specifica il formato dell'output. È supportato solo JSON.

Esempi

Elencare tutte le piscine GLB.

ibmcloud cis glb-pools

Opzioni comando

--json

Il file JSON o la stringa JSON utilizzati per descrivere un pool GLB. Obbligatorio.

• I campi obbligatori nei dati JSON sono name, origins e check_regions:
  • name: Un nome breve (tag) per il pool.
  • origins: Un elenco delle origini presenti in questo gruppo.
  • check_regions: Un elenco dei codici delle regioni geografiche.
• I campi facoltativi sono description, minimum_origins, enabled, monitor.

Dati JSON di esempio:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["test.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un pool GLB.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Creare un pool GLB.

ibmcloud cis glb-pool-create --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["test.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true,"header":{"host":["example.com"]}}]}'

Opzioni comando

GLB_POOL_ID

L'ID del pool del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra i dettagli del pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool GLB_POOL_ID

Opzioni comando

GLB_POOL_ID

L'ID del pool del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

Esempi

Elimina il pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Opzioni comando

GLB_POOL_ID

L'ID del pool del bilanciatore di carico globale. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un pool GLB.

• I campi obbligatori nei dati JSON sono name, origins e check_regions:
  • name: Un nome breve (tag) per il pool.
  • origins: Un elenco delle origini presenti in questo gruppo.
  • check_regions: Un elenco dei codici delle regioni geografiche.
• I campi facoltativi sono description, minimum_origins, enabled, monitor.

Dati JSON di esempio:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}

--enable-origin

Abilita l'origine all'interno del pool. Il valore può essere ORIGIN_NAME o ORIGIN_ADDRESS.

--disable-origin

Disabilita l'origine all'interno del pool. Il valore può essere ORIGIN_NAME o ORIGIN_ADDRESS.

--add-origin

Aggiunge un'origine nel pool. ORIGIN_NAME e ORIGIN_ADDRESS sono obbligatori. Ad esempio, --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Rimuove un'origine dal pool. Il valore può essere ORIGIN_NAME o ORIGIN_ADDRESS.

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un pool GLB.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiornamento del pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool-update GLB_POOL_ID --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["example.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true}]}'

Opzioni comando

-i, --instance

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

--output

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

Esempi

Elencare tutti i monitor GLB.

ibmcloud cis glb-monitors

Opzioni comando

--json

Il file JSON o la stringa JSON utilizzati per descrivere un monitor GLB. Obbligatorio.

• I campi obbligatori nei dati JSON sono type.
  • type: Il protocollo da utilizzare per il controllo dello stato di salute. I valori validi sono HTTP, HTTPS e TCP.
• I campi facoltativi sono description, timeout, retries, interval.
  • description: Descrizione.
  • timeout: Il tempo di attesa (in secondi) prima che il controllo di integrità venga contrassegnato come fallito.
  • retries: Il numero di tentativi da effettuare in caso di timeout prima di contrassegnare l'origine come non funzionante.
  • interval: L'intervallo tra un controllo di stato e l'altro.
• Per TCP il tipo di controllo di integrità. I campi obbligatori supplementari sono port.
  • port: La porta dell' TCP e da utilizzare per il controllo dello stato.
• Per HTTP/HTTPS il tipo di controllo di integrità. I campi facoltativi supplementari sono port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: La porta dell' TCP e da utilizzare per il controllo dello stato.
  • expected_body: Una sottostringa (senza distinzione tra maiuscole e minuscole) da cercare nel corpo della risposta.
  • expected_codes: Il codice di risposta previsto HTTP o l'intervallo di codici del controllo di integrità.
  • method: Il metodo HTTP da utilizzare per il controllo di integrità.
  • path: Il percorso dell'endpoint su cui eseguire il controllo di integrità.
  • header: Le intestazioni della richiesta HTTP da inviare durante il controllo di integrità.
  • follow_redirects: Seguire i reindirizzamenti se restituiti dal sito di origine.
  • allow_insecure: Non convalidare il certificato quando il monitor utilizza HTTPS.
  • probe_zone: Assegnare questo monitor per emulare la zona specificata durante la verifica.

Dati JSON di esempio:

Per HTTP/HTTPS:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

Per TCP:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un monitoraggio GLB.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Creare un monitor GLB.

ibmcloud cis glb-monitor-create --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

Opzioni comando

GLB_MON_ID

L'ID del monitor del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Visualizza i dettagli del monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor GLB_MON_ID

Opzioni comando

GLB_MON_ID

L'ID del monitor del bilanciatore di carico globale. Obbligatorio.

-i, --instance

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

Esempi

Cancellare il monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Opzioni comando

GLB_MON_ID

L'ID del monitor del bilanciatore di carico globale. Obbligatorio.

--json

Il file JSON o la stringa JSON utilizzati per descrivere un monitor GLB. Obbligatorio.

• I campi obbligatori nei dati JSON sono type.
  • type: Il protocollo da utilizzare per il controllo dello stato di salute. I valori validi sono HTTP, HTTPS e TCP.
• I campi facoltativi sono description, timeout, retries, interval.
  • description: Descrizione.
  • timeout: Il tempo di attesa (in secondi) prima che il controllo di integrità venga contrassegnato come fallito.
  • retries: Il numero di tentativi da effettuare in caso di timeout prima di contrassegnare l'origine come non funzionante.
  • interval: L'intervallo tra un controllo di stato e l'altro.
• Per TCP il tipo di controllo di integrità. I campi obbligatori supplementari sono port.
  • port: La porta dell' TCP e da utilizzare per il controllo dello stato.
• Per HTTP/HTTPS il tipo di controllo di integrità. I campi facoltativi supplementari sono port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: La porta dell' TCP e da utilizzare per il controllo dello stato.
  • expected_body: Una sottostringa (senza distinzione tra maiuscole e minuscole) da cercare nel corpo della risposta.
  • expected_codes: Il codice di risposta previsto HTTP o l'intervallo di codici del controllo di integrità.
  • method: Il metodo HTTP da utilizzare per il controllo di integrità.
  • path: Il percorso dell'endpoint su cui eseguire il controllo di integrità.
  • header: Le intestazioni della richiesta HTTP da inviare durante il controllo di integrità.
  • follow_redirects: Seguire i reindirizzamenti se restituiti dal sito di origine.
  • allow_insecure: Non convalidare il certificato quando il monitor utilizza HTTPS.
  • probe_zone: Assegnare questo monitor per emulare la zona specificata durante la verifica.

Dati JSON di esempio:

Per HTTP/HTTPS:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

Per TCP:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

Obsoleto. I dati JSON utilizzati per descrivere un monitoraggio GLB.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiornamento del monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor-update GLB_MON_ID --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

Opzioni comando

-s, --since

Data di inizio del periodo di richiesta dei dati in formato ISO8601. Ad esempio 2018-11-26.

-u, --until

Data di fine del periodo di richiesta dei dati in formato ISO8601. Ad esempio 2018-11-28.

--origin-name

Il nome dell'origine in base alla quale applicare il filtro.

--pool-name

Il nome del pool in base al quale applicare il filtro.

--origin-healthy

Se vero, filtra gli eventi in cui lo stato dell'origine è "corretto"; se falso, filtra gli eventi in cui lo stato dell'origine è "non corretto". Il valore predefinito è true e i valori validi sono true e false.

--pool-healthy

Se vero, filtra gli eventi in cui lo stato del pool è "corretto"; se falso, filtra gli eventi in cui lo stato del pool è "non corretto". Il valore predefinito è true e i valori validi sono true e false.

-i, --instance

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

--output

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

Esempi

Ottenere gli eventi glb.

ibmcloud cis glb-events --since "2020-05-20" --until "2020-05-22" --origin-name "dal09" --origin-healthy true --instance INSTANCE

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--fields

Definire l'insieme di campi da restituire.

• Questo campo deve essere specificato come un elenco separato da virgole senza spazi, e tutti i campi devono essere presenti.
• L'ordine in cui vengono specificati i campi non ha importanza e l'ordine dei campi nella risposta non è specificato.
• I campi devono essere sensibili alle maiuscole e alle minuscole.

--filter

Filtri per eseguire il drill-down in eventi specifici. I filtri sono composti da tre parti: chiave, operatore e valore. Per informazioni sugli operatori supportati, vedere Uso di campi, funzioni ed espressioni.

--sample

La percentuale di record impostata dal cliente: sample: 1 corrisponde al 100% dei record.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

-h, --help

Ottieni assistenza su questo comando.

Esempi

Creare un registro istantaneo per il dominio DNS_DOMAIN_ID:

ibmcloud cis instant-log-create DNS_DOMAIN_ID --fields all --sample 1

Di seguito sono riportati tre esempi di filtri:

• Filtro quando il paese IP del cliente non è il Canada:

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientCountry\",\"operator\":\"neq\",\"value\":\"ca\"}]}}"

• Filtrare quando il codice di stato restituito da CIS è 200 o 201:

"filter": "{\"where\":{\"and\":[{\"key\":\"EdgeResponseStatus\",\"operator\":\"in\",\"value\":\"200,201\"}]}}"

• Filtra quando il percorso della richiesta contiene "/static" e il nome host della richiesta è " example.com ":

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/static\"}, {\"where\":{\"and\":[{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"example.com\"}]}}"

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

Il nome o l'ID dell'istanza. Se il nome o l'ID dell'istanza non sono impostati, viene utilizzata l'istanza del contesto specificata da cis instance-set INSTANCE.

--output

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

-h, --help

Guida su questo comando.

Esempio

Ottieni il processo di registrazione istantanea per il dominio DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--available-fields

Elenco di tutti i campi disponibili.

--ray-id

Ricerca i log in base ad un ID ray specifico.

--fields

Definire l'insieme di campi da restituire. Questo campo deve essere specificato come elenco separato da virgole senza spazi, e tutti i campi devono essere presenti. L'ordine in cui vengono specificati i campi non ha importanza e l'ordine dei campi nella risposta non è specificato. Tieni presente che è previsto che i campi siano sensibili al maiuscolo/minuscolo.

--start

L'inizio (incluso) del periodo di tempo richiesto Questo valore può essere una data/ora unix (in secondi o nanosecondi) oppure una data/ora assoluta conforme a RFC 3339. Al momento, non può superare un periodo nel passato superiore a 7 giorni. L'impostazione predefinita è di 65 minuti prima.

--end

La fine (escluso) il periodo di tempo richiesto Questo valore può essere un timestamp Unix (in secondi o nanosecondi) oppure un timestamp assoluto conforme alla specifica RFC 3339. Il valore end deve essere almeno 5 minuti prima rispetto al momento attuale e deve essere successivo a start. La differenza tra start e end non deve essere superiore a 1h. L'impostazione predefinita è 5 minuti prima.

--count

Numero di log da richiamare Il valore predefinito è -1.

--sample

Percentuale di campionamento Quando viene fornito un campione, viene restituito un campione di record corrispondenti. Se sample=0.1, viene restituito il 10% dei record. Il campionamento è casuale: le chiamate ripetute non solo restituiscono record diversi, ma probabilmente presentano anche lievi variazioni nel numero di record restituiti. Quando si specifica anche il conteggio, questo viene applicato al numero di record restituiti, non ai record campionati. Quindi, con sample=0.05 e count=7, quando sono disponibili in totale 100 record, ne vengono restituiti circa 5. Quando ci sono 1000 record, ne vengono restituiti 7. Quando ci sono 10.000 record, ne vengono restituiti 7. Il valore predefinito è 1.

--timestamps

Impostare il formato in cui sono restituite le date/ore di risposta. I valori validi sono unix, unixnano e rfc3339.

-i, --instance

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

--output

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

Esempi

ibmcloud cis logpull DNS_DOMAIN_ID --available-fields
ibmcloud cis logpull DNS_DOMAIN_ID --ray-id 59348abde87afe50 --all-fields --timestamps rfc3339 --output json
ibmcloud cis logpull DNS_DOMAIN_ID --start 2020-05-18T12:14:58Z --end 2020-05-18T13:14:58Z --fields ClientIP,EdgeServerIP,ClientRequestHost --count 10 --sample 1 --timestamps rfc3339 --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--destination

Specificare una destinazione in cui i dati vengono spinti. Per ulteriori informazioni sulle destinazioni supportate, vedere Gestione dei lavori Logpush.

• Sintassi per il percorso " Cloud Object Storage ": cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Esempio: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Per suddividere i log in sottocartelle giornaliere, utilizzare la stringa speciale {DATE} nel percorso del bucket. Viene sostituita con la data nel formato " YYYYMMDD ", ad esempio "20190423". Se necessario, vengono create delle sottocartelle, ad esempio: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Nome lavoro. Obbligatorio.

--enable

Abilita il lavoro. Il lavoro è disabilitato per impostazione predefinita.

--fields

Definisci l'elenco di campi di log da includere nei file di log. È possibile separare più campi con virgole e utilizzare il comando [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] per ottenere l'elenco completo dei campi di log disponibili, oppure utilizzare all per includere tutti i campi disponibili nei file di log. Tieni presente che è previsto che i campi siano sensibili al maiuscolo/minuscolo.

--timestamps

Impostare il formato in cui sono restituite le date/ore di risposta. I valori validi sono unix, unixnano e rfc3339.

--dataset

La categoria di registri che desideri ricevere. Questo valore non può essere modificato una volta creato il lavoro. I valori validi sono http_requests, range_events, firewall_events, dns_logs. Il valore predefinito è http_requests.

--frequency

La frequenza con cui CIS invia batch di log alla destinazione. Impostando una frequenza elevata, i log vengono inviati in grandi quantità di file più piccoli. Impostando la frequenza su bassa, i log vengono inviati in quantità minori di file più grandi. I valori validi sono high, low.

-i, --instance

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

--output

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

Esempi

Creare un lavoro di logpush per il dominio DNS_DOMAIN_ID.

ibmcloud cis logpush-job-create DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --name logpushcreate --enable true --fields all --timestamps rfc3339 --dataset http_requests --frequency low --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--destination

Specificare una destinazione in cui i dati vengono spinti. Per ulteriori informazioni sulle destinazioni supportate, vedere Gestione dei lavori Logpush. Sintassi per il percorso " Cloud Object Storage ": cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Esempio: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Per separare i log in sottocartelle giornaliere, utilizza la stringa speciale {DATE} nel percorso del bucket. Va sostituita con la data nel formato YYYYMMDD, ad esempio "20190423". Se necessario, vengono create delle sottocartelle, ad esempio: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Abilita il lavoro. Il lavoro è disabilitato per impostazione predefinita.

--fields

Definisci l'elenco di campi di log da includere nei file di log. È possibile separare più campi con le virgole e utilizzare il comando ibmcloud cis logpush-available-fields DNS_DOMAIN_ID per ottenere l'elenco completo dei campi di log disponibili oppure utilizzare all per includere tutti i campi disponibili nei file di log. Tieni presente che è previsto che i campi siano sensibili al maiuscolo/minuscolo.

--timestamps

Impostare il formato in cui sono restituite le date/ore di risposta. I valori validi sono unix, unixnano, rfc3339.

--dataset

La categoria di registri che desideri ricevere. Questo valore non può essere modificato una volta creato il lavoro. I valori validi sono http_requests, range_events, firewall_events,dns_logs. Il valore predefinito è http_requests.

--jobid

JOB_ID è l'ID del lavoro di logpush.

--frequency

La frequenza con cui CIS invia batch di log alla destinazione. Impostando una frequenza elevata, i log vengono inviati in grandi quantità di file più piccoli. Impostando la frequenza su bassa, i log vengono inviati in quantità minori di file più grandi. I valori validi sono high e low.

-i, --instance

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

--output

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

Esempi

Aggiornare il lavoro di logpush range_events per il dominio DNS_DOMAIN_ID.

ibmcloud cis logpush-job-update DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --enable true --fields all --timestamps rfc3339 --dataset range_events --frequency high --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

-output

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

Esempi

Ottenere tutti i lavori di logpush per il dominio DNS_DOMAIN_ID.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--dataset

La categoria di registri che desideri ricevere. Questo valore non può essere modificato una volta creato il lavoro. I valori validi sono http_requests, range_events, firewall_events,dns_logs. Il valore predefinito è http_requests.

--jobid

JOB_ID è l'ID del lavoro di logpush.

-i, --instance

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

--output

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

Esempi

Ottenere i dettagli del lavoro di http_requests logpush.

ibmcloud cis logpush-job DNS_DOMAIN_ID --dataset http_requests --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--dataset

La categoria di registri che desideri ricevere. Questo valore non può essere modificato una volta creato il lavoro. I valori validi sono http_requests, range_events, firewall_events,dns_logs. Il valore predefinito è http_requests.

--jobid

JOB_ID è l'ID del lavoro di logpush.

-f, --force

Elimina il processo logpush senza richiedere conferma.

-i, --instance

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

Esempi

Cancellare il lavoro di logpush http_requests per il dominio DNS_DOMAIN_ID.

ibmcloud cis logpush-job-delete DNS_DOMAIN_ID --dataset http_requests --force

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--dataset

La categoria di registri che desideri ricevere. Questo valore non può essere modificato una volta creato il lavoro. I valori validi sono http_requests, range_events, firewall_events,dns_logs. Il valore predefinito è http_requests.

-i, --instance

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

Esempi

Ottieni tutti i campi disponibili per i log http_requests.

ibmcloud cis logpush-available-fields DNS_DOMAIN_ID --dataset http_requests

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Ottieni un'impostazione relativa alla conservazione dei log per il dominio DNS_DOMAIN_ID.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--flag

Se attivare o disattivare la conservazione dei log. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Abilita la conservazione dei log per il dominio DNS_DOMAIN_ID.

ibmcloud cis log-retention-update DNS_DOMAIN_ID --flag on --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--dataset

Dataset richiesto Il valore predefinito è firewallEventsAdaptiveGroups.

Utilizza la seguente tabella per identificare quali dataset sono inclusi nel tuo piano e l'intervallo di dati cronologici di cui puoi eseguire le query.

Set di dati inclusi nel piano

Dataset	Versione di prova / Standard / Standard-Next	Enterprise / Sicurezza / GLB
firewallEventsAdaptiveGroups	30 giorni	30 giorni
firewallEventsAdaptive	30 giorni	30 giorni

--filter

Eventi filtro. Il valore predefinito sono i dati delle ultime 6 ore.

I seguenti operatori sono supportati per tutte le opzioni di filtro:

Supporto agli operatori per le opzioni di filtro

Operatore	Confronto
GT	maggiore di
lt	minore di
eq	maggiore o uguale a
leq	minore o uguale a
neq	non uguale
in	in

• firewallEventsAdaptiveGroups filter options.
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFiveMinutes
  • datetimeMinute
  • matchIndex
  • sampleInterval
• The following filter options support like and notlike operators.
  • action
  • clientASNDescription
  • clientAsn
  • clientCountryName
  • clientIP
  • clientRefererHost
  • clientRefererPath
  • clientRefererQuery
  • clientRefererScheme
  • clientRequestHTTPHost
  • clientRequestHTTPMethodName
  • clientRequestHTTPProtocol
  • clientRequestPath
  • clientRequestQuery
  • clientRequestScheme
  • edgeColoName
  • edgeResponseStatus
  • kind
  • originResponseStatus
  • originatorRayName
  • rayName
  • ref
  • ruleId
  • source
  • userAgent

--order

Ordine di output. (Il valore predefinito è datetime_ASC)

Il seguente elenco riporta le opzioni di ordinamento disponibili per il set di dati corrispondente; tutte le opzioni di ordinamento supportano l'ordinamento in ordine crescente (ASC) e decrescente (DESC). Combina queste opzioni di filtro e l'azione con _.

Ad esempio, datetime_ASC ordina gli ordini in ordine crescente in base alla data e all'ora.

• Opzioni di ordinamento firewallEventsAdaptiveGroups.
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFiveMinutes
  • datetimeMinute
  • action
  • avg_sampleInterval
  • clientASNDescription
  • clientAsn
  • clientCountryName
  • clientIPClass
  • clientIP
  • clientRefererHost
  • clientRefererPath
  • clientRefererQuery
  • clientRefererScheme
  • clientRequestHTTPHost
  • clientRequestHTTPMethodName
  • clientRequestHTTPProtocol
  • clientRequestPath
  • clientRequestQuery
  • clientRequestScheme
  • count
  • edgeColoName
  • edgeResponseStatus
  • kind
  • matchIndex
  • originResponseStatus
  • originatorRayName
  • rayName
  • ref
  • ruleId
  • sampleInterval
  • source
  • userAgent
  • visibility

--limit

Il numero di eventi da restituire. (minimo: 1, massimo: 10000, predefinito: 10000)

-i, --instance

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

--output

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

Esempi

Ottieni le analisi degli eventi del firewall per il dominio DNS_DOMAIN_ID.

ibmcloud cis firewall-event-analytics DNS_DOMAIN_ID --order datetime_ASC --filter "datetime_geq:2020-06-28T00:00:00Z" --filter "datetime_leq:2020-06-29T00:00:00Z" --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--dataset

Dataset richiesto Il valore predefinito è httpRequests1dGroups. Utilizza la seguente tabella per identificare quali dataset sono inclusi nel tuo piano e l'intervallo di dati cronologici di cui puoi eseguire le query.

Identificare i set di dati inclusi nel piano

Dataset	Versione di prova / Standard / Standard-next	Enterprise / Sicurezza / GLB
httpRequests1dGroups	365 giorni	365 giorni
httpRequests1hGroups	30 giorni	90 giorni
httpRequests1mGroups	3 giorni	7 giorni

--filter

Eventi filtro. Il valore predefinito sono i dati degli ultimi 7 giorni. I seguenti operatori sono supportati per tutte le opzioni di filtro:

Supporto agli operatori per le opzioni di filtro

Operatore	Confronto
GT	maggiore di
lt	minore di
eq	maggiore o uguale a
leq	minore o uguale a
neq	non uguale
in	in

• Opzioni di filtro httpRequests1dGroups e httpRequests1hGroups.

  • date

• Opzioni di filtro httpRequests1mGroups.

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Ordine di output. (Il valore predefinito è datetime_ASC)

Il seguente elenco riporta le opzioni di ordinamento disponibili per il set di dati corrispondente; tutte le opzioni di ordinamento supportano l'ordinamento in ordine crescente (ASC) e decrescente (DESC). Combina queste opzioni di ordinamento e l'azione con _.

Ad esempio, date_ASC ordina i risultati in ordine crescente di data.

• Opzioni di ordinamento comuni per ogni dataset http.
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Opzioni di ordinamento httpRequests1dGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Opzioni di ordinamento httpRequests1hGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Opzioni di ordinamento httpRequests1mGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

Il numero di eventi da restituire. (minimo: 1, massimo: 10000, predefinito: 10000)

-i, --instance

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

--output

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

Esempi

Ottieni i dati analitici sulle richieste HTTP per il dominio DNS_DOMAIN_ID.

ibmcloud cis http-request-analytics DNS_DOMAIN_ID --order date_ASC --dataset httpRequests1dGroups --limit 500 --filter "date_geq:2020-06-28" --filter "date_leq:2020-06-29" --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--recent

L'inizio del periodo di tempo richiesto. I valori validi sono 6h (6 ore fa), 12h, 1d (1 giorno fa), 1w (1 settimana fa), 1m (1 mese fa), 2m, 3m. Il valore predefinito è 1w.

-t, --table

Tabella di output. I valori validi sono: requests, bandwidth, uniques, threats e status_code. Se questo campo non è impostato, vengono emesse tutte le tabelle.

-i, --instance

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

--output

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

Esempi

Ottieni i dati di analisi web per il dominio DNS_DOMAIN_ID.

ibmcloud cis web-analytics DNS_DOMAIN_ID --recent 1d -t requests

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

DIMENSION

La dimensione richiesta. I valori validi sono queries-by-response-code, queries-by-type, queries-by-name. Richiesto.

-s, --since

Dall'ora ad ora. I valori validi sono 6h (6 ore fa), 12h, 1d (1 giorno fa), 1w (1 settimana fa).

-i, --instance

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

--output

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

Esempi

Ottieni i dati analitici DNS relativi al dominio DNS_DOMAIN_ID.

ibmcloud cis dns-analytics DNS_DOMAIN_ID queries-by-response-code -s 6h --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--recent

L'inizio del periodo di tempo richiesto. I valori validi sono 6h (6 ore fa), 12h, 1d (1 giorno fa), 1w (1 settimana fa), 1m (1 mese fa), 2m, 3m. Il valore predefinito è 1w.

--time-delta

L'intervallo di tempo (secondi) di ciascun record dell'analisi. I valori validi sono 60, 3600, 86400, 2592000. Il valore predefinito è 3600.

-i, --instance

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

--output

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

Esempi

Ottieni i dati analitici sui limiti di frequenza per il dominio DNS_DOMAIN_ID.

ibmcloud cis ratelimit-analytics DNS_DOMAIN_ID --recent 6h --time-delta 3600 --output json

Opzioni comando

-i, --instance

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

Esempi

Abilitare la mutua TLS.

ibmcloud cis access-enable

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutti i certificati di origine per il dominio DNS_DOMAIN_ID.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--request-type REQUEST_TYPE

Tipo di firma che si desidera apporre sul certificato. I valori validi sono origin-rsa e origin-ecc.

--hostnames HOSTNAME

hostname o nome jolly legato al certificato.

--requested-validity DAYS

Il numero di giorni per i quali il certificato deve essere valido. Il valore predefinito è 5475.

--csr CSR

CSR (Certificate Signing Request). Se questo campo non è impostato, CIS ne genera uno.

--json value*

Il file JSON o la stringa JSON utilizzati per descrivere un certificato di origine.

• I campi obbligatori nei dati JSON sono request_type, hostnames.
  • request_type tipo di firma che si desidera apporre sul certificato. I valori validi sono origin-rsa, origin-ecc.
  • hostnames: Un array di nomi host o nomi con caratteri jolly associati al certificato.
• I campi facoltativi sono requested_validity, csr.
  • requested_validity: Il numero di giorni per i quali il certificato deve essere valido. I valori validi sono 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: La richiesta di firma del certificato (CSR). Se questo campo non è impostato, CIS ne genera uno.

Dati JSON di esempio:

{
   "request_type": "origin-rsa",
   "hostnames": [
      "*.example.com",
      "example.com",
],
   "requested_validity": 5475,
   "csr": "your_csr"
}

-s, --json-str

Obsoleto. I dati JSON che descrivono un certificato di origine.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Creare un certificato firmato da CIS per il dominio DNS_DOMAIN_ID.

ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --request-type origin-rsa --hostnames "*.example.com" --hostnames "example.com" --requested-validity 5475 --csr your_csr --output json
ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --json '{"hostnames":["example.com","*.example.com"], "requested_validity":5475,"request_type": "origin-rsa","csr":"-----BEGIN CERTIFICATE REQUEST-----\nMIICxzCCAa8CAQAwSDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDVNhbiBGcmFuY2lz\nY28xCzAJBgNVBAcTAkNBMRQwEgYDVQQDEwtleGFtcGxlLm5ldDCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBALxejtu4b+jPdFeFi6OUsye8TYJQBm3WfCvL\nHu5EvijMO/4Z2TImwASbwUF7Ir8OLgH+mGlQZeqyNvGoSOMEaZVXcYfpR1hlVak8\n4GGVr+04IGfOCqaBokaBFIwzclGZbzKmLGwIQioNxGfqFm6RGYGA3be2Je2iseBc\nN8GV1wYmvYE0RR+yWweJCTJ157exyRzu7sVxaEW9F87zBQLyOnwXc64rflXslRqi\ng7F7w5IaQYOl8yvmk/jEPCAha7fkiUfEpj4N12+oPRiMvleJF98chxjD4MH39c5I\nuOslULhrWunfh7GB1jwWNA9y44H0snrf+xvoy2TcHmxvma9Eln8CAwEAAaA6MDgG\nCSqGSIb3DQEJDjErMCkwJwYDVR0RBCAwHoILZXhhbXBsZS5uZXSCD3d3dy5leGFt\ncGxlLm5ldDANBgkqhkiG9w0BAQsFAAOCAQEAcBaX6dOnI8ncARrI9ZSF2AJX+8mx\npTHY2+Y2C0VvrVDGMtbBRH8R9yMbqWtlxeeNGf//LeMkSKSFa4kbpdx226lfui8/\nauRDBTJGx2R1ccUxmLZXx4my0W5iIMxunu+kez+BDlu7bTT2io0uXMRHue4i6quH\nyc5ibxvbJMjR7dqbcanVE10/34oprzXQsJ/VmSuZNXtjbtSKDlmcpw6To/eeAJ+J\nhXykcUihvHyG4A1m2R6qpANBjnA0pHexfwM/SgfzvpbvUg0T1ubmer8BgTwCKIWs\ndcWYTthM51JIqRBfNqy4QcBnX+GY05yltEEswQI55wdiS3CjTTA67sdbcQ==\n-----END CERTIFICATE REQUEST-----"}' --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

CERT_ID

L'ID del certificato di origine. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Per maggiori informazioni sul certificato di origine, visita il sito CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

CERT_ID

L'ID del certificato di origine. Obbligatorio.

-i, --instance

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

Esempi

Elimina il certificato di origine CERT_ID.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Mostra le informazioni generali relative al dominio DNS_DOMAIN_ID.

ibmcloud cis overview DNS_DOMAIN_ID

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 pagina. Obbligatorio.

• I campi obbligatori nei dati JSON sono targets e actions:
  • targets: Il modello URL da valutare in base alla richiesta.
  • actions: Una serie di azioni da eseguire se i target di questa regola corrispondono alla richiesta. Le azioni disponibili sono:
    • disable_security
    • always_use_https
    • ssl
    • browser_cache_ttl
    • security_level
    • cache_level
    • edge_cache_ttl
    • bypass_cache_on_cookie
    • browser_check
    • server_side_exclude
    • email_obfuscation
    • automatic_https_rewrites
    • opportunistic_encryption
    • ip_geolocation
    • explicit_cache_control
    • cache_deception_armor
    • waf
    • forwarding_url
    • Deprecato. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Alcune azioni sono disponibili solo nei piani Enterprise:
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• I campi facoltativi sono priority e status:
  • priority: Un numero che indica la priorità di una regola di pagina rispetto a un'altra. Il valore predefinito è 1.
  • status: Stato della regola della pagina. I valori ammessi sono active e disabled (impostazione predefinita).

Dati JSON di esempio:

   {
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola della pagina.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Crea una regola di pagina per il dominio DNS_DOMAIN_ID.

ibmcloud cis page-rule-create DNS_DOMAIN_ID --json '{"targets":[{"target":"url", "constraint":{"operator": "matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}], "priority":1, "status": "active"}' --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

PAGE_RULE_ID

L'ID della regola della pagina. Obbligatorio.

--json VALUE

Il file JSON o la stringa JSON utilizzati per descrivere una regola di pagina. Obbligatorio.

• I campi obbligatori nei dati JSON sono targets e actions:
  • targets: Il modello URL da valutare in base alla richiesta.
  • actions: Una serie di azioni da eseguire se i target di questa regola corrispondono alla richiesta. Le azioni disponibili sono:
    • disable_security
    • always_use_https
    • ssl
    • browser_cache_ttl
    • security_level
    • cache_level
    • edge_cache_ttl
    • bypass_cache_on_cookie
    • browser_check
    • server_side_exclude
    • email_obfuscation
    • automatic_https_rewrites
    • opportunistic_encryption
    • ip_geolocation
    • explicit_cache_control
    • cache_deception_armor
    • waf
    • forwarding_url
    • Deprecato. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Alcune azioni sono disponibili solo nei piani Enterprise:
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• I campi facoltativi sono priority e status:
  • priority: Un numero che indica la priorità di una regola di pagina rispetto a un'altra. Il valore predefinito è 1.
  • status: Stato della regola della pagina. I valori validi sono active e disabled. Il valore predefinito è disabled.

Dati JSON di esempio:

{
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}

-s, --json-str

Obsoleto. I dati JSON che descrivono una regola della pagina.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Aggiorna la regola della pagina PAGE_RULE_ID.

ibmcloud cis page-rule-update DNS_DOMAIN_ID PAGE_RULE_ID --json '{"targets":[{"target":"url", "constraint":{"operator":"matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}],"priority":1, "status":"active"}' --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

PAGE_RULE_ID

L'ID della regola della pagina. Obbligatorio.

-i, --instance

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

Esempi

Elimina la regola della pagina PAGE_RULE_ID.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Elenca tutte le regole delle pagine nel dominio DNS_DOMAIN_ID.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

PAGE_RULE_ID

L'ID della regola della pagina. Obbligatorio.

-i, --instance

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

--output

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

Esempi

Per ulteriori dettagli sulla regola della pagina, visita PAGE_RULE_ID.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Opzioni comando

DNS_DOMAIN_ID

L'ID del dominio DNS. Obbligatorio.

--name

Il nome del record DNS relativo alla richiesta di intervallo.

--edge-port

Configurazione della porta in Edge di CIS Il valore predefinito è 22.

--origin-direct

Indirizzi di destinazione per l'origine

--origin-lb-name

Il nome del sistema di bilanciamento del carico associato all'applicazione range.

--origin-lb-port

La porta del sistema di bilanciamento del carico associata all'applicazione range. Il valore predefinito è 22.

--protocol

Tipo di protocollo. I valori validi sono tcp e udp. Il supporto del protocollo UDP è presente in Early Access, richiedi un UDP personalizzato dal dashboard CIS prima di creare un'applicazione UDP Range. Il valore predefinito è tcp.

--proxy-protocol

Abilita il protocollo proxy all'origine I valori validi sono on, off, v1, v2, simple. Il valore predefinito è off. Obsoleto. Il valore on equivale a v1.

--ip-firewall

Controlla se il firewall IP per questa applicazione è abilitato. I valori validi sono on e off. Il valore predefinito è off.

--edge-connectivity

Le versioni IP supportate per le connessioni in entrata su un intervallo di indirizzi IP anycast. I valori validi sono all, ipv4, ipv6. Il valore predefinito è all.

--edge-tls

Il tipo di terminazione TLS associato all'applicazione. I valori validi sono off, flexible, full, strict. Il valore predefinito è off.

--traffic-type

Determina in che modo i dati viaggiano da edge all'origine. I valori validi sono direct, http, https. Il valore predefinito è direct.

--json

Il file JSON o la stringa JSON utilizzati per descrivere una domanda di autorizzazione di intervallo.

• I campi obbligatori nei dati JSON sono protocol e dns.
  • protocol: Configurazione delle porte sul perimetro di CIS.
  • dns: Il nome e il tipo del record DNS relativo alla richiesta di intervallo.
    • name: Il nome del record DNS relativo alla richiesta di intervallo.
    • type: Il tipo del record DNS associato all'applicazione. Il valore valido è CNAME.
• I campi facoltativi sono origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls e traffic_type.
  • origin_direct: Un elenco di indirizzi di destinazione rispetto all'origine.
  • origin_dns: Metodo e parametri utilizzati per individuare l'indirizzo del server di origine tramite DNS.
    • name: Nome del record DNS.
  • origin_port: Il porto di destinazione all'origine.
  • proxy_protocol: Abilitare il protocollo proxy verso l'origine. I valori validi sono on, off, v1, v2, simple. Il valore predefinito è off. Obsoleto. Il valore on equivale a v1.
  • ip_firewall controlla se il firewall IP per questa applicazione è abilitato. I valori validi sono on e off.
  • edge_ips: La configurazione dell'IP periferico anycast per il nome host di questa applicazione.
    • type: Il tipo di configurazione IP di bordo specificato. Gli IP edge assegnati dinamicamente utilizzano gli IP anycast in base alla connettività che specifichi. Il valore valido è dynamic.
    • connectivity: Le versioni IP supportate per le connessioni in entrata su un intervallo di indirizzi IP anycast. Valori validi: all, ipv4, ipv6.
  • tls: il tipo di terminazione TLS associato all'applicazione. I valori validi sono off, flexible, full e strict.
  • traffic_type: Determina il percorso che i dati seguono dall'edge all'origine. Se impostato su “ direct ”, “range” invia il traffico direttamente all’origine e il tipo dell’applicazione viene dedotto dal protocollo. Se impostato su “ http ” o “ https ”, il range applica le funzionalità di CIS ( HTTP / HTTPS ) poiché invia il traffico all’origine e il tipo di applicazione corrisponde esattamente a questa proprietà. I valori validi sono direct, http e https. Il valore predefinito è direct.

Dati JSON di esempio:

{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "ssh.example.com"
   },
   "origin_direct": [
      "tcp://1.2.3.4:22",
      "tcp://1.2.3.4:23",
      "tcp://1.2.3.4:24"
   ],
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "glb.example.com"
   },
   "origin_dns": {
      "name": "name-to-glb.example.com"
   },
   "origin_port": 22,
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}

-s, --json-str

Obsoleto. I dati JSON che descrivono un'applicazione Range.

-j, --json-file

Obsoleto. Un file contiene i dati JSON di input.

-i, --instance

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

--output

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

Esempi

Creare un'applicazione per il dominio DNS_DOMAIN_ID.

ibmcloud cis range-app-create DNS_DOMAIN_ID --json '{"protocol":"tcp/22", "dns":{"type":"CNAME","name":"ssh.example.com"}, "origin_direct":["tcp://1.2.3.4:22"], "proxy_protocol":"off", "ip_firewall":true, "tls":"full", "edge_ips":{"type":"dynamic", "connectivity":"all"}, "traffic_type":"direct"}'