Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine Zugriffsanwendung für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Listen Sie alle Zugriffsanwendungen für die Domäne 31984fea73a15b45779fa0df4ef62f9b auf.

ibmcloud cis access-apps DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeigen Sie die Details der Zugriffsanwendung a5836c2a7ea72d2e225890caea70ae32 an.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

--name

Der Name der Anwendung. Erforderlich.

--domain

Die Domäne und der Pfad, die von Access blockiert werden. Erforderlich.

--session-duration

Legt fest, wie lange die für diese Anwendung ausgestellten Token gültig sind. Gültige Werte sind 30m, 6h, 12h, 24h, 168h und 730h.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie die Zugriffsanwendung a5836c2a7ea72d2e225890caea70ae32.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie die Zugriffsanwendung a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--name

Der Name des Zertifikats. Erforderlich.

--ca-cert-file

Die Root-CA-Datei für die Zertifikate. Erforderlich.

--associated-hostnames

Die Hostnamen, für die dieses Zertifikat angefordert wird.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Erstellen Sie ein Zugriffszertifikat für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Listen Sie alle Zugriffszertifikate für die Domäne 31984fea73a15b45779fa0df4ef62f9b auf.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_CERTIFICATE_ID

Die ID des Zugriffszertifikats. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeigen Sie Details zum Zugriffszertifikat a5836c2a7ea72d2e225890caea70ae32 an.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_CERTIFICATE_ID

Die ID des Zugriffszertifikats. Erforderlich.

--name

Der Name des Zertifikats. Erforderlich.

--associated-hostnames

Die Hostnamen, für die dieses Zertifikat angefordert wird. Erforderlich.

Die zugeordneten Hostnamen werden zurückgesetzt, wenn sie nicht von associated-hostnames angegeben wurden.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie das Zugriffszertifikat unter a5836c2a7ea72d2e225890caea70ae32.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_CERTIFICATE_ID

Die ID des Zugriffszertifikats. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie das Zugriffszertifikat „ a5836c2a7ea72d2e225890caea70ae32 “.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Ruft die Einstellungen der Zugriffszertifikate für die Domäne 31984fea73a15b45779fa0df4ef62f9b ab.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-f, --feature

Funktion der Zertifikatseinstellungen. Die gültigen Werte sind im Folgenden aufgelistet:

client_certificate_forwarding

Die Nutzdaten des Client-Zertifikats und dessen „ SHA256 “-Signatur werden über die Header „ CF-Client-Cert-DER_BASE64 “ und „ CF-Client-Cert-SHA256 “ an die Ursprungsserver weitergeleitet.

-v, --value

Der Wert, der für die Funktion für Zertifikate festgelegt wurde.

client_certificate_forwarding

Geben Sie den Hostnamen an, um das Client-Zertifikat weiterzuleiten oder nicht. Beispiel: -v host1=on,host2=on,host3=off.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisiert die Einstellungen der Zugriffszertifikate für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

--name

Der Name der Richtlinie. Erforderlich.

--decision

Legt fest, welche Maßnahme Access ergreift, wenn die Richtlinie auf den Benutzer zutrifft. Ein gültiger Wert ist „ non_identity “. Erforderlich.

--include

Die enthaltene Regel der Richtlinie. Gültige Werte sind certificate und common_name. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine Zugriffsrichtlinie für die Anwendung „ a5836c2a7ea72d2e225890caea70ae32 “.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Listen Sie alle Zugriffsrichtlinien für die Zugriffsanwendung a5836c2a7ea72d2e225890caea70ae32 auf.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

ACCESS_POLICY_ID

Die ID der Zugriffsrichtlinie. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeigen Sie die Details der Zugriffsrichtlinie a5836c2a7ea72d2e225890caea70ae32 an.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

ACCESS_APPLICATION_ID

Die ID der Zugriffsanwendung. Erforderlich.

ACCESS_POLICY_ID

Die ID der Zugriffsrichtlinie. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie die Zugriffsrichtlinie 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--all

Alle Dateien im Cache werden gelöscht. Diese Option ist gegenseitig ausschließend mit --file.

--file

Eine oder mehrere Dateien durch die Angabe von URLs selektiv entfernen. Diese Option ist gegenseitig ausschließend mit --all.

--tag

Eine oder mehrere Dateien durch den zugeordneten Cache-Tag selektiv entfernen. Diese Option ist gegenseitig ausschließend mit --all. Nur für Enterprise-Tarife

--host

Eine oder mehrere Dateien durch die Angabe des Hosts selektiv entfernen. Diese Option ist gegenseitig ausschließend mit --all. Nur für Enterprise-Tarife

--prefix

Eine oder mehrere Dateien durch ein Präfix selektiv entfernen. Diese Option ist gegenseitig ausschließend mit --all. Nur für Enterprise-Tarife

-f, --force

Alle Dateien im Cache werden ohne Anforderung einer Bestätigung gelöscht.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Bereinigen Sie alle im Cache gespeicherte Assetdateien für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Rufen Sie die Cacheeinstellungen für die Domäne 31984fea73a15b45779fa0df4ef62f9b ab.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--caching-level

Geben Sie an, unter welchen URL Bedingungen Sie zwischengespeicherte Assets an den Benutzer ausliefern möchten. Gültige Werte sind no-query-string, query-string-independent, und query-string-dependent.

• no-query-string ressourcen aus dem Cache werden nur geliefert, wenn keine Abfragezeichenfolge vorhanden ist.
• query-string-independent: Stellt allen Nutzern unabhängig vom Abfrageparameter dieselbe Ressource bereit.
• query-string-dependent: Liefert bei jeder Änderung der Abfragezeichenfolge eine andere Ressource.

--browser-expiration

Geben Sie an, wie lange der Browser die zwischengespeicherten Dateien aufbewahren soll.

• Gültige Werte sind respect-existing-header, 30s, 1M, 5M, 20M, 30M, 1h, 2h, 4h, 8h, 16h, 1d 3d, 8d, 16d, 1m, 6m und 1y.
• 30s, 1M, 5M und 20M sind nur für Instanzen mit einem Enterprise- oder Security-Tarif verfügbar.
• 30s bedeutet „ 30 seconds “.
• 30M bedeutet „ 30 minutes “.
• 1h bedeutet „ 1 hour “.
• 1d bedeutet „ 1 day “.
• 1m bedeutet „ 1 month “.
• 1y bedeutet „ 1 year “.

--development-mod

Umgeht alle Edge-Caches und sendet den Datenverkehr an die Ursprungsserver.

--serve-stale-content

Den Nutzern weiterhin zwischengespeicherte Inhalte bereitstellen, wenn die Ursprungsserver offline sind, auch wenn die Inhalte bereits abgelaufen sind.

--query-string-sort: Im Cache behandelt CIS Dateien mit denselben Abfrageparametern als dieselbe Datei, unabhängig von der Reihenfolge der Abfrageparameter.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie die Cacheeinstellungen für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiel

ibmcloud cis custom-lists lists

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiel

ibmcloud cis custom-lists list LIST_ID --output json

Befehlsoptionen

--kind

Art der benutzerdefinierten Liste. Gültige Werte sind ip, asn, und hostname.

--name

Der Name der Liste.

--description

Beschreibung der Liste.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer benutzerdefinierten Liste verwendet wird.

Die Pflichtfelder in den JSON-Daten sind:

kind: Art der benutzerdefinierten Liste. Gültige Werte sind ip, asn, und hostname.

name: Der Name der Liste.

Das fakultative Feld ist:

"description": Beschreibung der Liste.

JSON-Beispieldaten:

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

Beispiele

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

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

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

--description

Beschreiben Sie die Liste kurz.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer benutzerdefinierten Liste verwendet wird.

Das fakultative Feld ist:

"description": Eine kurze Beschreibung der Liste.

JSON-Beispieldaten:

  {
    "description": "string"
  }

Beispiele

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

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

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

-f, --force

Versuch, eine benutzerdefinierte Liste zu löschen, ohne eine Bestätigung abzufragen.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiel

ibmcloud cis custom-lists list-delete LIST_ID

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiel

ibmcloud cis custom-lists items LIST_ID

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

ITEM_ID

Die ID des benutzerdefinierten Listenelements.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiel

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

--asn

Der ASN-Wert.

--ip

Die Adresse von „ IPv4 “.

--hostname

Der Hostname.

--comment

Einen kurzen Kommentar zu diesem Punkt abzugeben.

-i, --instance

Instanzname oder ID. Wenn Instanz oder ID nicht gesetzt sind, wird die Kontextinstanz verwendet, die durch cis instance-set INSTANCE angegeben ist.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer benutzerdefinierten Liste verwendet wird.

Die Pflichtfelder in den JSON-Daten sind:

items liste der zu erstellenden benutzerdefinierten Listenelemente.

asn die ASN.

hostname: Der Hostname.

ip: Die Adresse IPv4.

comment: Einen kurzen Kommentar zu diesem Punkt abgeben.

JSON-Beispieldaten:

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

Befehlsbeispiele

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

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

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer benutzerdefinierten Liste verwendet wird.

Die Pflichtfelder in den JSON-Daten sind:

items liste der zu erstellenden benutzerdefinierten Listenelemente.

asn aSN: Der ASN-Wert.

hostname: Der Hostname.

ip: Die Adresse IPv4.

comment: Einen kurzen Kommentar zu diesem Punkt abgeben.

JSON-Beispieldaten:

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

-f, --force

Versuch, eine benutzerdefinierte Liste zu löschen, ohne eine Bestätigung abzufragen.

--output value

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

-i, --instance

Instanzname oder ID. Wenn der Instanzwert oder die ID nicht festgelegt ist, wird die Kontextinstanz verwendet, die durch cis instance-set INSTANCE angegeben ist.

Beispiel

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

Befehlsoptionen

LIST_ID

Die ID der benutzerdefinierten Liste.

--item-id

CUSTOM_LIST_ITEM_ID ist die ID des benutzerdefinierten Listenelements.

-f, --force

Versuch, eine benutzerdefinierte Liste zu löschen, ohne eine Bestätigung abzufragen.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer benutzerdefinierten Liste verwendet wird.

Die Pflichtfelder in den JSON-Daten sind:

items liste der zu löschenden benutzerdefinierten Listenelemente nach ID.

id iD: Eindeutige ID des benutzerdefinierten Listenelements.

JSON-Beispieldaten:

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

Beispiele

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

Befehlsoptionen

OPERATION_ID

Die ID des benutzerdefinierten Listenvorgangs.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiel

ibmcloud cis custom-lists operation OPERATION_ID --output json

Befehlsoptionen

PAGE_ID

Der Name des Typs der angepassten Seite. Gültige Werte sind basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Erforderlich.

PAGE_URL

Eine URL, die der angepassten Seite zugeordnet ist. Beispiel: http://www.example.com/example.html. Der Wert default bedeutet, dass die Standardseite verwendet werden soll. Erforderlich.

-d, --domain

Die ID der DNS-Domäne.

-i,- --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie die Seite basic_challenge für die Domäne 31984fea73a15b45779fa0df4ef62f9b.

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

Befehlsoptionen

PAGE_ID

Der Name des Typs der angepassten Seite. Gültige Werte sind basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors und 500_errors. Erforderlich.

-d, --domain

Die ID der DNS-Domäne.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Rufen Sie die Seite basic_challenge für die Domäne 31984fea73a15b45779fa0df4ef62f9b ab.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Befehlsoptionen

-d, --domain

Die ID der DNS-Domäne.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Vorhandene benutzerdefinierte Seiten für die Domain DNS_DOMAIN_ID auflisten.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--name

Der Name des DNS-Datensatzes.

--type

Der Typ des DNS-Datensatzes.

--content

Der Inhalt des DNS-Datensatzes.

--ttl

Lebensdauer des DNS-Datensatzes. Der Wert 1 steht für „ automatic “. Der Standardwert ist 1.

--proxied

Steuert, ob der Datenverkehr über die Sicherheits- und Leistungsfunktionen in CIS fließt. CIS Leitet den Datenverkehr nur für Einträge unter A, AAAA und CNAME weiter. Gültige Werte: true und false.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines DNS-Eintrags verwendet wird. Unterstützte DNS-Datensatztypen sind: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Für die Typen A, AAAA, CNAME, NS, TXT:
  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Die optionalen Felder sind „ ttl “ und „ proxied “:
    • proxied Steuert, ob der Datenverkehr über die Sicherheits- und Leistungsfunktionen in CIS fließt. CIS Leitet nur den Datenverkehr für Einträge unter A, AAAA und CNAME weiter.

JSON-Beispieldaten:

{
   "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"
}

• Für Typ PTR:
  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Das optionale Feld ist ttl.

JSON-Beispieldaten:

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

• Für Typ MX:
  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Die optionalen Felder lauten „ ttl “ und „ priority “.

JSON-Beispieldaten:

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

• Für Typ LOC:
  • Die erforderlichen Felder in JSON-Daten sind name, type, data:
    • data:
      • lat_degrees: Breitengrade.
      • lat_minutes: Breitenminuten
      • lat_seconds: Sekunden des Breitengrades.
      • lat_direction: Breitengrad und Richtung.
      • long_degrees: Längengrade.
      • long_minutes: Längenminuten.
      • long_seconds: Längengradsekunden.
      • long_direction: Längengradrichtung.
      • altitude: Höhe des Standorts in Metern.
      • size: Größe des Standorts in Metern.
      • precision_horz: Horizontale Ortungsgenauigkeit.
      • precision_vert: Vertikale Ortungsgenauigkeit.
    • Das optionale Feld ist ttl.

JSON-Beispieldaten:

{
   "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
   }
}

• Für Typ SRV:
  • Die erforderlichen Felder in JSON-Daten sind type, data:
    • data: - service: Ein Diensttyp, dem ein Unterstrich vorangestellt ist. - proto: Ein gültiges Protokoll. - priority: Priorität. - weight: Das Rekordgewicht. - port: Der Port des Dienstes. - target: Ein gültiger Hostname.
    • Das optionale Feld ist ttl.

JSON-Beispieldaten:

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

• Für den Typ CAA:
  • Die Pflichtfelder in den JSON-Daten sind „ name “, „ type “ und „ data “.
  • Das optionale Feld ist ttl.

JSON-Beispieldaten:

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

-s, --json-str

Veraltet. Die zum Beschreiben eines DNS-Datensatzes verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen DNS-Eintrag für die Domain 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"

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

DNS_RECORD_ID

Die ID des DNS-Eintrags. Erforderlich.

--name

Der Name des DNS-Datensatzes.

--type

Der Typ des DNS-Datensatzes.

--content

Der Inhalt des DNS-Datensatzes.

--ttl

Lebensdauer des DNS-Datensatzes. Der Wert 1 steht für „ automatic “. Der Standardwert ist 1.

--proxied

Steuert, ob der Datenverkehr über die Sicherheits- und Leistungsfunktionen in CIS fließt. CIS Leitet den Datenverkehr nur für Einträge unter A, AAAA und CNAME weiter. Gültige Werte: true und false.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines DNS-Eintrags verwendet wird. Unterstützte DNS-Datensatztypen sind: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Für die Typen A, AAAA, CNAME, NS, TXT:
  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Die optionalen Felder sind „ ttl “ und „ proxied “:
    • proxied Steuert, ob der Datenverkehr über die Sicherheits- und Leistungsfunktionen in CIS fließt. CIS Leitet nur den Datenverkehr für Einträge unter A, AAAA und CNAME weiter.

JSON-Beispieldaten:

{
   "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"
}

• Für Typ PTR:
  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Das optionale Feld ist ttl.

JSON-Beispieldaten:

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

• Für Typ MX:

  • Die erforderlichen Felder in JSON-Daten sind name, type, content.
  • Die optionalen Felder lauten „ ttl “ und „ priority “.

  JSON-Beispieldaten:

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

• Für Typ LOC:

  • Die erforderlichen Felder in JSON-Daten sind name, type, data:
    • data:
      • lat_degrees: Breitengrade.
      • lat_minutes: Breitenminuten
      • lat_seconds: Sekunden des Breitengrades.
      • lat_direction: Breitengrad und Richtung.
      • long_degrees: Längengrade.
      • long_minutes: Längenminuten.
      • long_seconds: Längengradsekunden.
      • long_direction: Längengradrichtung.
      • altitude: Höhe des Standorts in Metern.
      • size: Größe des Standorts in Metern.
      • precision_horz: Horizontale Ortungsgenauigkeit.
      • precision_vert: Vertikale Ortungsgenauigkeit.
  • Das optionale Feld ist ttl.

  JSON-Beispieldaten:

{
   "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
   }
}

• Für Typ SRV:

  • Die erforderlichen Felder in JSON-Daten sind type, data:
    • data:
      • service: Ein Diensttyp, dem ein Unterstrich vorangestellt ist.
      • proto: Ein gültiges Protokoll.
      • priority: Priorität.
      • weight: Das Rekordgewicht.
      • port: Der Port des Dienstes.
      • target: Ein gültiger Hostname.
  • Das optionale Feld ist ttl.

  JSON-Beispieldaten:

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

• Für Typ CAA:

  • Die Pflichtfelder in den JSON-Daten sind „ name “, „ type “, data
  • Das optionale Feld ist ttl.

  JSON-Beispieldaten:

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

-s, --json-str

Veraltet. Die zum Beschreiben eines DNS-Datensatzes verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie einen DNS-Eintrag in der Domain 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"

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

DNS_RECORD_ID

Die ID des DNS-Eintrags. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Holen Sie sich DNS-Eintragsdetails in der Domäne DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

DNS_RECORD_ID

Die ID des DNS-Eintrags. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie einen DNS-Eintrag in der Domain DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--type

Der Typ der anzuzeigenden DNS-Datensätze.

--name

Der Wert des Namensfelds, nach dem gefiltert werden soll.

--content

Der Wert des Inhaltsfelds, nach dem gefiltert werden soll.

--page

Die Seitenzahl der paginierten Ergebnisse.

--per_page

Die maximale Anzahl der DNS-Datensätze pro Seite.

--order

Feld, nach dem die Liste der DNS-Einträge sortiert werden soll. Gültige Werte sind type, name, content, ttl und proxied.

--direction

Reihenfolge, in der die Ergebnisse sortiert werden sollen (aufsteigend oder absteigend). Gültige Werte sind asc und desc.

--match

Ob alle oder mindestens ein Suchparameter übereinstimmen soll. Gültige Werte sind any und all.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste aller DNS-Einträge der Domain DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--file

Zu importierende BIND-Konfiguration Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Importieren Sie die BIND-Konfiguration in die Domäne DNS_DOMAIN_ID.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--file

Die BIND-Konfigurationsdatei, in der exportierte DNS-Einträge gespeichert werden.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

BIND-Konfiguration für die Domain DNS_DOMAIN_ID exportieren.

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

Befehlsoptionen

type

Geben Sie die Domänentypkonfiguration an. Gültige Werte sind full und partial (Standardwert full).

• full: Eine vollständige Zone bedeutet, dass das DNS gehostet wird.
• partial: Eine Teilzone setzt eine CNAME-Konfiguration der Domain voraus.

jump-start

Automatisch versuchen, vorhandene DNS-Datensätze abzurufen.

DNS_DOMAIN_NAME

Der FQDN der DNS-Domäne. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Fügen Sie eine Domain „ DNS_DOMAIN_NAME “ hinzu.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Setzen Sie die angegebene Domäne fort.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Halten Sie die angegebene Domäne an.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeigen Sie die Details der angegebenen Domäne an.

ibmcloud cis domain DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Entfernen Sie die angegebene Domäne.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste der Domänen für die Serviceinstanz.

ibmcloud cis domains

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Führen Sie die Aktivierungsüberprüfung für die angegebene Domäne aus.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-g, --group

Zeigt Funktionen in derselben Gruppe an. Gültige Werte für „ group “ sind „ all “, „ domain “, „ reliability “, „ performance “ und „ security “. Diese Option ist gegenseitig ausschließend mit -f, --feature.

-f, --feature

Die Funktion der zu überprüfenden Domäneneinstellungen. Diese Option ist gegenseitig ausschließend mit g, --group. Folgende Werte sind gültig:

• always_use_https: Alle Anfragen mit dem Schema http sollen an https umgeleitet werden. Diese Einstellung gilt für alle „ HTTP “-Anfragen an die Domain.
• automatic_https_rewrites: Helfen Sie mit, gemischte Inhalte zu beheben, indem Sie http in https ändern – und zwar für alle Ressourcen oder Links auf Ihrer Website, die mit HTTPS bereitgestellt werden können.
• bot_management: Erkennen und minimieren Sie Bot-Traffic auf Ihrer Domain.
• brotli: Wenn der Client, der eine Datei anfordert, den Brotli-Komprimierungsalgorithmus unterstützt, liefert CIS eine mit Brotli komprimierte Version der Datei aus.
• browser_check: Überprüfen Sie die „ HTTP “-Header aus den Browsern Ihrer Besucher auf potenzielle Bedrohungen. Wenn eine Bedrohung gefunden wird, wird eine Blockseite angezeigt.
• challenge_ttl: Legen Sie fest, wie lange ein Besucher mit einer schlechten IP-Reputation nach Abschluss einer Sicherheitsüberprüfung Zugriff auf Ihre Website erhalten darf.
• ciphers: Eine Zulassungsliste mit Verschlüsselungsalgorithmen für die Beendigung von „ TLS “ im Format „ BoringSSL “. Dieser Befehl listet die von Kunden zugelassenen Chiffren auf. Wenn keine Verschlüsselungsalgorithmen auf der Whitelist stehen, ist die Liste leer und es werden die Standardverschlüsselungsalgorithmen verwendet. Eine Liste der Standard-Chiffren finden Sie unter Edge-Chiffre-Sammlungen und Origin-Chiffre-Sammlungen.
• cname_flattening: Dem CNAME-Eintrag bis zu seinem Ziel folgen und anstelle des CNAME-Eintrags die entsprechende IP-Adresse zurückgeben. Standardmäßig wird nur der CNAME in der Stammebene Ihrer Domain abgeflacht.
• domain_hold: Durch Domain-Sperren wird verhindert, dass Teams in Ihrer Organisation Domains hinzufügen, die bereits in einem anderen Konto aktiv sind. Nur für Enterprise-Tarife
• email_obfuscation verschlüsseln Sie die E-Mail-Adressen auf Ihrer Webseite vor Bots, während sie für Menschen sichtbar bleiben.
• opportunistic_onion: Ermöglichen Sie legitimen Nutzern des Tor-Browsers den Zugriff auf Ihre Websites.
• hotlink_protection: Schützen Sie Ihre Bilder vor externen Verlinkungen.
• http2: Beschleunigen Sie Ihre Website mit HTTP/2.
• http3: Beschleunigen Sie Ihre Website mit „ HTTP/3 “.
• image_load_optimization: Veraltet. Verbessert die Ladezeit für Seiten, die Abbildungen enthalten, auf mobilen Geräten mit langsamen Netzverbindungen.
• image_size_optimization: Verbessern Sie die Ladezeit von Bildern, indem Sie die auf Ihrer Domain gehosteten Bilder optimieren.
• image_resizing größenanpassung, Konvertierung und Optimierung von Bildern, die über das Netzwerk CIS bereitgestellt werden, auf Abruf.
• ip_geolocation: Geben Sie bei allen Anfragen an Ihre Website die Ländervorwahl des Standorts des Besuchers an.
• ipv6: Aktivieren Sie die Unterstützung für „ IPv6 “ und das Gateway.
• max_upload: Die Anzahl der Datenbesucher, die in einer einzigen Anfrage Daten auf Ihre Website hochladen können.
• min_tls_version: Es dürfen nur HTTPS-Verbindungen von Besuchern zugelassen werden, die die ausgewählte TLS-Protokollversion oder eine neuere Version unterstützen.
• minify: Reduzieren Sie die Dateigröße des Quellcodes auf Ihrer Website.
• mobile_redirect: Leiten Sie Besucher, die mobile Geräte nutzen, auf eine für Mobilgeräte optimierte Website weiter.
• opportunistic_encryption: Dank der opportunistischen Verschlüsselung können Browser von der verbesserten Leistung von „ HTTP/2 “ profitieren, indem sie darüber informiert werden, dass Ihre Website über eine verschlüsselte Verbindung erreichbar ist.
• origin_error_page_pass_thru: Wenn die Ursprungs-Fehlerseite auf On eingestellt ist, leitet CIS die 502- und 504-Fehlerseiten direkt vom Ursprungsserver weiter. Nur für Enterprise-Tarife
• origin_max_http_version: Stellen Sie die Version von „ HTTP “ auf „Origin“ ein.
• origin_post_quantum_encryption: Weist „ CIS “ an, bei der Verbindung mit Ihrem Ursprungsserver Post-Quantum-Algorithmen (PQ) zur Schlüsselvereinbarung zu verwenden.
• prefetch_preload: CIS ruft alle URLs vorab ab, die im Prefetch-Header „ HTTP “ enthalten sind. Nur für Enterprise-Tarife
• pseudo_ipv4: Fügt den Anfragen einen „ IPv4 “-Header hinzu, wenn ein Client „ IPv6 “ verwendet, der Server jedoch nur „ IPv4 “ unterstützt.
• response_buffering: Die Zwischenspeicherung von Antworten des Ursprungsservers aktivieren oder deaktivieren. Nur für Enterprise-Tarife
• script_load_optimization: Die Darstellungszeit für Seiten, die JavaScript enthalten, verbessern.
• security_header: Setzen Sie eine Web-Sicherheitsrichtlinie für Ihre Website durch.
• security_level: Wählen Sie das für Ihre Website geeignete Sicherheitsprofil aus.
• server_side_exclude: Bestimmte Inhalte automatisch vor verdächtigen Besuchern verbergen.
• tls_client_auth: Das Client-Zertifikat „ TLS “ wurde zur Authentifizierung beim Abruf vom Ursprungsserver vorgelegt. Nur für Enterprise-Tarife
• true_client_ip_header: „ CIS “ übermittelt die IP-Adresse des Nutzers im Header „True-Client-IP“. Nur für Enterprise-Tarife
• waf: Eine Web Application Firewall (WAF) blockiert Anfragen, die schädliche Inhalte enthalten.
• websockets: Erlauben Sie WebSockets-Verbindungen zu Ihrem Ursprungsserver.
• proxy_read_timeout: Maximale Zeitspanne zwischen zwei Lesevorgängen vom Ursprung. Nur für Enterprise-Tarife
• url_normalization: Die URLs eingehender Anfragen ändern.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

ciphers-Einstellungen für die Domain DNS_DOMAIN_ID abrufen.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-f, --feature

Funktion zur Aktualisierung der Domänen-Einstellungen. Erforderlich. Die gültigen Werte sind im Folgenden aufgelistet:

• always_use_https: Alle Anfragen mit dem Schema http sollen an https umgeleitet werden. Diese Weiterleitung gilt für alle HTTP-Anfragen an die Domain.
• automatic_https_rewrites: Helfen Sie mit, gemischte Inhalte zu beheben, indem Sie http in https ändern – und zwar für alle Ressourcen oder Links auf Ihrer Website, die mit HTTPS bereitgestellt werden können.
• bot_management: Erkennen und minimieren Sie Bot-Traffic auf Ihrer Domain.
• brotli: Wenn der Client, der eine Datei anfordert, den Brotli-Komprimierungsalgorithmus unterstützt, liefert CIS eine mit Brotli komprimierte Version der Datei aus.
• browser_check: Überprüfen Sie die „ HTTP “-Header aus den Browsern Ihrer Besucher auf potenzielle Bedrohungen. Wenn eine Bedrohung gefunden wird, wird eine Blockseite angezeigt.
• challenge_ttl: Legen Sie fest, wie lange ein Besucher mit einer schlechten IP-Reputation nach Abschluss einer Sicherheitsüberprüfung Zugriff auf Ihre Website erhalten darf.
• ciphers: Eine Liste von Chiffren für die TLS Terminierung. Diese Verschlüsselungen müssen im 'BoringSSL'-Format vorliegen.
• cname_flattening: Dem CNAME-Eintrag bis zu seinem Ziel folgen und anstelle des CNAME-Eintrags die entsprechende IP-Adresse zurückgeben. Vereinfachen Sie standardmäßig CNAME im Standardverzeichnis Ihrer Domäne.
• domain_hold: Durch Domain-Sperren wird verhindert, dass Teams in Ihrer Organisation Domains hinzufügen, die bereits in einem anderen Konto aktiv sind. Nur für Enterprise-Tarife
• email_obfuscation verschlüsseln Sie die E-Mail-Adressen auf Ihrer Webseite vor Bots, während sie für Menschen sichtbar bleiben.
• opportunistic_onion: Ermöglichen Sie legitimen Nutzern des Tor-Browsers den Zugriff auf Ihre Websites.
• hotlink_protection: Schützen Sie Ihre Bilder vor externen Verlinkungen.
• http2: Beschleunigen Sie Ihre Website mit HTTP/2.
• http3: Beschleunigen Sie Ihre Website mit „ HTTP/3 “.
• image_load_optimization: Veraltet. Verbessert die Ladezeit für Seiten, die Abbildungen enthalten, auf mobilen Geräten mit langsamen Netzverbindungen.
• image_size_optimization: Verbessern Sie die Ladezeit von Bildern, indem Sie die auf Ihrer Domain gehosteten Bilder optimieren.
• image_resizing größenanpassung, Konvertierung und Optimierung von Bildern, die über das Netzwerk CIS bereitgestellt werden, auf Abruf.
• ip_geolocation: Geben Sie bei allen Anfragen an Ihre Website die Ländervorwahl des Standorts des Besuchers an.
• ipv6: Aktivieren Sie die Unterstützung für „ IPv6 “ und das Gateway.
• max_upload: Die Anzahl der Datenbesucher, die in einer einzigen Anfrage Daten auf Ihre Website hochladen können.
• min_tls_version: Es dürfen nur HTTPS-Verbindungen von Besuchern zugelassen werden, die die ausgewählte TLS-Protokollversion oder eine neuere Version unterstützen.
• minify: Reduzieren Sie die Dateigröße des Quellcodes auf Ihrer Website.
• mobile_redirect: Leiten Sie Besucher, die mobile Geräte nutzen, auf eine für Mobilgeräte optimierte Website weiter.
• opportunistic_encryption: Dank der opportunistischen Verschlüsselung können Browser von der verbesserten Leistung von „ HTTP/2 “ profitieren, indem sie darüber informiert werden, dass Ihre Website über eine verschlüsselte Verbindung erreichbar ist.
• origin_error_page_pass_thru: Wenn die Option „Origin Error Page“ auf „ On “ gesetzt ist, leitet CIS die 502- und 504-Fehlerseiten direkt vom Ursprungsserver weiter. Nur für Enterprise-Tarife
• origin_max_http_version: Stellen Sie die Version von „ HTTP “ auf „Origin“ ein.
• origin_post_quantum_encryption: Weist „ CIS “ an, bei der Verbindung mit Ihrem Ursprungsserver Post-Quantum-Algorithmen (PQ) zur Schlüsselvereinbarung zu verwenden.
• prefetch_preload: CIS ruft alle URLs vorab ab, die im Prefetch-Header „ HTTP “ enthalten sind. Nur für Enterprise-Tarife
• pseudo_ipv4: Fügt den Anfragen einen „ IPv4 “-Header hinzu, wenn ein Client „ IPv6 “ verwendet, der Server jedoch nur „ IPv4 “ unterstützt.
• response_buffering: Die Zwischenspeicherung von Antworten des Ursprungsservers aktivieren oder deaktivieren. Nur für Enterprise-Tarife
• script_load_optimization: Die Darstellungszeit für Seiten, die JavaScript enthalten, verbessern.
• security_header: Setzen Sie eine Web-Sicherheitsrichtlinie für Ihre Website durch.
• security_level: Wählen Sie das für Ihre Website geeignete Sicherheitsprofil aus.
• server_side_exclude: Bestimmte Inhalte automatisch vor verdächtigen Besuchern verbergen.
• tls_client_auth: Das Client-Zertifikat „ TLS “ wurde zur Authentifizierung beim Abruf vom Ursprungsserver vorgelegt. Nur für Enterprise-Tarife
• true_client_ip_header: „ CIS “ übermittelt die IP-Adresse des Nutzers im Header „True-Client-IP“. Nur für Enterprise-Tarife
• waf: Eine Web Application Firewall (WAF) blockiert Anfragen, die schädliche Inhalte enthalten.
• websockets: Erlauben Sie WebSockets-Verbindungen zu Ihrem Ursprungsserver.
• proxy_read_timeout: Maximale Zeitspanne zwischen zwei Lesevorgängen vom Ursprung.
• url_normalization: Die URLs eingehender Anfragen ändern.

-v, --value

Der Wert, der für die Funktion für die Domäne festgelegt wurde. Erforderlich.

• Gültige Werte für „ always_use_https “ sind „ on “ und „ off “.

• Gültige Werte für „ automatic_https_rewrites “ sind „ on “ und „ off “.

• Gültige Werte für bot_management sind "use_latest_model", "fight_mode", "session_score", "enable_js". Beispiel: -v fight_mode=true,session_score=true

  • use_latest_model: Ob die neueste Modellversion aktiviert werden soll. Gültige Werte für „ use_latest_model “ sind „ true “ und „ false “.
  • fight_mode ob der Kampfmodus aktiviert werden soll. Gültige Werte für „ fight_mode “ sind „ true “ und „ false “.
  • session_score ob die Sitzungsbewertung aktiviert werden soll. Gültige Werte für „ session_score “ sind „ true “ und „ false “.
  • enable_js: Ob die Erkennung von JavaScript aktiviert werden soll. Gültige Werte für „ enable_js “ sind „ true “ und „ false “.

• Gültige Werte für „ browser_check “ sind „ on “ und „ off “.

• Gültige Werte für challenge_ttl sind 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• Gültige Werte für cname_flattening sind flatten_at_root, flatten_all.

  • flatten_at_root: CNAME in der Stammdomain vereinfachen. Dieser Wert ist der Standardwert.
  • flatten_all: Alle CNAME-Einträge unter Ihrer Domain zusammenführen.

• Gültige Werte für domain_hold sind hold, include_subdomains und hold_after.

  • hold ob das Halten der Domäne aktiviert werden soll. Gültige Werte für „ hold “ sind „ true “ und „ false “.
  • include_subdomains: Ob die Domain-Hold-Funktion aktiviert werden soll. Gültige Werte für „ include_subdomains “ sind „ true “ und „ false “.
  • hold_after: Wenn „ hold_after “ angegeben wird, wird die Sperre vorübergehend deaktiviert und dann vom System zum angegebenen Zeitpunkt automatisch wieder aktiviert.

  Um die Domain und die Subdomains zu aktivieren, rufen Sie folgende Seite auf: -v hold=true,include_subdomains=true. So deaktivieren Sie die Domain-Sperre: -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• Gültige Werte für hotlink_protection sind on, off.

• Gültige Werte für email_obfuscation sind on, off.

• Gültige Werte für opportunistic_onion sind on, off.

• Gültige Werte für http2 sind on, off.

• Gültige Werte für http3 sind on, off.

• Veraltet. Gültige Werte für image_load_optimization sind on, off.

• Gültige Werte für image_resizing sind on, off.

• Gültige Werte für image_size_optimization sind off, lossless, lossy.

  • off: Inaktiviert die Optimierung der Bildgröße.
  • lossless: Verkleinern Sie Bilddateien, ohne die Bildqualität zu beeinträchtigen.
  • lossy: Die Dateigröße von JPEG-Bildern wird durch eine verlustbehaftete Komprimierung reduziert, was zu einer Verschlechterung der Bildqualität führen kann.

• Gültige Werte für ip_geolocation sind on, off.

• Gültige Werte für ipv6 sind on, off.

• Gültige Werte (in MB) für max_upload sind: 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Nur für Enterprise-Tarife

• Gültige Werte für min_tls_version sind 1.0, 1.1, 1.2, 1,3.

• Gültige Werte für minify sind css, html, js. Zum Beispiel -v css=on,html=off,js=on

  • css: Alle CSS-Dateien Ihrer Website automatisch minimieren. Gültige Werte für css sind on, off.
  • html: Alle HTML-Dateien Ihrer Website automatisch minimieren. Gültige Werte für html sind on, off.
  • js: Alle JS-Dateien Ihrer Website automatisch minimieren. Gültige Werte für js sind on, off.

• Gültige Werte für mobile_redirect sind status, mobile_subdomain, strip_uri. Beispiel: -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Ob die Umleitung auf mobile Geräte aktiviert ist. Gültige Werte für „ status “ sind „ on “ und „ off “.
  • mobile_subdomain: Zu welchem Subdomain-Präfix sollen Besucher auf Mobilgeräten weitergeleitet werden (die Subdomain muss vorhanden sein)?
  • strip_uri: Soll der aktuelle Seitenpfad verworfen und eine Weiterleitung zur Stammseite der mobilen Subdomain URL erfolgen? Gültige Werte für strip_uri sind true, false.

• Gültige Werte für opportunistic_encryption sind on, off.

• Gültige Werte für origin_error_page_pass_thru sind 1, 2.

• Gültige Werte für origin_max_http_version sind supported, preferred, off.

  • supported: Post-Quantum-Algorithmen werden zwar beworben, kommen jedoch nur zum Einsatz, wenn dies vom Absender gewünscht wird.
  • preferred: „Preferred“ weist „ CIS “ an, bei Gelegenheit bereits in der ersten Nachricht an den Ursprung einen Post-Quantum-Schlüsselaustausch (PQ) zu senden (für schnellste Verbindungen, wenn der Ursprung PQ unterstützt und bevorzugt).
  • off: Post-Quanten-Algorithmen werden nicht beworben.

• Gültige Werte für origin_post_quantum_encryption sind on, off.

• Gültige Werte für brotli sind on, off.

• Gültige Werte für prefetch_preload sind on, off.

• Gültige Werte für pseudo_ipv4 sind off, add_header, overwrite_header.

  • off: Inaktiviert die Pseudo-IPv4-Adresse.
  • add_header: Fügen Sie lediglich einen zusätzlichen „ Cf-Pseudo-IPv4 “-Header hinzu.
  • overwrite_header: Überschreibt die vorhandenen "Cf-Connecting-IP"- und "X-Forwarded-For"-Header mit einer Pseudo-IPv4-Adresse.

• Gültige Werte für response_buffering sind on, off.

• Gültige Werte für script_load_optimization sind on, off.

• Gültige Werte für security_header sind enabled, max_age, include_subdomains, preload, nosniff. Zum Beispiel -v enabled=true,max_age=100, include_subdomains=true, preload=true, nosniff=true

  • enabled security_header: Ob der security_header aktiviert ist. Gültige Werte für enabled sind true, false.
  • max_age: Geben Sie die Dauer (in Sekunden) an, für die Security-Header in Browsern zwischengespeichert werden.
  • include_subdomains: Jede untergeordnete Domain übernimmt denselben security_header. Gültige Werte für include_subdomains sind true, false.
  • preload: Ob Browsern das Vorladen der „security_header“-Konfiguration gestattet werden soll. Gültige Werte für enabled sind true, false.
  • nosniff: Ob der Header „ X-Content-Type-Options: nosniff “ gesendet werden soll. Gültige Werte für nosniff sind true, false.

• Gültige Werte für server_level sind off, essentially_off, low, medium, high, under_attack.

• Gültige Werte für server_side_exclude sind on, off.

• Gültige Werte für tls_client_auth sind on, off.

• Gültige Werte für true_client_ip_header sind on, off.

• Gültige Werte für waf sind on, off.

• Gültige Werte für websockets sind on, off.

• Gültige Werte für proxy_read_timeout: 1 - 6000. Standardwert: 100.

• Gültige Werte für ciphers sind 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. Beispiel: -v AES256-SHA256,AES256-SHA, wobei -v default verwendet wird, um konfigurierte Cipher Suites auf den Standardwert zurückzusetzen.

• Gültige Werte für url_normalization sind "type", "scope". Zum Beispiel: -v type=cis,scope=both

  • type: Wählt die Art der „ URL “-Normalisierung aus, die von „ CIS “ durchgeführt wird. Gültige Werte für type sind cis, rfc3986.
  • scope: Legt den Umfang der Normalisierung von „ URL “ fest. Gültige Werte für scope sind both, incoming.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktivieren Sie „ tls_client_auth “ für die Domain DNS_DOMAIN_ID.

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

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Alle Aktionen der Edge-Funktionen auflisten.

ibmcloud cis edge-functions-actions

Befehlsoptionen

--name

Aktionsname. Nur für Enterprise-Tarife

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Details zur Aktion „Edge Functions“ anzeigen: ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Befehlsoptionen

--name

Aktionsname. Nur für Enterprise-Tarife

--javascript-str

Eine Javascript-Zeichenfolge. Beispiel: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Javascript-Datei.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine „Edge Functions“-Aktion.

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

Befehlsoptionen

--name

Aktionsname. Nur für Enterprise-Tarife

--javascript-str

Eine Javascript-Zeichenfolge. Beispiel: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Javascript-Datei.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Eine Edge Functions-Aktion aktualisieren.

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

Befehlsoptionen

--name

Aktionsname. Nur für Enterprise-Tarife

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Aktion „Edge-Funktionen löschen“ ACTION_NAME.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste aller Auslöser für Edge-Funktionen für die Domäne DNS_DOMAIN_ID anzeigen.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

TRIGGER_ID

Die ID des Triggers. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Details zum Auslöser „ TRIGGER_ID “ der Edge-Funktionen anzeigen.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

PATTERN_URL

Die Anfrage URL, die die Aktion auslöst. Erforderlich.

name

Der Name der Aktion, der der erstellte Trigger zugeordnet ist. Nur für Enterprise-Tarife

disable

Edge Functions-Auslöser inaktivieren.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen Edge Functions-Trigger für die Domäne DNS_DOMAIN_ID.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

TRIGGER_ID

Die ID des Triggers. Erforderlich.

PATTERN_URL

Die Anfrage URL, die die Aktion auslöst. Erforderlich.

name

Der Name der Aktion, an die der erstellte Trigger angehängt ist. Nur für Enterprise-Tarife

disable

Edge Functions-Auslöser inaktivieren.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Update: Edge-Funktionen lösen „ TRIGGER_ID “ aus.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

TRIGGER_ID

Die ID des Triggers. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

„Edge-Funktionen löschen“ löst „ TRIGGER_ID “ aus.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Befehlsoptionen

-t, --type

Art der zu erstellenden Firewall-Regeln. Gültige Werte: access-rules, ua-rules, lockdowns. Erforderlich.

• access-rules: Mit Zugriffsregeln können Anforderungen an Ihre Website zugelassen, abgefragt oder blockiert werden. Sie können Zugriffsregeln auf eine einzige Domäne oder alle Domänen in derselben Serviceinstanz anwenden.
• ua-rules: Führt beim Abgleich des vom Client gemeldeten genauen Werts für 'UserAgent' die Zugriffssteuerung durch. Die Zugriffssteuerungsmechanismen können in einer Regel definiert werden, um den Datenverkehr von bestimmten Clients zu verwalten. Mit dieser Option können Sie den Zugriff auf Ihre Website individuell anpassen.
• lockdowns: Begrenzt den Zugriff auf URLs in dieser Domäne ausschließlich auf zulässige Adressen oder Adressbereiche.

-d, --domain

Die ID der DNS-Domäne. Für die Typregeln ua-rules und lockdowns ist dies ein erforderlicher Parameter.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Firewall-Regel verwendet wird. Erforderlich.

• Für „ --type access-rules “: Die JSON-Daten, die eine Firewall-Zugriffsregel wie folgt beschreiben.
  • Erforderliche Felder sind mode, configuration.
    • mode: Die Art der auszuführenden Aktion. Gültige Werte sind block, challenge, whitelist und js_challenge.
    • configuration: Das für diese Regel zu verwendende Ziel-/Wert-Paar.
      • target: Die zu adressierende Request-Eigenschaft. Gültige Werte sind ip, ip_range, asn und country.
      • value: Der Wert für das ausgewählte Ziel.
        • Bei „ip“ handelt es sich um eine gültige IP-Adresse.
        • Für „ip_range“ gibt der Wert einen IP-Bereich an, der auf /16 und /24 beschränkt ist.
        • Bei „asn“ handelt es sich um eine AS-Nummer.
        • Bei einem Land entspricht der Wert dem Ländercode des jeweiligen Landes.
  • Optionales Feld ist notes.
    • notes: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

JSON-Beispieldaten:

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

• Für „ --type ua-rules “: Die JSON-Daten, die eine User-Agent-Regel wie folgt beschreiben.
  • Erforderliche Felder sind mode, configuration.
    • mode: Die Art der auszuführenden Aktion. Gültige Werte sind block, challenge, und js_challenge.
    • configuration: Das für diese Regel zu verwendende Ziel-/Wert-Paar.
      • target: Die zu adressierende Request-Eigenschaft. Ein gültiger Wert ist „ ua “.
      • value: Die genaue Zeichenfolge „ UserAgent “, auf die diese Regel angewandt werden soll.
  • Optionale Felder sind paused, description.
    • paused: Ob diese Regel derzeit deaktiviert ist.
    • description: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

JSON-Beispieldaten:

{
   "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"
   }
}

• Für --type lockdowns: Die JSON-Daten, die eine Sperrregel beschreiben, sehen wie folgt aus.
  • Erforderliche Felder sind urls, configurations.
    • urls: URLs, die in diese Regeldefinition aufgenommen werden sollen.
      • Platzhalter sind zulässig.
      • Das hier eingegebene URL-Muster wird vor der Verwendung mit Escapezeichen versehen.
      • Dieses Feld beschränkt die „ URL “ auf einfache Platzhaltermuster.
    • configurations: Liste der IP-Adressen oder CIDR-Bereiche, die für diese Regel verwendet werden sollen.
      • Dieses Feld kann eine beliebige Anzahl von IP- oder IP-Bereich-Konfigurationen enthalten, die auf die angegebenen URLs zugreifen können.
      • target: Die zu adressierende Request-Eigenschaft. Gültige Werte sind ip, und ip_range.
      • value: IP-Adressen oder CIDR. Wenn „target“ „ ip “ lautet, muss „value“ eine IP-Adresse sein, andernfalls ein CIDR-Format.
  • Optionale Felder sind paused, description.
    • paused: Ob diese Regel derzeit deaktiviert ist.
    • description: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Firewallregel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie Firewallregeln.

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

Befehlsoptionen

• FIREWALL_RULE_ID: Die ID der Firewallregel. Erforderlich.

-t, --type

Der Typ der zu erstellenden Firewall-Regel. Gültige Werte sind access-rules, ua-rules, und lockdowns. Erforderlich.

• access-rules: Zugriffsregeln dienen dazu, Anfragen an Ihre Website zuzulassen, zu überprüfen oder zu blockieren. Sie können Zugriffsregeln auf eine einzige Domäne oder alle Domänen in derselben Serviceinstanz anwenden.
• ua-rules: Führen Sie eine Zugriffskontrolle durch, wenn die vom Client gemeldete exakte „ UserAgent “ übereinstimmt. Die Zugriffssteuerungsmechanismen können in einer Regel definiert werden, um den Datenverkehr von bestimmten Clients zu verwalten. Auf diese Weise können Sie den Zugriff auf Ihre Site anpassen.
• lockdowns: Beschränken Sie den Zugriff auf URLs dieser Domain auf zugelassene Adressen oder Adressbereiche.

-d, --domain

Die ID der DNS-Domäne. Für die Typregeln ua-rules und lockdowns ist dies ein erforderlicher Parameter.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Firewall-Regel verwendet wird. Erforderlich.

• Für --type access-rules: Die JSON-Daten, die eine Firewall-Zugriffsregel beschreiben, sehen wie folgt aus.
  • Optionale Felder sind mode, notes.
    • mode: Die Art der auszuführenden Aktion. Gültige Werte sind block, challenge, whitelist und js_challenge.
    • notes: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

JSON-Beispieldaten:

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

• Für --type ua-rules: Die JSON-Daten, die eine User-Agent-Regel beschreiben, sehen wie folgt aus.

  • Erforderliche Felder sind mode, configuration.
    • mode: Die Art der auszuführenden Aktion. Gültige Werte sind block, challenge, und js_challenge.
    • configuration: Das für diese Regel zu verwendende Ziel-/Wert-Paar.
      • target: Die zu adressierende Request-Eigenschaft. Ein gültiger Wert ist „ ua “.
      • value: Die genaue Zeichenfolge „ UserAgent “, auf die diese Regel angewandt werden soll.
  • Optionale Felder sind paused, description.
    • paused: Ob diese Regel derzeit deaktiviert ist.
    • description: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

  JSON-Beispieldaten:

{
   "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"
   }
}

• Für --type lockdowns: Die JSON-Daten, die eine Sperrregel beschreiben, sehen wie folgt aus.
  • Erforderliche Felder sind urls, configurations.
    • urls: URLs, die in diese Regeldefinition aufgenommen werden sollen.
      • Platzhalter sind zulässig.
      • Das hier eingegebene URL-Muster wird vor der Verwendung mit Escapezeichen versehen.
      • Dieses Feld beschränkt die „ URL “ auf einfache Platzhaltermuster.
    • configurations: Liste der IP-Adressen oder CIDR-Bereiche, die für diese Regel verwendet werden sollen.
      • Dieses Feld kann eine beliebige Anzahl von IP- oder IP-Bereich-Konfigurationen enthalten, die auf die angegebenen URLs zugreifen können.
      • target: Die zu adressierende Request-Eigenschaft. Gültige Werte sind ip und ip_range.
      • value: IP-Adressen oder CIDR. Wenn das Ziel „ ip “ lautet, muss der Wert eine IP-Adresse sein, andernfalls ein CIDR-Wert.
  • Optionale Felder sind paused, description.
    • paused: Ob diese Regel derzeit deaktiviert ist.
    • description: Einige nützliche Informationen zu dieser Regel, die dabei helfen, ihren Zweck zu erkennen.

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Firewall-Regel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie die Firewallregeln.

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"}]}'

Befehlsoptionen

-t, --type

Der Typ der zu erstellenden Firewall-Regel. Gültige Werte sind access-rules, ua-rules, und lockdowns. Erforderlich.

• access-rules: Zugriffsregeln dienen dazu, Anfragen an Ihre Website zuzulassen, zu überprüfen oder zu blockieren. Sie können Zugriffsregeln auf eine einzige Domäne oder alle Domänen in derselben Serviceinstanz anwenden.
• ua-rules: Führen Sie eine Zugriffskontrolle durch, wenn die vom Client gemeldete exakte „ UserAgent “ übereinstimmt. Die Zugriffssteuerungsmechanismen können in einer Regel definiert werden, um den Datenverkehr von bestimmten Clients zu verwalten. Mit dieser Funktion können Sie den Zugriff auf Ihre Website individuell anpassen.
• lockdowns: Beschränken Sie den Zugriff auf URLs dieser Domain auf zugelassene Adressen oder Adressbereiche.

-d, --domain

Die ID der DNS-Domäne. Für die Typregeln ua-rules und lockdowns ist dies ein erforderlicher Parameter.

--page

Die Seitenzahl der paginierten Ergebnisse. Der Standardwert ist 0.

--per-page

Die maximale Anzahl der Zugriffsregeln pro Seite. Der Mindestwert beträgt 5. Der Standardwert ist 20.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Listet Firewallregeln auf.

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

Befehlsoptionen

FIREWALL_RULE_ID

Die ID der Firewall-Regel. Erforderlich.

-t, --type

Der Typ der zu erstellenden Firewallregel. Gültige Werte sind access-rules, ua-rules, und lockdowns.

• access-rules: Zugriffsregeln dienen dazu, Anfragen an Ihre Website zuzulassen, zu überprüfen oder zu blockieren. Sie können Zugriffsregeln auf eine einzige Domäne oder alle Domänen in derselben Serviceinstanz anwenden.
• ua-rules: Führen Sie eine Zugriffskontrolle durch, wenn die vom Client gemeldete exakte „ UserAgent “ übereinstimmt. Die Zugriffssteuerungsmechanismen können in einer Regel definiert werden, um den Datenverkehr von bestimmten Clients zu verwalten. Auf diese Weise können Sie den Zugriff auf Ihre Site anpassen.
• lockdowns: Beschränken Sie den Zugriff auf URLs dieser Domain auf zugelassene Adressen oder Adressbereiche.

-d, --domain

Die ID der DNS-Domäne. Für die Typregeln ua-rules und lockdowns ist dies ein erforderlicher Parameter.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Rufen Sie Details der Firewallregel ab.

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

Befehlsoptionen

FIREWALL_RULE_ID

Die ID der Firewall-Regel. Erforderlich.

-t, --type

Der Typ der zu erstellenden Firewallregel. Gültige Werte sind access-rules, ua-rules, und lockdowns. Erforderlich.

• access-rules: Zugriffsregeln dienen dazu, Anfragen an Ihre Website zuzulassen, zu überprüfen oder zu blockieren. Sie können Zugriffsregeln auf eine einzige Domäne oder alle Domänen in derselben Serviceinstanz anwenden.
• ua-rules: Führen Sie eine Zugriffskontrolle durch, wenn die vom Client gemeldete exakte „ UserAgent “ übereinstimmt. Die Zugriffssteuerungsmechanismen können in einer Regel definiert werden, um den Datenverkehr von bestimmten Clients zu verwalten. In diesem Feld können Sie den Zugriff auf Ihre Website individuell anpassen.
• lockdowns: Beschränken Sie den Zugriff auf URLs dieser Domain auf zugelassene Adressen oder Adressbereiche.

-d, --domain

Die ID der DNS-Domäne. Für die Typregeln ua-rules und lockdowns ist dies ein erforderlicher Parameter.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie eine Firewallregel.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--page

Die Seitenzahl der paginierten Ergebnisse. Der Standardwert ist 1.

--per-page

Anzahl der Firewallregeln pro Seite. Der Mindestwert ist 5 und der Maximalwert ist 100. Der Standardwert ist 25.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste der vorhandenen Firewall-Regeln in der Domäne DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

FIREWALL_RULE_ID

Die ID der Firewall-Regel. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Hier finden Sie die Details zur Firewall-Regel „ FIREWALL_RULE_ID “.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--expression

Ein Filterausdruck. Beispiel: ip.src eq 93.184.216.0.

--action

Die auszuführende Regelaktion. Gültige Werte sind log, allow, challenge, js_challenge, block und bypass.

--priority

Die Priorität der Regel. Gültige Werte liegen im Bereich von 0 bis 2147483647. Der Wert „ 0 “ bedeutet, dass der Standardwert gesetzt werden soll.

--description

Eine kurze Beschreibung der Regel.

--paused

Gibt an, ob die Regel aktiv ist oder nicht. Gültige Werte sind on und off. Der Standardwert ist off.

--products

Die Liste der Sicherheitsprodukte, die umgangen werden sollen. Gültige Werte sind zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit und waf.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Firewall-Regel verwendet wird.

• Die Pflichtfelder in den JSON-Daten sind „ expression “ und „ action “.
  • expression: Ein Filterausdruck. Beispiel: ip.src eq 93.184.216.0
  • action: Die auszuführende Regelaktion. Gültige Werte sind log, allow, challenge, js_challenge, block und bypass.
• Die optionalen Felder sind description, priority, paused, products.
  • description: Um die Regel kurz zu beschreiben.
  • priority: Die Priorität der Regel. Gültige Werte liegen im Bereich von 0 bis 2147483647. Der Wert „ 0 “ bedeutet, dass der Standardwert gesetzt werden soll.
  • paused: Gibt an, ob die Regel aktiv ist oder nicht. Gültige Werte sind on und off. Der Standardwert ist off.
  • products: Die Liste der Sicherheitsprodukte, die umgangen werden sollen. Gültige Werte sind zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit und waf. Zum Beispiel: --products, zoneLockdown, rateLimit

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Firewall-Regel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine Firewall-Regel in der Domäne 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"}'

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

FIREWALL_RULE_ID

Die ID der Firewall-Regel. Erforderlich.

--expression

Ein Filterausdruck. Beispiel: ip.src eq 93.184.216.0.

--action

Die auszuführende Regelaktion. Gültige Werte sind log, allow, challenge, js_challenge, block und bypass.

--priority

Die Priorität der Regel. Gültige Werte liegen im Bereich von 0 bis 2147483647. Der Wert „ 0 “ bedeutet, dass der Standardwert gesetzt werden soll.

--description

Eine kurze Beschreibung der Regel.

--paused

Gibt an, ob die Regel aktiv ist oder nicht. Gültige Werte sind on und off. Der Standardwert ist off.

--products

Die Liste der Sicherheitsprodukte, die umgangen werden sollen. Gültige Werte sind zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit und waf.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Firewall-Regel verwendet wird.

• Die Pflichtfelder in den JSON-Daten sind „ expression “ und „ action “.
  • expression: Ein Filterausdruck. Beispiel: ip.src eq 93.184.216.0
  • action: Die auszuführende Regelaktion. Gültige Werte sind log, allow, challenge, js_challenge, block und bypass.
• Die optionalen Felder sind description, priority, paused, products.
  • description: Um die Regel kurz zu beschreiben.
  • priority: Die Priorität der Regel. Gültige Werte liegen im Bereich von 0 bis 2147483647. Der Wert „ 0 “ bedeutet, dass der Standardwert gesetzt werden soll.
  • paused: Gibt an, ob die Regel aktiv ist oder nicht. Gültige Werte sind on und off. Der Standardwert ist off.
  • products: Die Liste der Sicherheitsprodukte, die umgangen werden sollen. Gültige Werte sind zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit und waf. Zum Beispiel: --products, zoneLockdown, rateLimit

Die Felder description, priority und paused, die nicht explizit in den JSON-Daten angegeben sind, werden durch den Standardwert überschrieben.

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Firewall-Regel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie die Firewall-Regel 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"}'

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

FIREWALL_RULE_ID

Die ID der Firewall-Regel. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie die Firewall-Regel FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

EXPRESSION

Der Filterausdruck. Beispiel: ip.src eq 93.184.216.0. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Ausdruck der Firewall-Regel validieren.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines globalen Lastenausgleichs verwendet wird. Erforderlich.

• Die Pflichtfelder in den JSON-Daten sind „ name “, „ fallback_pool “ und „ default_pools “:
  • name: Der DNS-Hostname, der Ihrem Load Balancer zugeordnet werden soll.
  • fallback_pool: Die Pool-ID, die verwendet werden soll, wenn alle anderen Pools als fehlerhaft erkannt werden.
  • default_pools: Eine Liste von Pool-IDs, sortiert nach ihrer Failover-Priorität.
• Die optionalen Felder sind description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: Die Beschreibung Ihres Lastverteilers.
  • ttl: Lebensdauer des DNS-Eintrags für die IP-Adresse, die von dieser Lastausgleichsfunktion zurückgegeben wird.
  • region_pools: Eine Zuordnung von Regional- und Ländercodes zu einer Liste von Pool-IDs (sortiert nach ihrer Failover-Priorität) für die jeweilige Region.
  • proxied: Legen Sie fest, ob der Datenverkehr die Sicherheits- und Leistungsfunktionen auf CIS durchlaufen soll.
  • enabled: Ob dieser Lastverteiler aktiviert werden soll (Standardeinstellung).
  • session_affinity die Funktion stellt sicher, dass die Anfragen eines Benutzers während einer Sitzung immer an denselben Backend-Server geleitet werden. Gültige Werte sind cookie und none.
  • session_affinity_ttl: Zeit in Sekunden, bis das Sitzungs-Affinitäts-Cookie dieses Load Balancers nach seiner Erstellung abläuft. Der gültige Wert liegt im Bereich von [1800, 604800]. Der Standardwert ist 82800.
  • steering_policy: Gültige Werte für „ steering_policy “ sind „ off “, „ geo “, „ random “ und „ dynamic_latency “.
    • off: Verwenden Sie default_pools.
    • geo: Verwenden Sie region_pools/pop_pools.
    • random: Wähle einen Pool nach dem Zufallsprinzip aus.
    • dynamic_latency: Verwenden Sie die Round-Trip-Zeit, um den nächstgelegenen Pool in „ default_pools “ auszuwählen (erfordert Pool-Zustandsprüfungen).

JSON-Beispieldaten:

{
      "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

Veraltet. Die JSON-Daten, die eine globale Lastausgleichsfunktion (Global Load Balancer - GLB) beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen globalen Load Balancer in der Domäne 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"]}}'

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

GLB_ID

Die ID des globalen Load Balancers. Erforderlich.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines globalen Lastenausgleichs verwendet wird. Erforderlich.

• Die Pflichtfelder in den JSON-Daten sind „ name “, „ fallback_pool “ und „ default_pools “:
  • name: Der DNS-Hostname, der Ihrem Load Balancer zugeordnet werden soll.
  • fallback_pool: Die Pool-ID, die verwendet werden soll, wenn alle anderen Pools als fehlerhaft erkannt werden.
  • default_pools: Eine Liste von Pool-IDs, sortiert nach ihrer Failover-Priorität.
• Die optionalen Felder sind description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: Die Beschreibung Ihres Load Balancers.
  • ttl: Time to Live (TTL) des DNS-Eintrags für die von diesem Load Balancer zurückgegebene IP-Adresse.
  • region_pools: Eine Zuordnung von Regional- und Ländercodes zu einer Liste von Pool-IDs (sortiert nach ihrer Failover-Priorität) für die jeweilige Region.
  • proxied: Legen Sie fest, ob der Datenverkehr die Sicherheits- und Leistungsfunktionen auf CIS durchlaufen muss.
  • enabled: Ob dieser Lastverteiler aktiviert werden soll (Standardeinstellung).
  • session_affinity die Funktion stellt sicher, dass die Anfragen eines Benutzers während einer Sitzung immer an denselben Backend-Server geleitet werden. Gültige Werte sind cookie und none.
  • session_affinity_ttl: Zeit in Sekunden, bis das Sitzungs-Affinitäts-Cookie dieses Load Balancers abläuft, nachdem es erstellt wurde. Der gültige Wert liegt im Bereich von [1800, 604800]. Der Standardwert ist 82800.
  • steering_policy: Gültige Werte für „ steering_policy “ sind „ off “, „ geo “, „ random “ und „ dynamic_latency “.
    • off: Verwenden Sie default_pools.
    • geo: Verwenden Sie region_pools/pop_pools.
    • random: Wähle einen Pool nach dem Zufallsprinzip aus.
    • dynamic_latency: Verwenden Sie die Round-Trip-Zeit, um den nächstgelegenen Pool in „ default_pools “ auszuwählen (erfordert Pool-Zustandsprüfungen).

JSON-Beispieldaten:

{
      "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

Veraltet. Die JSON-Daten, die eine globale Lastausgleichsfunktion (Global Load Balancer - GLB) beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktualisieren Sie den globalen Load Balancer GLB_ID in der Domäne 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"]}}'

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

GLB_ID

Die ID des globalen Load Balancers. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

GLB_ID en zum globalen Load Balancer in der Domäne DNS_DOMAIN_ID anzeigen.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

GLB_ID

Die ID des globalen Load Balancers. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Den globalen Load Balancer „ GLB_ID “ in der Domäne „ DNS_DOMAIN_ID “ löschen.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste der Load Balancer für die Domain DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Geben Sie das Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Alle GLB-Pools auflisten.

ibmcloud cis glb-pools

Befehlsoptionen

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines GLB-Pools verwendet wird. Erforderlich.

• Die Pflichtfelder in den JSON-Daten sind „ name “, „ origins “ und „ check_regions “:
  • name: Ein Kurzname (Tag) für den Pool.
  • origins: Eine Liste der Herkunftsländer innerhalb dieses Pools.
  • check_regions: Eine Liste der Codes für geografische Regionen.
• Die optionalen Felder sind description, minimum_origins, enabled, monitor.

JSON-Beispieldaten:

{
   "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

Veraltet. Die für die Beschreibung eines Pools der globalen Lastausgleichsfunktion verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen GLB-Pool.

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"]}}]}'

Befehlsoptionen

GLB_POOL_ID

Die ID des globalen Load-Balancer-Pools. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeige die Details des GLB-Pools „ GLB_POOL_ID “ an.

ibmcloud cis glb-pool GLB_POOL_ID

Befehlsoptionen

GLB_POOL_ID

Die ID des globalen Load-Balancer-Pools. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

GLB-Pool „ GLB_POOL_ID “ löschen.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Befehlsoptionen

GLB_POOL_ID

Die ID des globalen Load-Balancer-Pools. Erforderlich.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines GLB-Pools verwendet wird.

• Die Pflichtfelder in den JSON-Daten sind „ name “, „ origins “ und „ check_regions “:
  • name: Ein Kurzname (Tag) für den Pool.
  • origins: Eine Liste der Herkunftsländer innerhalb dieses Pools.
  • check_regions: Eine Liste der Codes für geografische Regionen.
• Die optionalen Felder sind description, minimum_origins, enabled, monitor.

JSON-Beispieldaten:

{
   "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

Aktiviert den Ursprung im Pool. Der Wert kann URSPRUNGSNAME oder URSPRUNGSADRESSE sein.

--disable-origin

Inaktiviert den Ursprung im Pool. Der Wert kann URSPRUNGSNAME oder URSPRUNGSADRESSE sein.

--add-origin

Fügt einen Ursprung im Pool hinzu. URSPRUNGSNAME und URSPRUNGSADRESSE sind erforderlich. Zum Beispiel: --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Entfernt einen Ursprung aus dem Pool. Der Wert kann URSPRUNGSNAME oder URSPRUNGSADRESSE sein.

-s, --json-str

Veraltet. Die für die Beschreibung eines Pools der globalen Lastausgleichsfunktion verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

GLB-Pool aktualisieren 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}]}'

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Alle GLB-Überwachungsgeräte auflisten.

ibmcloud cis glb-monitors

Befehlsoptionen

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines GLB-Monitors verwendet wird. Erforderlich.

• Das erforderliche Feld in JSON-Daten ist type.
  • type: Das für den Healthcheck zu verwendende Protokoll. Gültige Werte sind HTTP, HTTPS, und TCP.
• Die optionalen Felder sind description, timeout, retries, interval.
  • description: Beschreibung.
  • timeout: Die Zeitüberschreitung (in Sekunden), nach der der Zustandscheck als fehlgeschlagen markiert wird.
  • retries: Die Anzahl der Wiederholungsversuche, die im Falle eines Timeouts unternommen werden sollen, bevor der Ursprung als fehlerhaft markiert wird.
  • interval: Der Zeitraum zwischen den einzelnen Gesundheitschecks.
• Für eine Statusprüfung des Typs TCP. Zusätzliches erforderliches Feld ist port.
  • port: Der Port „ TCP “, der für den Zustandscheck verwendet werden soll.
• Für eine Statusprüfung des Typs HTTP/HTTPS. Zusätzliche optionale Felder sind port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Der Port „ TCP “, der für den Zustandscheck verwendet werden soll.
  • expected_body: Eine Teilzeichenfolge, nach der im Antworttext gesucht werden soll (Groß-/Kleinschreibung wird nicht berücksichtigt).
  • expected_codes: Der erwartete „ HTTP “-Antwortcode oder der erwartete Code-Bereich des Zustandschecks.
  • method: Die Methode „ HTTP “, die für den Zustandscheck verwendet werden soll.
  • path: Der Pfad zum Endpunkt, an dem die Funktionsprüfung durchgeführt werden soll.
  • header: Die HTTP-Anfrage-Header, die im Health-Check gesendet werden sollen.
  • follow_redirects: Umleitungen befolgen, sofern sie vom Ursprungsserver zurückgegeben werden.
  • allow_insecure: Das Zertifikat darf nicht validiert werden, wenn der Monitor „ HTTPS “ verwendet.
  • probe_zone: Weisen Sie diesen Monitor zu, damit er während der Abtastung die angegebene Zone emuliert.

JSON-Beispieldaten:

Für 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"
}

Für TCP:

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

-s, --json-str

Veraltet. Die für die Beschreibung einer Überwachung der globalen Lastausgleichsfunktion verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen GLB-Monitor.

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}'

Befehlsoptionen

GLB_MON_ID

Die ID des globalen Load-Balancer-Monitors. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeige die Details des GLB-Monitors „ GLB_MON_ID “ an.

ibmcloud cis glb-monitor GLB_MON_ID

Befehlsoptionen

GLB_MON_ID

Die ID der Überwachung einer globalen Lastausgleichsfunktion. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Löschen Sie den GLB-Monitor GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Befehlsoptionen

GLB_MON_ID

Die ID des globalen Load-Balancer-Monitors. Erforderlich.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines GLB-Monitors verwendet wird. Erforderlich.

• Das erforderliche Feld in JSON-Daten ist type.
  • type: Das für den Healthcheck zu verwendende Protokoll. Gültige Werte sind HTTP, HTTPS, und TCP.
• Die optionalen Felder sind description, timeout, retries, interval.
  • description: Beschreibung.
  • timeout: Die Zeitüberschreitung (in Sekunden), nach der der Zustandscheck als fehlgeschlagen markiert wird.
  • retries: Die Anzahl der Wiederholungsversuche, die im Falle eines Timeouts unternommen werden sollen, bevor der Ursprung als fehlerhaft markiert wird.
  • interval: Der Zeitraum zwischen den einzelnen Gesundheitschecks.
• Für eine Statusprüfung des Typs TCP. Zusätzliches erforderliches Feld ist port.
  • port: Der Port „ TCP “, der für den Zustandscheck verwendet werden soll.
• Für eine Statusprüfung des Typs HTTP/HTTPS. Zusätzliche optionale Felder sind port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Der Port „ TCP “, der für den Zustandscheck verwendet werden soll.
  • expected_body: Eine Teilzeichenfolge, nach der im Antworttext gesucht werden soll (Groß-/Kleinschreibung wird nicht berücksichtigt).
  • expected_codes: Der erwartete „ HTTP “-Antwortcode oder der erwartete Code-Bereich des Zustandschecks.
  • method: Die Methode „ HTTP “, die für den Zustandscheck verwendet werden soll.
  • path: Der Pfad zum Endpunkt, an dem die Funktionsprüfung durchgeführt werden soll.
  • header: Die HTTP-Anfrage-Header, die im Health-Check gesendet werden sollen.
  • follow_redirects: Umleitungen befolgen, sofern sie vom Ursprungsserver zurückgegeben werden.
  • allow_insecure: Das Zertifikat darf nicht validiert werden, wenn der Monitor „ HTTPS “ verwendet.
  • probe_zone: Weisen Sie diesen Monitor zu, damit er während der Abtastung die angegebene Zone emuliert.

JSON-Beispieldaten:

Für 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"
}

Für TCP:

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

-s, --json-str

Veraltet. Die für die Beschreibung einer Überwachung der globalen Lastausgleichsfunktion verwendeten JSON-Daten.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

GLB-Monitor aktualisieren 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}'

Befehlsoptionen

-s, --since

Startdatum des Datenanforderungszeitraums im ISO8601-Format. Beispiel: 2018-11-26.

-u, --until

Enddatum des Datenanforderungszeitraums im ISO8601-Format. Beispiel: 2018-11-28.

--origin-name

Der Name des Ursprungs, nach dem gefiltert werden soll.

--pool-name

Der Name des Pools, nach dem gefiltert werden soll.

--origin-healthy

Wenn „true“, werden Ereignisse gefiltert, bei denen der Status der Quelle „healthy“ ist; wenn „false“, werden Ereignisse gefiltert, bei denen der Status der Quelle „unhealthy“ ist. Der Standardwert lautet „ true “, und gültige Werte sind „ true “ und „ false “.

--pool-healthy

Wenn „true“, werden Ereignisse gefiltert, bei denen der Pool-Status „healthy“ ist; wenn „false“, werden Ereignisse gefiltert, bei denen der Pool-Status „unhealthy“ ist. Der Standardwert lautet „ true “, und gültige Werte sind „ true “ und „ false “.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Glb-Ereignisse erhalten.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--fields

Definieren Sie die Feldgruppe in der Rückgabe.

• Dieses Feld muss als durch Kommas getrennte Liste ohne Leerzeichen angegeben werden, und alle Felder müssen vorhanden sein.
• Die Reihenfolge, in der die Felder angegeben werden, ist unerheblich, und die Reihenfolge der Felder in der Antwort ist nicht definiert.
• Bei den Feldern ist die Groß- und Kleinschreibung zu beachten.

--filter

Filter für einen Drilldown zu bestimmten Ereignissen. Filter bestehen aus drei Teilen: Schlüssel, Operator und Wert. Informationen zu unterstützten Operatoren finden Sie unter "Felder, Funktionen und Ausdrücke verwenden ".

--sample

Die vom Client festgelegte Abtastrate der Datensätze: „ sample: 1“ entspricht 100 % der Datensätze.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

-h, --help

Hier finden Sie Hilfe zu diesem Befehl.

Beispiele

Erstellen Sie ein Sofortprotokoll für die Domain DNS_DOMAIN_ID:

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

Im Folgenden sind drei Beispiele für Filter aufgeführt:

• Filter, wenn das Land der Client-IP nicht Kanada ist:

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

• Filtern Sie, wenn der von CIS zurückgegebene Statuscode entweder 200 oder 201 lautet:

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

• Filter, wenn der Anfragepfad "/static" enthält und der Anfragerechnername " example.com " lautet:

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

-h, --help

Hilfe zu diesem Befehl.

Beispiel

Rufen Sie den „Instant Logs“-Job für die Domain DNS_DOMAIN_ID ab:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--available-fields

Eine Liste aller verfügbaren Felder.

--ray-id

Sucht Protokolle nach einer bestimmten Ray-ID.

--fields

Definieren Sie die Feldgruppe in der Rückgabe. Dieses Feld muss als durch Kommas getrennte Liste ohne Leerzeichen angegeben werden, und alle Felder müssen vorhanden sein. Die Reihenfolge, in der die Felder angegeben werden, ist unerheblich, und die Reihenfolge der Felder in der Antwort ist nicht definiert. Beachten Sie, dass bei Feldern die Groß-/Kleinschreibung beachtet werden muss.

--start

Der Beginn des gewünschten Zeitrahmens (einschließlich). Dies kann eine UNIX-Zeitmarke (in Sekunden und Nanosekunden) oder eine absolute Zeitmarke sein, die RFC 3339 entspricht. Derzeit darf der Zeitpunkt in der Vergangenheit nicht länger als 7 Tage zurückliegen. Der Standardwert ist 65 Minuten vor dem aktuellen Beginn.

--end

Das Ende des gewünschten Zeitrahmens (ausschließlich). Dieser Wert kann ein Unix-Zeitstempel (in Sekunden oder Nanosekunden) oder ein absoluter Zeitstempel sein, der dem RFC 3339 entspricht. Der Wert für end muss mindestens fünf Minuten vor dem aktuellen Zeitpunkt liegen und später als der Wert für start sein. Die Differenz zwischen start und end darf nicht größer sein als 1h. Die Standardeinstellung ist 5 Minuten früher.

--count

Anzahl der abzurufenden Protokolle. Der Standardwert ist -1.

--sample

Entnommene Stichproben in Prozent. Wird eine Stichprobe bereitgestellt, wird eine Stichprobe entsprechender Datensätze zurückgegeben. Wenn „ sample=0.1 “ gilt, werden 10 % der Datensätze zurückgegeben. Die Stichprobe erfolgt nach dem Zufallsprinzip: Bei wiederholten Abfragen werden nicht nur unterschiedliche Datensätze zurückgegeben, sondern die Anzahl der zurückgegebenen Datensätze variiert wahrscheinlich auch geringfügig. Wenn auch die Anzahl (Count) angegeben ist, wird dieser Wert auf die Anzahl der zurückgegebenen Datensätze und nicht auf die Anzahl der Stichprobendatensätze angewendet. Bei den Abfragen „ sample=0.05 “ und „ count=7 “ werden also, wenn insgesamt 100 Datensätze verfügbar sind, etwa 5 Datensätze zurückgegeben. Bei 1000 Datensätzen werden 7 Datensätze zurückgegeben. Bei 10.000 Datensätzen werden 7 Datensätze zurückgegeben. Der Standardwert ist 1.

--timestamps

Legen Sie das Format fest, in dem die Antwortzeitmarken zurückgegeben werden. Gültige Werte sind unix, unixnano und rfc3339.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--destination

Geben Sie ein Ziel an, zu dem die Daten übertragen werden. Weitere Informationen über unterstützte Ziele finden Sie unter Verwalten von Logpush-Aufträgen.

• Syntax für den Pfad „ Cloud Object Storage “: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Beispiel: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Um die Protokolle in tägliche Unterordner zu sortieren, verwenden Sie die spezielle Zeichenfolge „ {DATE} “ im Bucket-Pfad. Es wird durch das Datum im Format „ YYYYMMDD “ ersetzt, zum Beispiel „20190423“. Unterordner werden nach Bedarf angelegt, zum Beispiel: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Jobname. Erforderlich.

--enable

Aktivieren Sie den Job. Der Job ist standardmäßig inaktiviert.

--fields

Definiert die Liste der Protokollfelder, die in die Protokolldateien aufgenommen werden sollen. Mehrere Felder können durch Kommas getrennt werden. Verwenden Sie den Befehl [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] verwenden, um eine umfassende Liste der verfügbaren Protokollfelder zu erhalten, oder „ all “ verwenden, um alle verfügbaren Felder in die Protokolldateien aufzunehmen. Beachten Sie, dass bei Feldern die Groß-/Kleinschreibung beachtet werden muss.

--timestamps

Legen Sie das Format fest, in dem die Antwortzeitmarken zurückgegeben werden. Gültige Werte sind unix, unixnano und rfc3339.

--dataset

Die Kategorie der Protokolle, die Sie erhalten möchten. Dieser Wert kann nicht geändert werden, nachdem der Job erstellt wurde. Gültige Werte sind http_requests, range_events, firewall_events, dns_logs. Der Standardwert ist http_requests.

--frequency

Die Häufigkeit, mit der CIS Protokollstapel an Ihr Ziel sendet. Wenn Sie die Frequenz auf „hoch“ einstellen, werden Ihre Protokolle in größeren Mengen kleinerer Dateien gesendet. Wird die Frequenz auf „niedrig“ eingestellt, werden Protokolle in kleineren Mengen, dafür aber in größeren Dateien gesendet. Gültige Werte sind high und low.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie einen Logpush-Job für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--destination

Geben Sie ein Ziel an, zu dem die Daten übertragen werden. Weitere Informationen über unterstützte Ziele finden Sie unter Verwalten von Logpush-Aufträgen. Syntax für den Pfad „ Cloud Object Storage “: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Beispiel: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Um Protokolle in nach Tagen geordnete Unterordner aufzuteilen, verwenden Sie die spezielle Zeichenfolge {DATE} im Bucketpfad. Es ist durch das Datum im Format „ YYYYMMDD “ zu ersetzen, zum Beispiel „20190423“. Unterordner werden nach Bedarf angelegt, zum Beispiel: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Aktivieren Sie den Job. Der Job ist standardmäßig inaktiviert.

--fields

Definiert die Liste der Protokollfelder, die in die Protokolldateien aufgenommen werden sollen. Mehrere Felder können durch Kommas getrennt werden; verwenden Sie den Befehl ibmcloud cis logpush-available-fields DNS_DOMAIN_ID, um die umfassende Liste der verfügbaren Protokollfelder abzurufen, oder verwenden Sie all, um alle verfügbaren Felder in Protokolldateien einzuschließen. Beachten Sie, dass bei Feldern die Groß-/Kleinschreibung beachtet werden muss.

--timestamps

Legen Sie das Format fest, in dem die Antwortzeitmarken zurückgegeben werden. Gültige Werte sind unix, unixnano und rfc3339.

--dataset

Die Kategorie der Protokolle, die Sie erhalten möchten. Dieser Wert kann nicht geändert werden, nachdem der Job erstellt wurde. Gültige Werte sind http_requests, range_events, firewall_events,dns_logs. Der Standardwert ist http_requests.

--jobid

JOB_ID ist die ID des Logpush-Jobs.

--frequency

Die Häufigkeit, mit der CIS Protokollstapel an Ihr Ziel sendet. Wenn Sie die Frequenz auf „hoch“ einstellen, werden Ihre Protokolle in größeren Mengen kleinerer Dateien gesendet. Wird die Frequenz auf „niedrig“ eingestellt, werden Protokolle in kleineren Mengen, dafür aber in größeren Dateien gesendet. Gültige Werte sind high und low.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Update range_events logpush job für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

-output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Alle Logpush-Aufträge für die Domain DNS_DOMAIN_ID abrufen.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--dataset

Die Kategorie der Protokolle, die Sie erhalten möchten. Dieser Wert kann nicht geändert werden, nachdem der Job erstellt wurde. Gültige Werte sind http_requests, range_events, firewall_events,dns_logs. Der Standardwert ist http_requests.

--jobid

JOB_ID ist die ID des Logpush-Jobs.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Einzelheiten zum Auftrag http_requests logpush abrufen.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--dataset

Die Kategorie der Protokolle, die Sie erhalten möchten. Dieser Wert kann nicht geändert werden, nachdem der Job erstellt wurde. Gültige Werte sind http_requests, range_events, firewall_events,dns_logs. Der Standardwert ist http_requests.

--jobid

JOB_ID ist die ID des Logpush-Jobs.

-f, --force

Logpush-Auftrag ohne Bestätigungsabfrage löschen.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

http_requests logpush-Job für Domain DNS_DOMAIN_ID löschen.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--dataset

Die Kategorie der Protokolle, die Sie erhalten möchten. Dieser Wert kann nicht geändert werden, nachdem der Job erstellt wurde. Gültige Werte sind http_requests, range_events, firewall_events,dns_logs. Der Standardwert ist http_requests.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Rufen Sie alle verfügbaren Felder für Protokolle des Typs http_requests ab.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Rufen Sie die Einstellung zur Protokollaufbewahrungsdauer für die Domain DNS_DOMAIN_ID ab.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--flag

Ob die Protokollierung aktiviert oder deaktiviert werden soll. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Aktivieren Sie die Protokollaufbewahrung für die Domäne DNS_DOMAIN_ID.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--dataset

Angefordertes Dataset. Der Standardwert ist firewallEventsAdaptiveGroups.

Stellen Sie anhand der folgenden Tabelle fest, welche Datasets in Ihrem Plan enthalten sind und welchen Langzeitdatenbereich Sie abfragen können.

In Ihrem Plan enthaltene Datensätze

Dataset	Testversion / Standard / Standard-Next	Enterprise / Security / GLB
firewallEventsAdaptiveGroups	30 Tage	30 Tage
firewallEventsAdaptive	30 Tage	30 Tage

--filter

Filtert Ereignisse. Der Standardwert ist das Datenaufkommen der letzten sechs Stunden.

Die folgenden Operatoren werden für alle Filteroptionen unterstützt:

Unterstützung der Betreiber bei Filteroptionen

Operator	Vergleich
gt	größer als
lt	kleiner als
geq	größer oder gleich
leq	kleiner oder gleich
neq	ungleich
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

Ausgabereihenfolge. (Der Standardwert lautet „ datetime_ASC “.)

Die folgende Liste enthält verwendbare Sortieroptionen für das entsprechende Dataset; alle Sortieroptionen unterstützen die Aktion ASC und DESC. Sie können diese Filteroptionen und Aktionen mit _ kombinieren.

Beispielsweise sortiert „ datetime_ASC “ die Einträge nach Datum und Uhrzeit in aufsteigender Reihenfolge.

• Sortieroptionen für 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

Die Anzahl der zurückzusendenden Veranstaltungen. (Minimum: 1, Maximum: 10000, Standard: 10000)

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Hier finden Sie Analysen zu Firewall-Ereignissen für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--dataset

Angefordertes Dataset. Der Standardwert ist httpRequests1dGroups. Stellen Sie anhand der folgenden Tabelle fest, welche Datasets in Ihrem Plan enthalten sind und welchen Langzeitdatenbereich Sie abfragen können.

Identifizieren Sie die in Ihrem Plan enthaltenen Datensätze

Dataset	Testversion / Standard / Standard-nächste	Enterprise / Security / GLB
httpRequests1dGroups	365 Tage	365 Tage
httpRequests1hGroups	30 Tage	90 Tage
httpRequests1mGroups	30 Tage	7 Tage

--filter

Filtert Ereignisse. Der Standardwert ist das Datenaufkommen der letzten sieben Tage. Die folgenden Operatoren werden für alle Filteroptionen unterstützt:

Unterstützung der Betreiber bei Filteroptionen

Operator	Vergleich
gt	größer als
lt	kleiner als
geq	größer oder gleich
leq	kleiner oder gleich
neq	ungleich
in	in

• Filteroptionen für httpRequests1dGroups und httpRequests1hGroups:

  • date

• Filteroptionen für httpRequests1mGroups:

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Ausgabereihenfolge. (Der Standardwert lautet „ datetime_ASC “.)

Die folgende Liste enthält verwendbare Sortieroptionen für das entsprechende Dataset; alle Sortieroptionen unterstützen die Aktion ASC und DESC. Sie können diese Sortieroptionen und Aktionen mit _ kombinieren.

Beispielsweise sortiert „ date_ASC “ die Einträge nach Datum in aufsteigender Reihenfolge.

• Allgemeine Sortieroptionen für jedes HTTP-Dataset:
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Sortieroptionen für httpRequests1dGroups:
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Sortieroptionen für httpRequests1hGroups:
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Sortieroptionen für httpRequests1mGroups:
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

Die Anzahl der zurückzusendenden Veranstaltungen. (Minimum: 1, Maximum: 10000, Standard: 10000)

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Holen Sie sich die HTTP-Anfrage-Analysen für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--recent

Der Beginn des gewünschten Zeitrahmens. Gültige Werte sind 6h (vor 6 Stunden), 12h, 1d (vor 1 Tag), 1w (vor 1 Woche), 1m (vor 1 Monat), 2m, 3m. Der Standardwert ist 1w.

-t, --table

Die Ausgabetabelle. Gültige Werte sind requests, bandwidth, uniques, threats und status_code. Wenn dieses Feld nicht gesetzt ist, werden alle Tabellen ausgegeben.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Webanalysen für die Domain DNS_DOMAIN_ID abrufen.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

DIMENSION

Die abgefragte Dimension. Gültige Werte sind queries-by-response-code, queries-by-type, queries-by-name. Erforderlich.

-s, --since

Gibt die Zeit bis zur Gegenwart an. Gültige Werte sind 6h (vor 6 Stunden), 12h, 1d (vor 1 Tag), 1w (vor 1 Woche).

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Holen Sie sich DNS-Analysen für die Domain DNS_DOMAIN_ID.

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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--recent

Der Beginn des gewünschten Zeitrahmens. Gültige Werte sind 6h (vor 6 Stunden), 12h, 1d (vor 1 Tag), 1w (vor 1 Woche), 1m (vor 1 Monat), 2m, 3m. Der Standardwert ist 1w.

--time-delta

Das Zeitintervall (in Sekunden) für den Datensatz der einzelnen Analysen. Gültige Werte sind 60, 3600, 86400, 2592000. Der Standardwert ist 3600.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Rufen Sie die Analysedaten zum Ratenlimit für die Domain DNS_DOMAIN_ID ab.

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

Befehlsoptionen

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Gegenseitiges Aktivieren TLS.

ibmcloud cis access-enable

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Alle Ursprungszertifikate für die Domain DNS_DOMAIN_ID auflisten.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--request-type REQUEST_TYPE

Signaturtyp, den Sie für das Zertifikat wünschen. Gültige Werte sind origin-rsa und origin-ecc.

--hostnames HOSTNAME

hostname oder Wildcard-Name, der an das Zertifikat gebunden ist.

--requested-validity DAYS

Die Anzahl der Tage, für die das Zertifikat gültig sein muss. Der Standardwert ist 5475.

--csr CSR

Die Zertifikatssignieranforderung (Certificate Signing Request - CSR). Wenn dieses Feld nicht gesetzt ist, wird es von CIS generiert.

--json value*

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines Ursprungszertifikats verwendet wird.

• Die erforderlichen Felder in JSON-Daten sind request_type, hostnames.
  • request_type signaturtyp, den Sie für das Zertifikat wünschen. Gültige Werte sind origin-rsa und origin-ecc.
  • hostnames: Ein Array aus Hostnamen oder Platzhalternamen, die an das Zertifikat gebunden sind.
• Die optionalen Felder sind requested_validity, csr.
  • requested_validity: Die Anzahl der Tage, für die das Zertifikat gültig sein muss. Gültige Werte sind 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: Die Zertifikatssignierungsanforderung (CSR). Wenn dieses Feld nicht gesetzt ist, wird es von CIS generiert.

JSON-Beispieldaten:

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

-s, --json-str

Veraltet. Die JSON-Daten, die ein Ursprungszertifikat beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie ein Zertifikat mit dem Verzeichnis „ CIS “ für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

CERT_ID

Die ID des Ursprungszertifikats. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Weitere Informationen zur Ursprungsbescheinigung finden Sie unter CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

CERT_ID

Die ID des Ursprungszeugnisses. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Ursprungszertifikat „ CERT_ID “ löschen.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Zeige die Übersichtsinformationen für die Domain DNS_DOMAIN_ID an.

ibmcloud cis overview DNS_DOMAIN_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Seitenregel verwendet wird. Erforderlich.

• Die Pflichtfelder in den JSON-Daten sind „targets“ und „actions“:
  • targets: Das Ziel- URL-Muster, das bei einer Anfrage ausgewertet werden soll.
  • actions: Eine Reihe von Aktionen, die ausgeführt werden sollen, wenn die Ziele dieser Regel mit der Anfrage übereinstimmen. Die folgenden Aktionen sind verfügbar:
    • 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
    • Veraltet. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Einige Funktionen sind auf Enterprise-Tarife beschränkt:
      • 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
• Die optionalen Felder sind „ priority “ und „ status “:
  • priority: Eine Zahl, die angibt, inwieweit eine Seitenregel gegenüber einer anderen bevorzugt wird. Der Standardwert ist 1.
  • status: Status der Seitenregel. Die zulässigen Werte sind „ active “ und „ disabled “ (Standard).

JSON-Beispieldaten:

   {
   "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

Veraltet. Die JSON-Daten, die eine Seitenregel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine Seitenregel für die Domain 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

PAGE_RULE_ID

Die ID der Seitenregel. Erforderlich.

--json VALUE

Die JSON-Datei oder der JSON-String, der zur Beschreibung einer Seitenregel verwendet wird. Erforderlich.

• Die Pflichtfelder in den JSON-Daten sind „ targets “ und „ actions “:
  • targets: Das Ziel- URL-Muster, das bei einer Anfrage ausgewertet werden soll.
  • actions: Eine Reihe von Aktionen, die ausgeführt werden sollen, wenn die Ziele dieser Regel mit der Anfrage übereinstimmen. Die folgenden Aktionen sind verfügbar:
    • 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
    • Veraltet. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Einige Funktionen sind auf Enterprise-Tarife beschränkt:
      • 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
• Die optionalen Felder sind „ priority “ und „ status “:
  • priority: Eine Zahl, die angibt, inwieweit eine Seitenregel gegenüber einer anderen bevorzugt wird. Der Standardwert ist 1.
  • status: Status der Seitenregel. Gültige Werte sind active und disabled. Der Standardwert ist disabled.

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Seitenregel beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Regel für die Aktualisierung der Seite „ 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

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

PAGE_RULE_ID

Die ID der Seitenregel. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

Beispiele

Seite „ PAGE_RULE_ID “ löschen.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Liste aller Seitenregeln in der Domain DNS_DOMAIN_ID anzeigen.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

PAGE_RULE_ID

Die ID der Seitenregel. Erforderlich.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Details zur Seitenregel „ PAGE_RULE_ID “ anzeigen.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

--name

Der Name des DNS-Eintrags für den Bereichsantrag.

--edge-port

Port-Konfiguration an der Grenze von CIS. Der Standardwert ist 22.

--origin-direct

Zieladressen an den Ursprung.

--origin-lb-name

Der Name des Load Balancers, der der Anwendung „range“ zugeordnet ist.

--origin-lb-port

Der dem Anwendungsbereich zugeordnete Port des Load Balancers. Der Standardwert ist 22.

--protocol

Protokolltyp. Gültige Werte sind tcp und udp. Die Unterstützung des UDP-Protokolls ist im Vorabzugriff; fordern Sie vom CIS-Dashboard ein angepasstes UDP an, bevor Sie eine UDP-Bereichsanwendung erstellen. Der Standardwert ist tcp.

--proxy-protocol

Proxy-Protokoll an den Ursprung aktivieren. Gültige Werte sind on, off, v1, v2, simple. Der Standardwert ist off. Veraltet. Der Wert on entspricht v1.

--ip-firewall

Legt fest, ob die IP-Firewall für diese Anwendung aktiviert ist. Gültige Werte sind on und off. Der Standardwert ist off.

--edge-connectivity

Die für eingehende Verbindungen unterstützten IP-Versionen in einem Bereich von Anycast-IPs. Gültige Werte sind all, ipv4, ipv6. Der Standardwert ist all.

--edge-tls

Der Typ des TLS-Abschlusses, der dieser Anwendung zugeordnet ist. Gültige Werte sind off, flexible, full, strict. Der Standardwert ist off.

--traffic-type

Legt fest, wie Daten von der Edge zum Ursprung übertragen werden. Gültige Werte sind direct, http, https. Der Standardwert ist direct.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines Bereichsantrags verwendet wird.

• Die Pflichtfelder in den JSON-Daten sind „ protocol “ und „ dns “.
  • protocol: Portkonfiguration am Rand von CIS.
  • dns: Name und Typ des DNS-Eintrags für den Bereichsantrag.
    • name: Der Name des DNS-Eintrags für den Bereichsantrag.
    • type: Der Typ des DNS-Eintrags, der der Anwendung zugeordnet ist. Ein gültiger Wert ist „ CNAME “.
• Die optionalen Felder sind origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls und traffic_type.
  • origin_direct: Eine Liste von Zieladressen zum Absender.
  • origin_dns: Methode und Parameter, die verwendet werden, um die Adresse des Ursprungsservers über DNS zu ermitteln.
    • name: Name des DNS-Eintrags.
  • origin_port: Der Zielhafen am Abfahrtsort.
  • proxy_protocol: Aktivieren Sie das Proxy-Protokoll zum Ursprungsserver. Gültige Werte sind on, off, v1, v2, simple. Der Standardwert ist off. Veraltet. Der Wert on entspricht v1.
  • ip_firewall steuerung, ob die IP-Firewall für diese Anwendung aktiviert ist. Gültige Werte sind on und off.
  • edge_ips: Die Anycast-Edge-IP-Konfiguration für den Hostnamen dieser Anwendung.
    • type: Die Art der angegebenen Edge-IP-Konfiguration. Dynamisch zugeordnete Edge-IPs verwenden Anycast-IPs je nach der von Ihnen angegebenen Konnektivität. Ein gültiger Wert ist „ dynamic “.
    • connectivity: Die für eingehende Verbindungen unterstützten IP-Versionen in einem Bereich von Anycast-IPs. Gültige Werte: all, ipv4, ipv6.
  • tls: Der Typ der TLS-Beendigung, die der Anwendung zugeordnet ist. Gültige Werte sind off, flexible, full und strict.
  • traffic_type: Legt fest, wie Daten vom Edge zu Ihrem Ursprung übertragen werden. Bei der Einstellung „ direct “ leitet „range“ den Datenverkehr direkt an Ihren Ursprungsserver weiter, und der Anwendungstyp wird aus dem Protokoll abgeleitet. Wenn die Einstellung auf „ http “ oder „ https “ gesetzt ist, wendet „range“ die Funktionen von „ CIS “ ( HTTP / HTTPS ) an, da der Datenverkehr an Ihren Ursprungsserver weitergeleitet wird und der Anwendungstyp genau mit dieser Eigenschaft übereinstimmt. Gültige Werte sind direct, http und https. Der Standardwert ist direct.

JSON-Beispieldaten:

{
   "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

Veraltet. Die JSON-Daten, die eine Range-Anwendung beschreiben.

-j, --json-file

Veraltet. Eine Datei enthält JSON-Daten für die Eingabe.

-i, --instance

Instanzname oder ID. Wenn Instanzname oder -ID nicht festgelegt sind, wird die durch ibmcloud cis instance-set INSTANCE angegebene Kontextinstanz verwendet.

--output

Das Ausgabeformat. Derzeit ist „ json “ der einzige unterstützte Wert.

Beispiele

Erstellen Sie eine Bereichsapp für die Domäne 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"}'

Befehlsoptionen

DNS_DOMAIN_ID

Die ID der DNS-Domain. Erforderlich.

APP_ID

Die ID des Bereichsantrags. Erforderlich.

--name

Der Name des DNS-Eintrags für den Bereichsantrag.

--add-origin-direct

Fügen Sie dem Absender neue Zieladressen hinzu.

--remove-origin-direct

Entfernt neue Zieladressen aus dem Ursprung.

--origin-direct

Zieladressen an den Ursprung.

--origin-lb-name

Der Name des Load Balancers, der der Anwendung „range“ zugeordnet ist.

--origin-lb-port

Der dem Anwendungsbereich zugeordnete Port des Load Balancers. Der Standardwert ist 22.

--proxy-protocol

Aktivieren Sie das Proxy-Protokoll zum Ursprungsserver. Gültige Werte sind on, off, v1, v2, simple. Der Standardwert ist off. Veraltet. Der Wert on entspricht v1.

--ip-firewall

Legt fest, ob die IP-Firewall für diese Anwendung aktiviert ist. Gültige Werte sind on und off. Der Standardwert ist off.

--edge-connectivity

Die für eingehende Verbindungen unterstützten IP-Versionen in einem Bereich von Anycast-IPs. Gültige Werte sind all, ipv4, ipv6. Der Standardwert ist all.

--edge-tls

Der Typ des TLS-Abschlusses, der dieser Anwendung zugeordnet ist. Gültige Werte sind off, flexible, full, strict. Der Standardwert ist off.

--traffic-type

Legt fest, wie Daten von der Edge zum Ursprung übertragen werden. Gültige Werte sind direct, http, https. Der Standardwert ist direct.

--json

Die JSON-Datei oder der JSON-String, der zur Beschreibung eines Bereichsantrags verwendet wird.

• Die Pflichtfelder in den JSON-Daten sind „ protocol “ und „ dns “.
  • protocol: Portkonfiguration am Rand von CIS.
  • dns: Name und Typ des DNS-Eintrags für den Bereichsantrag.
    • name: Der Name des DNS-Eintrags für den Bereichsantrag.
    • type: Der Typ des DNS-Eintrags, der der Anwendung zugeordnet ist. Ein gültiger Wert ist „ CNAME “.
• Die optionalen Felder sind origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls und traffic_type.
  • origin_direct: Eine Liste von Zieladressen zum Absender.
  • origin_dns: Methode und Parameter, die verwendet werden, um die Adresse des Ursprungsservers über DNS zu ermitteln.
    • name: Name des DNS-Eintrags.
  • origin_port: Der Zielhafen am Abfahrtsort.
  • proxy_protocol: Proxy-Protokoll zum Ursprungsserver aktivieren. Gültige Werte sind on, off, v1, v2, simple. Der Standardwert ist off. Veraltet. Der Wert on entspricht v1.
  • ip_firewall steuerung, ob die IP-Firewall für diese Anwendung aktiviert ist. Gültige Werte sind on und off.
  • edge_ips: Die Anycast-Edge-IP-Konfiguration für den Hostnamen dieser Anwendung.
    • type: Die Art der angegebenen Edge-IP-Konfiguration. Dynamisch zugeordnete Edge-IPs verwenden Anycast-IPs je nach der von Ihnen angegebenen Konnektivität. Ein gültiger Wert ist „ dynamic “.
    • connectivity: Die IP-Versionen, die für eingehende Verbindungen bei Anycast-IP-Adressen unterstützt werden. Gültige Werte sind all, ipv4 und ipv6.
  • tls: Der Typ der TLS-Beendigung, die der Anwendung zugeordnet ist. Gültige Werte sind off, flexible, full und strict.
  • traffic_type: Legt fest, wie Daten vom Edge zu Ihrem Ursprung übertragen werden. Bei der Einstellung „ direct “ leitet „range“ den Datenverkehr direkt an Ihren Ursprungsserver weiter, und der Anwendungstyp wird aus dem Protokoll abgeleitet. Wenn die Einstellung auf „ http “ oder „ https “ gesetzt ist, wendet „range“ die Funktionen von „ CIS “ ( HTTP / HTTPS ) an, da der Datenverkehr an Ihren Ursprungsserver weitergeleitet wird und der Anwendungstyp genau mit dieser Eigenschaft übereinstimmt. Gültige Werte sind direct, http und https. Der Standardwert ist direct.