Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez une application d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertoriez toutes les applications d'accès pour les domaines 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-apps DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Affichez les détails d'une application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

--name

Nom de l'application. Obligatoire.

--domain

Le domaine et le chemin d'accès bloqués par Access. Obligatoire.

--session-duration

Définit la durée de validité des jetons émis pour cette application. Les valeurs valides sont 30m, 6h, 12h, 24h, 168het 730h.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour l'application d'accès a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez une application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Nom du certificat. Obligatoire.

--ca-cert-file

Fichier CA racine de vos certificats. Obligatoire.

--associated-hostnames

Les noms d'hôte pour lesquels ce certificat est requis.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Créez un certificat d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertoriez tous les certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Affichez les détails du certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

--name

Nom du certificat. Obligatoire.

--associated-hostnames

Les noms d'hôte pour lesquels ce certificat est requis. Obligatoire.

Les noms d'hôte associés sont réinitialisés s'ils ne sont pas spécifiés par associated-hostnames.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour le certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez le certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenez les paramètres des certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-f, --feature

Fonction des paramètres des certificats. Valeurs valides :

client_certificate_forwarding

Le contenu du certificat client et sa signature « SHA256 » sont transmis aux serveurs d'origine via les en-têtes « CF-Client-Cert-DER_BASE64 » et « CF-Client-Cert-SHA256 ».

-v, --value

Valeur appliquée à la fonction pour les certificats.

client_certificate_forwarding

Indiquez le nom d'hôte pour lequel le certificat client doit être transféré ou non. Par exemple, -v host1=on,host2=on,host3=off.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour les paramètres des certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

--name

Nom de la stratégie. Obligatoire.

--decision

Définit l'action que prend Access si la stratégie s'applique à l'utilisateur. La valeur valide est « non_identity ». Obligatoire.

--include

Règle incluse de la stratégie. Les valeurs valides sont certificate et common_name. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez une politique d'accès pour l'application a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertoriez toutes les stratégies d'accès pour l'application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

ACCESS_POLICY_ID

L'identifiant de la politique d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Affichez les détails de la stratégie d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

ACCESS_POLICY_ID

L'identifiant de la politique d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez la stratégie d'accès 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--all

Purge de tous les fichiers en cache. Cette option est mutuellement exclusive avec --file.

--file

Supprimez un ou plusieurs fichiers de façon granulaire en indiquant des URL. Cette option est mutuellement exclusive avec --all.

--tag

Supprimez un ou plusieurs fichiers de façon granulaire via le Cache-Tag associé. Cette option est mutuellement exclusive avec --all. Réservé aux formules Entreprise

--host

Supprimez un ou plusieurs fichiers de façon granulaire en indiquant l'hôte. Cette option est mutuellement exclusive avec --all. Réservé aux formules Entreprise

--prefix

Supprimez un ou plusieurs fichiers de façon granulaire via un préfixe. Cette option est mutuellement exclusive avec --all. Réservé aux formules Entreprise

-f, --force

Purge de tous les fichiers en cache sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Effacez tous les fichiers d'actifs mis en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenez les paramètres de mise en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--caching-level

Précisez dans quelles conditions d' URL s vous souhaitez fournir les ressources mises en cache à l'utilisateur. Les valeurs valables sont no-query-string, query-string-independent, et query-string-dependent.

• no-query-string: Fournit des ressources à partir du cache uniquement lorsqu'aucune chaîne de requête n'est présente.
• query-string-independent: Fournit la même ressource à tous les utilisateurs, quelle que soit la chaîne de requête.
• query-string-dependent: Fournit une ressource différente à chaque fois que la chaîne de requête change.

--browser-expiration

Précisez la durée pendant laquelle vous souhaitez que le navigateur conserve les ressources en cache.

• Les valeurs valides sont : respect-existing-header, 30s, 1M, 5M, 20M, 30M, 1h, 2h, 4h, 8h, 16h, 1d 3d, 8d, 16d, 1m, 6m et 1y.
• 30s, 1M, 5M et 20M ne sont disponibles que pour les instances des formules « Enterprise » ou « Security ».
• 30s signifie « 30 seconds ».
• 30M signifie « 30 minutes ».
• 1h signifie « 1 hour ».
• 1d signifie « 1 day ».
• 1m signifie « 1 month ».
• 1y signifie « 1 year ».

--development-mod

Ignorer tous les caches de périphérie et envoyer le trafic vers vos serveurs d'origine.

--serve-stale-content

Continuer à fournir du contenu mis en cache aux utilisateurs lorsque les serveurs d'origine sont hors ligne, même si ce contenu a expiré.

--query-string-sort: Dans le cache, CIS considère que les fichiers comportant les mêmes chaînes de requête sont identiques, quel que soit l'ordre dans lequel ces chaînes apparaissent.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour les paramètres de mise en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists lists

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists list LIST_ID --output json

Options de commande

--kind

Type de liste personnalisée. Les valeurs valables sont ip, asn, et hostname.

--name

Le nom de la liste.

--description

Description de la liste.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

kind: Type de liste personnalisée. Les valeurs valables sont ip, asn, et hostname.

name nom de la liste : Le nom de la liste.

Le champ facultatif est le suivant :

"description": Description de la liste.

Exemple de données JSON :

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

Exemples

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

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--description

Décrivez brièvement la liste.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Le champ facultatif est le suivant :

"description": Pour décrire brièvement cette liste.

Exemple de données JSON :

  {
    "description": "string"
  }

Exemples

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

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

Exemple

ibmcloud cis custom-lists list-delete LIST_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists items LIST_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

ITEM_ID

L'ID de l'élément de liste personnalisé.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--asn

La valeur de l'ASN.

--ip

L'adresse de l' IPv4.

--hostname

Nom de l'hôte.

--comment

Fournir un bref commentaire sur le point.

-i, --instance

Nom ou ID de l'instance. Si l'instance ou l'ID n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste d'éléments de liste personnalisés à créer.

asn: L'ASN.

hostname: Le nom d'hôte.

ip l'adresse IPv4: L'adresse.

comment le Président : Il s'agit de formuler un bref commentaire sur le point de l'ordre du jour.

Exemple de données JSON :

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

Exemples de commande

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

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste d'éléments de liste personnalisés à créer.

asn: La valeur de l'ASN.

hostname: Le nom d'hôte.

ip l'adresse IPv4: L'adresse.

comment le Président : Il s'agit de formuler un bref commentaire sur le point de l'ordre du jour.

Exemple de données JSON :

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

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

--output value

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

-i, --instance

Nom ou ID de l'instance. Si la valeur ou l'ID de l'instance n'est pas définie, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

Exemple

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--item-id

CUSTOM_LIST_ITEM_ID est l'ID de l'élément de la liste personnalisée.

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste des éléments de la liste personnalisée à supprimer par ID.

id iD : ID unique de l'élément de la liste personnalisée.

Exemple de données JSON :

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

Exemples

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

Options de commande

OPERATION_ID

L'ID de l'opération de liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists operation OPERATION_ID --output json

Options de commande

PAGE_ID

Nom du type de page personnalisée. Les valeurs valides sont : basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Champ obligatoire.

PAGE_URL

URL associée à la page personnalisée. Par exemple, http://www.example.com/example.html. La valeur default indique qu'il faut utiliser la page par défaut. Obligatoire.

-d, --domain

ID domaine DNS.

-i,- --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour la page basic_challenge pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

PAGE_ID

Nom du type de page personnalisée. Les valeurs valides sont : basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors et 500_errors. Obligatoire.

-d, --domain

ID domaine DNS.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenez la page basic_challenge pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Options de commande

-d, --domain

ID domaine DNS.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Liste des pages personnalisées existantes pour le domaine DNS_DOMAIN_ID.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Nom de l'enregistrement DNS.

--type

Type de l'enregistrement DNS.

--content

Contenu de l'enregistrement DNS.

--ttl

Durée de vie de l'enregistrement DNS. La valeur 1 correspond à « automatic ». La valeur par défaut est 1.

--proxied

Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Le proxy ne gère le trafic que pour les enregistrements A, AAAA et CNAME. Les valeurs admises sont true et false.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un enregistrement DNS. Les types d'enregistrement DNS pris en charge sont : A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA et PTR.

• Pour les modèles A, AAAA, CNAME, NS, TXT:
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont ttl et proxied:
    • proxied Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Les proxys ne transmettent que le trafic correspondant aux enregistrements A, AAAA et CNAME.

Exemple de données JSON :

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

• Pour le type « PTR » :
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • La zone facultative est ttl.

Exemple de données JSON :

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

• Pour le type « MX » :
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont « ttl » et « priority ».

Exemple de données JSON :

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

• Pour le type « LOC » :
  • Les zones obligatoires dans les données JSON sont name, type, data :
    • data:
      • lat_degrees: Degrés de latitude.
      • lat_minutes: Minutes de latitude
      • lat_seconds: Secondes de latitude.
      • lat_direction: Direction de la latitude.
      • long_degrees: Degrés de longitude.
      • long_minutes: Minutes de longitude.
      • long_seconds: Secondes de longitude.
      • long_direction: Direction de la longitude.
      • altitude: Altitude du lieu, en mètres.
      • size: Dimensions du site en mètres.
      • precision_horz: Précision horizontale de la localisation.
      • precision_vert: Précision verticale de la localisation.
    • La zone facultative est ttl.

Exemple de données JSON :

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

• Pour le type « SRV » :
  • Les zones obligatoires dans les données JSON sont type, data :
    • data: - service: un type de service, précédé d'un trait de soulignement. - proto: un protocole valide. - priority: Priorité. - weight: Le poids record. - port: le port du service. - target: un nom d'hôte valide.
    • La zone facultative est ttl.

Exemple de données JSON :

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

• Pour le type CAA :
  • Les champs obligatoires dans les données JSON sont : name, type et data.
  • La zone facultative est ttl.

Exemple de données JSON :

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

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un enregistrement DNS.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez un enregistrement DNS dans le domaine 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"

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

--name

Nom de l'enregistrement DNS.

--type

Type de l'enregistrement DNS.

--content

Contenu de l'enregistrement DNS.

--ttl

Durée de vie de l'enregistrement DNS. La valeur 1 correspond à « automatic ». La valeur par défaut est 1.

--proxied

Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Le proxy ne gère le trafic que pour les enregistrements A, AAAA et CNAME. Les valeurs admises sont true et false.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un enregistrement DNS. Les types d'enregistrement DNS pris en charge sont : A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA et PTR.

• Pour les modèles A, AAAA, CNAME, NS, TXT:
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont « ttl » et « proxied » :
    • proxied Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Les proxys ne transmettent que le trafic correspondant aux enregistrements A, AAAA et CNAME.

Exemple de données JSON :

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

• Pour le type « PTR » :
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • La zone facultative est ttl.

Exemple de données JSON :

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

• Pour le type « MX » :

  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont « ttl » et « priority ».

  Exemple de données JSON :

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

• Pour le type « LOC » :

  • Les zones obligatoires dans les données JSON sont name, type, data :
    • data:
      • lat_degrees: Degrés de latitude.
      • lat_minutes: Minutes de latitude
      • lat_seconds: Secondes de latitude.
      • lat_direction: Direction de la latitude.
      • long_degrees: Degrés de longitude.
      • long_minutes: Minutes de longitude.
      • long_seconds: Secondes de longitude.
      • long_direction: Direction de la longitude.
      • altitude: Altitude du lieu, en mètres.
      • size: Dimensions du site en mètres.
      • precision_horz: Précision horizontale de la localisation.
      • precision_vert: Précision verticale de la localisation.
  • La zone facultative est ttl.

  Exemple de données JSON :

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

• Pour le type « SRV » :

  • Les zones obligatoires dans les données JSON sont type, data :
    • data:
      • service: Un type de service, précédé d'un trait de soulignement.
      • proto: Un protocole valide.
      • priority: Priorité.
      • weight: Le poids record.
      • port: Le port du service.
      • target: Un nom d'hôte valide.
  • La zone facultative est ttl.

  Exemple de données JSON :

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

• Pour le type « CAA » :

  • Les champs obligatoires dans les données JSON sont : name, type, data
  • La zone facultative est ttl.

  Exemple de données JSON :

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

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un enregistrement DNS.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettre à jour un enregistrement DNS dans le domaine 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"

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir les détails de l'enregistrement DNS dans le domaine DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer un enregistrement DNS dans le domaine DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--type

Type d'enregistrements DNS à afficher.

--name

Valeur de zone de nom pour le filtrage.

--content

Valeur de zone de contenu pour le filtrage.

--page

Nombre de pages de résultats paginés.

--per_page

Nombre maximal d'enregistrements DNS par page.

--order

Champ permettant de trier la liste des enregistrements DNS. Les valeurs valides sont : type, name, content, ttl et proxied.

--direction

Ordre de tri des résultats (par ordre croissant ou décroissant). Les valeurs valides sont asc et desc.

--match

Indique s'il faut trouver une correspondance avec tous les paramètres de recherche ou au moins l'un d'entre eux. Les valeurs valides sont any et all.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier tous les enregistrements DNS du domaine DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--file

Configuration BIND à importer. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Importer la configuration BIND dans le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--file

Le fichier de configuration BIND dans lequel sont enregistrés les enregistrements DNS exportés.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Exporter la configuration BIND pour le domaine DNS_DOMAIN_ID.

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

Options de commande

type

Indiquez la configuration de type de domaine. Les valeurs valables sont full et partial ( full par défaut).

• full: Une zone complète signifie que le DNS est hébergé.
• partial: Une zone partielle implique un domaine configuré avec un enregistrement CNAME.

jump-start

Tenter automatiquement d'extraire les enregistrements DNS existants.

DNS_DOMAIN_NAME

Le nom de domaine complet (FQDN) du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Ajouter un domaine DNS_DOMAIN_NAME.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Reprenez le domaine spécifié.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Suspendez le domaine spécifié.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Affichez les détails du domaine spécifié.

ibmcloud cis domain DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez le domaine spécifié.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Liste des domaines pour l'instance de service.

ibmcloud cis domains

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Effectuez une vérification d'activation sur le domaine spécifié.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-g, --group

Afficher les fonctions d'un même groupe. Les valeurs valides pour « group » sont : all, domain, reliability, performance et security. Cette option est mutuellement exclusive avec -f, --feature.

-f, --feature

Fonction des paramètres de domaine à contrôler. Cette option est mutuellement exclusive avec g, --group. Les valeurs admises sont les suivantes :

• always_use_https: Rediriger toutes les requêtes utilisant le schéma http vers https. Ce paramètre s'applique à toutes les requêtes de type « HTTP » adressées au domaine.
• automatic_https_rewrites: Pour corriger les problèmes de contenu mixte, remplacez http par https pour toutes les ressources ou tous les liens de votre site web pouvant être accessibles via HTTPS.
• bot_management: Détectez et limitez le trafic généré par les bots sur votre domaine.
• brotli: Lorsque le client qui demande un fichier prend en charge l'algorithme de compression Brotli, CIS fournit une version de ce fichier compressée au format Brotli.
• browser_check: Analysez les en-têtes « HTTP » provenant du navigateur de vos visiteurs afin de détecter d'éventuelles menaces. Si une menace est détectée, une page de blocage est alors envoyée.
• challenge_ttl: Indiquez pendant combien de temps un visiteur dont l'adresse IP a une mauvaise réputation est autorisé à accéder à votre site web après avoir réussi un test de vérification.
• ciphers: Une liste blanche de algorithmes de chiffrement pour la terminaison « TLS », au format « BoringSSL ». Cette commande répertorie les chiffrements autorisés par les clients. Si aucun algorithme de chiffrement n'est autorisé, la liste est vide et les algorithmes par défaut sont utilisés. Voir Suites de chiffrement Edge et Suites de chiffrement Origin pour la liste des chiffrements par défaut.
• cname_flattening: Suivre un enregistrement CNAME jusqu'à la destination vers laquelle il pointe et renvoyer cette adresse IP à la place de l'enregistrement CNAME. Par défaut, seul le CNAME situé à la racine de votre domaine est aplati.
• domain_hold: Les verrous de domaine empêchent les équipes de votre organisation d'ajouter des domaines déjà actifs dans un autre compte. Réservé aux formules Entreprise
• email_obfuscation les adresses électroniques de votre page web sont cryptées pour les protéger contre les robots, tout en restant visibles pour les humains.
• opportunistic_onion: Permettez aux utilisateurs légitimes du navigateur Tor d'accéder à vos sites web.
• hotlink_protection: Protégez vos images contre les liens externes.
• http2: Accélérez votre site web avec HTTP/2.
• http3: Accélérez votre site web avec HTTP/3.
• image_load_optimization: Déclassé. améliore le temps de chargement des pages comportant des images sur les appareils mobiles ayant des connexions réseau lentes
• image_size_optimization: Améliorez le temps de chargement des images en optimisant celles hébergées sur votre domaine.
• image_resizing le réseau CIS permet de redimensionner, de convertir et d'optimiser à la demande les images servies par le réseau.
• ip_geolocation: Indiquez le code pays correspondant à la localisation du visiteur dans toutes les requêtes adressées à votre site web.
• ipv6: Activer la prise en charge d' IPv6 et de la passerelle.
• max_upload: Le nombre de visiteurs pouvant télécharger des données sur votre site web en une seule requête.
• min_tls_version: N'autoriser que les connexions HTTPS provenant de visiteurs prenant en charge la version sélectionnée du protocole TLS ou une version plus récente.
• minify: Réduisez la taille des fichiers de code source sur votre site web.
• mobile_redirect: Rediriger les visiteurs qui utilisent des appareils mobiles vers un site web adapté aux mobiles.
• opportunistic_encryption: Le chiffrement opportuniste permet aux navigateurs de bénéficier des performances améliorées du protocole HTTP/2 en leur indiquant que votre site est accessible via une connexion chiffrée.
• origin_error_page_pass_thru: Lorsque la page d'erreur d'origine est définie sur On, CIS redirige les pages d'erreur 502 et 504 directement depuis l'origine. Réservé aux formules Entreprise
• origin_max_http_version: Configurez la version d' HTTP r sur « Origin ».
• origin_post_quantum_encryption: Indique à CIS d'utiliser des algorithmes de négociation de clés post-quantiques (PQ) lorsqu'il se connecte à votre source.
• prefetch_preload: CIS précharge toutes les URL incluses dans l'en-tête prefetch HTTP. Réservé aux formules Entreprise
• pseudo_ipv4: Ajoute un en-tête « IPv4 » aux requêtes lorsqu'un client utilise « IPv6 », mais que le serveur ne prend en charge que « IPv4 ».
• response_buffering: Active ou désactive la mise en mémoire tampon des réponses provenant du serveur d'origine. Réservé aux formules Entreprise
• script_load_optimization: Améliorer le temps de rendu des pages contenant JavaScript.
• security_header: Mettez en place une politique de sécurité Web pour votre site.
• security_level: Choisissez le profil de sécurité adapté à votre site web.
• server_side_exclude: Masquer automatiquement certains contenus aux visiteurs suspects.
• tls_client_auth: Certificat client « TLS » présenté à des fins d'authentification lors de la requête vers le serveur d'origine. Réservé aux formules Entreprise
• true_client_ip_header: La commande « CIS » envoie l'adresse IP de l'utilisateur dans l'en-tête « True-Client-IP ». Réservé aux formules Entreprise
• waf: Un pare-feu d'application Web (WAF) bloque les requêtes contenant du contenu malveillant.
• websockets: Autoriser les connexions WebSockets vers votre serveur d'origine.
• proxy_read_timeout: Durée maximale entre deux opérations de lecture à partir de l'origine. Réservé aux formules Entreprise
• url_normalization: Modifier les URL des requêtes entrantes.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir les paramètres d' ciphers pour le domaine DNS_DOMAIN_ID.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-f, --feature

Fonctionnalité des paramètres de domaine à mettre à jour. Obligatoire. Valeurs valides :

• always_use_https: Rediriger toutes les requêtes utilisant le schéma http vers https. Cette redirection s'applique à toutes les requêtes HTTP adressées à ce domaine.
• automatic_https_rewrites: Pour corriger les problèmes de contenu mixte, remplacez http par https pour toutes les ressources ou tous les liens de votre site web pouvant être accessibles via HTTPS.
• bot_management: Détectez et limitez le trafic généré par les bots sur votre domaine.
• brotli: Lorsque le client qui demande un fichier prend en charge l'algorithme de compression Brotli, CIS fournit une version de ce fichier compressée au format Brotli.
• browser_check: Analysez les en-têtes « HTTP » provenant du navigateur de vos visiteurs afin de détecter d'éventuelles menaces. Si une menace est détectée, une page de blocage est alors envoyée.
• challenge_ttl: Indiquez pendant combien de temps un visiteur dont l'adresse IP a une mauvaise réputation est autorisé à accéder à votre site web après avoir réussi un test de vérification.
• ciphers: Liste de chiffrement autorisée pour la terminaison de TLS. Ces chiffrements doivent être au format BoringSSL.
• cname_flattening: Suivre un enregistrement CNAME jusqu'à la destination vers laquelle il pointe et renvoyer cette adresse IP à la place de l'enregistrement CNAME. Par défaut, mettez uniquement à plat le CNAME à la racine de votre domaine.
• domain_hold: Les verrous de domaine empêchent les équipes de votre organisation d'ajouter des domaines déjà actifs dans un autre compte. Réservé aux formules Entreprise
• email_obfuscation les adresses électroniques de votre page web sont cryptées pour les protéger contre les robots, tout en restant visibles pour les humains.
• opportunistic_onion: Permettez aux utilisateurs légitimes du navigateur Tor d'accéder à vos sites web.
• hotlink_protection: Protégez vos images contre les liens externes.
• http2: Accélérez votre site web avec HTTP/2.
• http3: Accélérez votre site web avec HTTP/3.
• image_load_optimization: Déclassé. améliore le temps de chargement des pages comportant des images sur les appareils mobiles ayant des connexions réseau lentes
• image_size_optimization: Améliorez le temps de chargement des images en optimisant celles hébergées sur votre domaine.
• image_resizing le réseau CIS permet de redimensionner, de convertir et d'optimiser à la demande les images servies par le réseau.
• ip_geolocation: Indiquez le code pays correspondant à la localisation du visiteur dans toutes les requêtes adressées à votre site web.
• ipv6: Activer la prise en charge d' IPv6 et de la passerelle.
• max_upload: Le nombre de visiteurs pouvant télécharger des données sur votre site web en une seule requête.
• min_tls_version: N'autoriser que les connexions HTTPS provenant de visiteurs prenant en charge la version sélectionnée du protocole TLS ou une version plus récente.
• minify: Réduisez la taille des fichiers de code source sur votre site web.
• mobile_redirect: Rediriger les visiteurs qui utilisent des appareils mobiles vers un site web adapté aux mobiles.
• opportunistic_encryption: Le chiffrement opportuniste permet aux navigateurs de bénéficier des performances améliorées du protocole HTTP/2 en leur indiquant que votre site est accessible via une connexion chiffrée.
• origin_error_page_pass_thru: Lorsque la page d'erreur d'origine est définie sur On, CIS redirige les pages d'erreur 502 et 504 directement depuis l'origine. Réservé aux formules Entreprise
• origin_max_http_version: Configurez la version d' HTTP r sur « Origin ».
• origin_post_quantum_encryption: Indique à CIS d'utiliser des algorithmes de négociation de clés post-quantiques (PQ) lorsqu'il se connecte à votre source.
• prefetch_preload: CIS précharge toutes les URL incluses dans l'en-tête prefetch HTTP. Réservé aux formules Entreprise
• pseudo_ipv4: Ajoute un en-tête « IPv4 » aux requêtes lorsqu'un client utilise « IPv6 », mais que le serveur ne prend en charge que « IPv4 ».
• response_buffering: Active ou désactive la mise en mémoire tampon des réponses provenant du serveur d'origine. Réservé aux formules Entreprise
• script_load_optimization: Améliorer le temps de rendu des pages contenant JavaScript.
• security_header: Mettez en place une politique de sécurité Web pour votre site.
• security_level: Choisissez le profil de sécurité adapté à votre site web.
• server_side_exclude: Masquer automatiquement certains contenus aux visiteurs suspects.
• tls_client_auth: Certificat client « TLS » présenté à des fins d'authentification lors de la requête vers le serveur d'origine. Réservé aux formules Entreprise
• true_client_ip_header: La commande « CIS » envoie l'adresse IP de l'utilisateur dans l'en-tête « True-Client-IP ». Réservé aux formules Entreprise
• waf: Un pare-feu d'application Web (WAF) bloque les requêtes contenant du contenu malveillant.
• websockets: Autoriser les connexions WebSockets vers votre serveur d'origine.
• proxy_read_timeout: Durée maximale entre deux opérations de lecture à partir de l'origine.
• url_normalization: Modifier les URL des requêtes entrantes.

-v, --value

Valeur définie avec la fonction pour le domaine. Obligatoire.

• Les valeurs valides pour « always_use_https » sont « on » et « off ».

• Les valeurs valides pour « automatic_https_rewrites » sont « on » et « off ».

• Les valeurs valides pour bot_management sont « use_latest_model », « fight_mode », « session_score », « enable_js ». Par exemple, -v fight_mode=true,session_score=true

  • use_latest_model: Permet d'activer ou non la dernière version du modèle. Les valeurs valides pour « use_latest_model » sont « true » et « false ».
  • fight_mode mode de combat : Permet d'activer ou non le mode de combat. Les valeurs valides pour « fight_mode » sont « true » et « false ».
  • session_score: Permet d'activer ou non le score de la session. Les valeurs valides pour « session_score » sont « true » et « false ».
  • enable_js: Permet d'activer les détections de JavaScript. Les valeurs valides pour « enable_js » sont « true » et « false ».

• Les valeurs valides pour « browser_check » sont « on » et « off ».

• Les valeurs valides pour challenge_ttl sont 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• Les valeurs valides pour cname_flattening sont flatten_at_root, flatten_all.

  • flatten_at_root: Supprimer le CNAME au niveau du domaine racine. Cette valeur est la valeur par défaut.
  • flatten_all: Supprimez tous les enregistrements CNAME de votre domaine.

• Les valeurs valables pour domain_hold sont hold, include_subdomains et hold_after.

  • hold: Permet d'activer ou non la mise en attente du domaine. Les valeurs valides pour « hold » sont « true » et « false ».
  • include_subdomains: Activer ou non la suspension du domaine. Les valeurs valides pour « include_subdomains » sont « true » et « false ».
  • hold_after: Si l'option « hold_after » est spécifiée, la mise en attente est temporairement désactivée, puis automatiquement réactivée par le système à l'heure indiquée.

  Pour activer le domaine et les sous-domaines, rendez-vous sur : -v hold=true,include_subdomains=true. Pour désactiver la mise en attente du domaine : -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• Les valeurs valides pour hotlink_protection sont on, off.

• Les valeurs valides pour email_obfuscation sont on, off.

• Les valeurs valides pour opportunistic_onion sont on, off.

• Les valeurs valides pour http2 sont on, off.

• Les valeurs valides pour http3 sont on, off.

• Obsolète. Les valeurs valides pour image_load_optimization sont on, off.

• Les valeurs valides pour image_resizing sont on, off.

• Les valeurs valides pour image_size_optimization sont off, lossless, lossy.

  • off : désactive l'optimisation de la taille d'image.
  • lossless: Réduire la taille des fichiers image sans altérer la qualité visuelle.
  • lossy: La taille des fichiers JPEG est réduite grâce à une compression avec perte, ce qui peut entraîner une baisse de la qualité visuelle.

• Les valeurs valides pour ip_geolocation sont on, off.

• Les valeurs valides pour ipv6 sont on, off.

• Les valeurs valides (en Mo) pour max_upload sont les suivantes : 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Réservé aux formules Entreprise

• Les valeurs valides pour min_tls_version sont 1.0, 1.1, 1.2, 1,3.

• Les valeurs valides pour minify sont css, html, js. Par exemple, -v css=on,html=off,js=on

  • css: Compressez automatiquement tout le code CSS de votre site web. Les valeurs valides pour css sont on, off.
  • html: Optimiser automatiquement tout le code HTML de votre site web. Les valeurs valides pour html sont on, off.
  • js: Minifier automatiquement tout le code JS de votre site web. Les valeurs valides pour js sont on, off.

• Les valeurs valides pour mobile_redirect sont status, mobile_subdomain, strip_uri. Par exemple, -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Indique si la redirection vers les appareils mobiles est activée. Les valeurs valides pour « status » sont « on » et « off ».
  • mobile_subdomain: Vers quel préfixe de sous-domaine souhaitez-vous rediriger les visiteurs sur appareils mobiles (le sous-domaine doit exister)?
  • strip_uri: Il s'agit de déterminer s'il faut abandonner le chemin d'accès actuel de la page et rediriger vers la racine du sous-domaine mobile URL. Les valeurs valides pour strip_uri sont true, false.

• Les valeurs valides pour opportunistic_encryption sont on, off.

• Les valeurs valides pour origin_error_page_pass_thru sont 1, 2.

• Les valeurs valides pour origin_max_http_version sont supported, preferred, off.

  • supported: Les algorithmes post-quantiques sont mis en avant, mais ne sont utilisés que lorsque l'expéditeur en fait la demande.
  • preferred: L'option « Preferred » indique à CIS d'envoyer, si l'occasion se présente, un partage de clés post-quantique (PQ) dans le premier message adressé à la source (pour les connexions les plus rapides lorsque la source prend en charge et privilégie le PQ).
  • off: Les algorithmes post-quantiques ne font pas l'objet d'une promotion.

• Les valeurs valides pour origin_post_quantum_encryption sont on, off.

• Les valeurs valides pour brotli sont on, off.

• Les valeurs valides pour prefetch_preload sont on, off.

• Les valeurs valides pour pseudo_ipv4 sont off, add_header, overwrite_header.

  • off : désactive Pseudo IPv4.
  • add_header: Ajouter uniquement un en-tête « Cf-Pseudo-IPv4 » supplémentaire.
  • overwrite_header : remplace les en-têtes Cf-Connecting-IP et X-Forwarded-For existants par une pseudo adresse IPv4.

• Les valeurs valides pour response_buffering sont on, off.

• Les valeurs valides pour script_load_optimization sont on, off.

• Les valeurs valides pour security_header sont enabled, max_age, include_subdomains, preload, nosniff. Par exemple, -v enabled=true,max_age=100,include_subdomains=true,preload=true,nosniff=true

  • enabled: L'en-tête de sécurité est activé ou non. Les valeurs valides pour enabled sont true, false.
  • max_age: Indiquez la durée (en secondes) pendant laquelle les en-têtes de sécurité sont mis en cache dans les navigateurs.
  • include_subdomains: Chaque domaine situé sous ce domaine hérite du même en-tête de sécurité. Les valeurs valides pour include_subdomains sont true, false.
  • preload: Autoriser ou non les navigateurs à précharger la configuration « security_header ». Les valeurs valides pour enabled sont true, false.
  • nosniff: Indique s'il faut envoyer l'en-tête « X-Content-Type-Options: nosniff ». Les valeurs valides pour nosniff sont true, false.

• Les valeurs valides pour server_level sont off, essentially_off, low, medium, high, under_attack.

• Les valeurs valides pour server_side_exclude sont on, off.

• Les valeurs valides pour tls_client_auth sont on, off.

• Les valeurs valides pour true_client_ip_header sont on, off.

• Les valeurs valides pour waf sont on, off.

• Les valeurs valides pour websockets sont on, off.

• Valeurs valides pour proxy_read_timeout, 1-6000, par défaut : 100.

• Les valeurs valides pour ciphers sont 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. Par exemple, -v AES256-SHA256,AES256-SHA, en utilisant -v default pour réinitialiser les suites de chiffrement configurées à la valeur par défaut.

• Les valeurs valides pour url_normalization sont « type », « scope ». Par exemple, -v type=cis,scope=both

  • type: Permet de sélectionner le type de normalisation « URL » effectuée par CIS. Les valeurs valides pour type sont cis, rfc3986.
  • scope: Permet de définir la portée de la normalisation de l' URL. Les valeurs valides pour scope sont both, incoming.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Activer la fonctionnalité « tls_client_auth » pour le domaine DNS_DOMAIN_ID.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier toutes les actions des fonctions Edge.

ibmcloud cis edge-functions-actions

Options de commande

--name

Nom de l'action. Réservé aux formules Entreprise

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Afficher les détails de l'action « Edge Functions » ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Options de commande

--name

Nom de l'action. Réservé aux formules Entreprise

--javascript-str

Chaîne Javascript. Exemple: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Fichier Javascript.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez une action « Edge Functions ».

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

Options de commande

--name

Nom de l'action. Réservé aux formules Entreprise

--javascript-str

Chaîne Javascript. Exemple: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Fichier Javascript.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettre à jour une action Edge Functions.

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

Options de commande

--name

Nom de l'action. Réservé aux formules Entreprise

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Action « Supprimer les fonctions Edge » ACTION_NAME.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier tous les déclencheurs des fonctions Edge pour le domaine DNS_DOMAIN_ID.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Afficher les détails du déclencheur des fonctions Edge TRIGGER_ID.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PATTERN_URL

La requête URL, qui déclenche l'action. Obligatoire.

name

Nom de l'action à laquelle le déclencheur créé est associé. Réservé aux formules Entreprise

disable

Désactiver un déclencheur Edge Functions.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez un déclencheur Edge Functions pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

PATTERN_URL

La requête URL, qui déclenche l'action. Obligatoire.

name

Le nom de l'action à laquelle le déclencheur créé est associé. Réservé aux formules Entreprise

disable

Désactiver un déclencheur Edge Functions.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mise à jour : déclenchement des fonctions Edge TRIGGER_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer les déclencheurs des fonctions Edge TRIGGER_ID.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Options de commande

-t, --type

Type de règles de pare-feu à créer. Valeurs valides : access-rules, ua-rules, lockdowns. Champ obligatoire.

• access-rules : Les règles d'accès permettent d'autoriser, de soumettre à une demande authentification ou de bloquer des demandes vers votre site Web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules : Permet d'effectuer un contrôle d'accès en cas de correspondance avec l'agent utilisé signalé par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Cette option vous permet de personnaliser les paramètres d'accès à votre site.
• lockdowns : Permet de verrouiller l'accès aux URL de ce domaine uniquement aux adresses ou aux plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de pare-feu. Obligatoire.

• Pour plus d' --type access-rules s : les données JSON décrivant une règle d'accès du pare-feu sont les suivantes.
  • Les zones obligatoires sont mode, configuration.
    • mode: Le type d'action à effectuer. Les valeurs valides sont : block, challenge, whitelist et js_challenge.
    • configuration: Paire « cible/valeur » à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. Les valeurs valides sont : ip, ip_range, asn et country.
      • value: La valeur correspondant à la cible sélectionnée.
        • Pour « ip », la valeur correspond à une adresse IP valide.
        • Pour « ip_range », la valeur spécifie une plage d'adresses IP limitée à /16 et /24.
        • Pour « asn », la valeur correspond à un numéro AS.
        • Pour un pays, la valeur correspond au code pays de ce pays.
  • La zone d'option est notes.
    • notes: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

Exemple de données 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"
   }
}

• Pour plus d' --type ua-rules s : les données JSON décrivant une règle d'agent utilisateur sont les suivantes.
  • Les zones obligatoires sont mode, configuration.
    • mode: Le type d'action à effectuer. Les valeurs valables sont block, challenge, et js_challenge.
    • configuration: Paire « cible/valeur » à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. La valeur valide est « ua ».
      • value: La chaîne exacte UserAgent à faire correspondre avec cette règle.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

Exemple de données 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"
   }
}

• Pour --type lockdowns: Les données JSON qui décrivent une règle de verrouillage sont les suivantes.
  • Les zones obligatoires sont urls, configurations.
    • urls: URL à inclure dans la définition de cette règle.
      • Les caractères génériques sont acceptés.
      • Le masque d'URL saisi ici est mis en échappement avant utilisation.
      • Ce champ limite l' URL ation à des modèles simples utilisant des caractères génériques.
    • configurations: Liste des adresses IP ou des plages CIDR à utiliser pour cette règle.
      • Ce champ peut contenir un nombre illimité de configurations « ip » ou « ip_range » permettant d'accéder aux URL indiquées.
      • target: La propriété de la requête à cibler. Les valeurs valables sont ip, et ip_range.
      • value: adresses IP ou CIDR. Si la cible est de type « ip », la valeur doit être une adresse IP; dans le cas contraire, elle doit être au format CIDR.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

Exemple de données JSON :

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

Obsolète. Données JSON décrivant une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez des règles de pare-feu.

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

Options de commande

• FIREWALL_RULE_ID : ID de la règle de pare-feu. Obligatoire.

-t, --type

Le type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Vous pouvez ainsi personnaliser l'accès à votre site.
• lockdowns: Limiter l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de pare-feu. Obligatoire.

• Pour --type access-rules: Les données JSON qui décrivent une règle d'accès au pare-feu sont les suivantes.
  • Les zones d'option sont mode, notes.
    • mode: Le type d'action à effectuer. Les valeurs valides sont : block, challenge, whitelist et js_challenge.
    • notes: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

Exemple de données JSON :

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

• Pour --type ua-rules: Les données JSON qui décrivent une règle de user-agent sont les suivantes.

  • Les zones obligatoires sont mode, configuration.
    • mode: Le type d'action à effectuer. Les valeurs valables sont block, challenge, et js_challenge.
    • configuration: Paire « cible/valeur » à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. La valeur valide est « ua ».
      • value: La chaîne exacte UserAgent à faire correspondre avec cette règle.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

  Exemple de données 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"
   }
}

• Pour --type lockdowns: Les données JSON qui décrivent une règle de verrouillage sont les suivantes.
  • Les zones obligatoires sont urls, configurations.
    • urls: URL à inclure dans la définition de cette règle.
      • Les caractères génériques sont acceptés.
      • Le masque d'URL saisi ici est mis en échappement avant utilisation.
      • Ce champ limite l' URL ation à des modèles simples utilisant des caractères génériques.
    • configurations: Liste des adresses IP ou des plages CIDR à utiliser pour cette règle.
      • Ce champ peut contenir un nombre illimité de configurations « ip » ou « ip_range » permettant d'accéder aux URL indiquées.
      • target: La propriété de la requête à cibler. Les valeurs valables sont ip et ip_range.
      • value: adresses IP ou CIDR. Si la cible est de type « ip », la valeur doit être une adresse IP; dans le cas contraire, elle doit être exprimée au format CIDR.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle, afin de mieux en comprendre l'objectif.

Exemple de données JSON :

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

Obsolète. Les données JSON qui décrivent une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettez à jour les règles de pare-feu.

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

Options de commande

-t, --type

Le type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Cette action vous permet de personnaliser les droits d'accès à votre site.
• lockdowns: Limiter l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--page

Nombre de pages de résultats paginés. La valeur par défaut est 0.

--per-page

Nombre maximal de règles d'accès par page. La valeur minimale est 5. La valeur par défaut est 20.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertoriez les règles de pare-feu.

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

Options de commande

FIREWALL_RULE_ID

L'identifiant de la règle de pare-feu. Obligatoire.

-t, --type

Type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Vous pouvez ainsi personnaliser l'accès à votre site.
• lockdowns: Limiter l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenez les détails d'une règle de pare-feu.

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

Options de commande

FIREWALL_RULE_ID

L'identifiant de la règle de pare-feu. Obligatoire.

-t, --type

Type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Ce champ vous permet de personnaliser les droits d'accès à votre site.
• lockdowns: Limiter l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez une règle de pare-feu.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--page

Nombre de pages de résultats paginés. La valeur par défaut est 1.

--per-page

Nombre de règles de pare-feu par page. La valeur minimale est 5 et la valeur maximale est 100. La valeur par défaut est 25.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Liste des règles de pare-feu existantes dans le domaine DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Pour plus d'informations sur la règle de pare-feu « FIREWALL_RULE_ID », cliquez ici.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--expression

Expression de filtre. Par exemple, ip.src eq 93.184.216.0.

--action

Action de règle à effectuer. Les valeurs valides sont log, allow, challenge, js_challenge, blocket bypass.

--priority

Priorité de la règle. Les valeurs valides vont de 0 à 2147483647. La valeur « 0 » signifie « rétablir la valeur par défaut ».

--description

Pour décrire brièvement la règle.

--paused

Indique si la règle est active ou non. Les valeurs valides sont on et off. La valeur par défaut est off.

--products

Liste des produits de sécurité à contourner. Les valeurs valides sont : zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit et waf.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de pare-feu.

• Les champs obligatoires dans les données JSON sont « expression » et « action ».
  • expression: Une expression de filtrage. Par exemple, ip.src eq 93.184.216.0
  • action: L'action à effectuer dans le cadre de la règle. Les valeurs valides sont : log, allow, challenge, js_challenge, block et bypass.
• Les zones facultatives sont description, priority, paused, products.
  • description: Pour décrire brièvement la règle.
  • priority: La priorité de la règle. Les valeurs valides vont de 0 à 2147483647. La valeur « 0 » signifie « rétablir la valeur par défaut ».
  • paused: Indique si la règle est active ou non. Les valeurs valables sont on et off. La valeur par défaut est off.
  • products: La liste des produits de sécurité à contourner. Les valeurs valides sont : zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit et waf. Par exemple : --products, zoneLockdown, rateLimit

Exemple de données 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"
}

-s, --json-str

Obsolète. Les données JSON qui décrivent une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer une règle de pare-feu dans le domaine 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"}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

--expression

Expression de filtre. Par exemple, ip.src eq 93.184.216.0.

--action

Action de règle à effectuer. Les valeurs valides sont log, allow, challenge, js_challenge, blocket bypass.

--priority

Priorité de la règle. Les valeurs valides vont de 0 à 2147483647. La valeur « 0 » signifie « rétablir la valeur par défaut ».

--description

Pour décrire brièvement la règle.

--paused

Indique si la règle est active ou non. Les valeurs valides sont on et off. La valeur par défaut est off.

--products

Liste des produits de sécurité à contourner. Les valeurs valides sont : zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit et waf.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de pare-feu.

• Les champs obligatoires dans les données JSON sont : expression et action.
  • expression: Une expression de filtrage. Par exemple, ip.src eq 93.184.216.0
  • action: L'action à effectuer dans le cadre de la règle. Les valeurs valides sont : log, allow, challenge, js_challenge, block et bypass.
• Les zones facultatives sont description, priority, paused, products.
  • description: Pour décrire brièvement la règle.
  • priority: La priorité de la règle. Les valeurs valides vont de 0 à 2147483647. La valeur « 0 » signifie « rétablir la valeur par défaut ».
  • paused: Indique si la règle est active ou non. Les valeurs valables sont on et off. La valeur par défaut est off.
  • products: La liste des produits de sécurité à contourner. Les valeurs valides sont : zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit et waf. Par exemple : --products, zoneLockdown, rateLimit

Les champs description, priority, et paused, qui ne sont pas explicitement définis dans les données JSON sont remplacés par la valeur par défaut.

Exemple de données 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"
}

-s, --json-str

Obsolète. Les données JSON qui décrivent une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mise à jour de la règle de pare-feu 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"}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer la règle de pare-feu FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

EXPRESSION

L'expression de filtre. Par exemple, ip.src eq 93.184.216.0. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Valider l'expression de la règle de pare-feu.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un équilibreur de charge global. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, fallback_pool et default_pools:
  • name: Le nom d'hôte DNS à associer à votre équilibreur de charge.
  • fallback_pool: L'identifiant du pool à utiliser lorsque tous les autres pools sont détectés comme défaillants.
  • default_pools: Liste des identifiants de pools classés par ordre de priorité de basculement.
• Les zones facultatives sont description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy :
  • description: La description de votre équilibreur de charge.
  • ttl : durée de vie de l'entrée DNS pour l'adresse IP renvoyée par cet équilibreur de charge.
  • region_pools: Une correspondance entre les codes de région et de pays et une liste d'identifiants de pool (classés par ordre de priorité de basculement) pour la région.
  • proxied: Définissez si le trafic doit passer par les fonctions de sécurité et de performance sur CIS.
  • enabled: Activer ou non (par défaut) cet équilibreur de charge.
  • session_affinity le serveur d'arrière-plan : Il garantit que les demandes d'un utilisateur sont toujours dirigées vers le même serveur d'arrière-plan au cours d'une session. Les valeurs valables sont cookie et none.
  • session_affinity_ttl: Durée, en secondes, avant l'expiration du cookie d'affinité de session de cet équilibreur de charge après sa création. La valeur valide se situe entre [1800, 604800]. La valeur par défaut est 82800.
  • steering_policy: Les valeurs valides pour « steering_policy » sont : off, geo, random, dynamic_latency.
    • off: Utilisez default_pools.
    • geo: Utilisez region_pools/pop_pools.
    • random: Choisissez un groupe au hasard.
    • dynamic_latency: Utilisez le temps aller-retour pour sélectionner le pool le plus proche dans default_pools (nécessite des contrôles d'intégrité du pool).

Exemple de données JSON :

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

Obsolète. Données JSON décrivant un équilibreur de charge global.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez un équilibreur de charge global dans le domaine 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"]}}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant de l'équilibreur de charge global. Obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un équilibreur de charge global. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, fallback_pool et default_pools:
  • name: Le nom d'hôte DNS à associer à votre équilibreur de charge.
  • fallback_pool: L'identifiant du pool à utiliser lorsque tous les autres pools sont détectés comme défaillants.
  • default_pools: Liste des identifiants de pools classés par ordre de priorité de basculement.
• Les zones facultatives sont description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy :
  • description: La description de votre équilibreur de charge.
  • ttl: Durée de vie (TTL) de l'entrée DNS correspondant à l'adresse IP renvoyée par cet équilibreur de charge.
  • region_pools: Une correspondance entre les codes de région et de pays et une liste d'identifiants de pool (classés par ordre de priorité de basculement) pour la région.
  • proxied: Définissez si le trafic doit passer par les fonctions de sécurité et de performance sur CIS.
  • enabled: Activer ou non (par défaut) cet équilibreur de charge.
  • session_affinity le serveur d'arrière-plan : Il garantit que les demandes d'un utilisateur sont toujours dirigées vers le même serveur d'arrière-plan au cours d'une session. Les valeurs valables sont cookie et none.
  • session_affinity_ttl: Durée, en secondes, avant l'expiration du cookie d'affinité de session de cet équilibreur de charge, à compter de sa création. La valeur valide se situe entre [1800, 604800]. La valeur par défaut est 82800.
  • steering_policy: Les valeurs valides pour « steering_policy » sont : off, geo, random, dynamic_latency.
    • off: Utilisez default_pools.
    • geo: Utilisez region_pools/pop_pools.
    • random: Choisissez un groupe au hasard.
    • dynamic_latency: Utilisez le temps aller-retour pour sélectionner le pool le plus proche dans default_pools (nécessite des contrôles d'intégrité du pool).

Exemple de données JSON :

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

Obsolète. Données JSON décrivant un équilibreur de charge global.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettre à jour l'équilibreur de charge global GLB_ID dans le domaine 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"]}}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant de l'équilibreur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Afficher l' GLB_ID s relatives à l'équilibreur de charge global dans le domaine DNS_DOMAIN_ID.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant de l'équilibreur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer l'équilibreur de charge global GLB_ID dans le domaine DNS_DOMAIN_ID.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier les équilibreurs de charge pour le domaine DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Spécifier le format des sorties. Seul JSON est pris en charge.

Exemples

Liste de tous les pools GLB.

ibmcloud cis glb-pools

Options de commande

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un pool GLB. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, origins et check_regions:
  • name: Un nom court (balise) pour le pool.
  • origins: Une liste des origines comprises dans cet ensemble.
  • check_regions: Liste des codes de régions géographiques.
• Les zones facultatives sont description, minimum_origins, enabled, monitor.

Exemple de données JSON :

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

Obsolète. Données JSON utilisées pour décrire un pool GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer une réserve de GLB.

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

Options de commande

GLB_POOL_ID

L'identifiant du pool du répartiteur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Afficher les détails du pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool GLB_POOL_ID

Options de commande

GLB_POOL_ID

L'identifiant du pool du répartiteur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Options de commande

GLB_POOL_ID

L'identifiant du pool du répartiteur de charge global. Obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un pool GLB.

• Les champs obligatoires dans les données JSON sont name, origins et check_regions:
  • name: Un nom court (balise) pour le pool.
  • origins: Une liste des origines comprises dans cet ensemble.
  • check_regions: Liste des codes de régions géographiques.
• Les zones facultatives sont description, minimum_origins, enabled, monitor.

Exemple de données JSON :

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

Activer l'origine dans le pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

--disable-origin

Désactiver l'origine dans le pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

--add-origin

Ajouter une origine dans le pool. Les valeurs ORIGIN_NAME et ORIGIN_ADDRESS sont obligatoires. Par exemple, --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Retirer une origine du pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un pool GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mise à jour du pool GLB GLB_POOL_ID.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Dressez la liste de tous les moniteurs GLB.

ibmcloud cis glb-monitors

Options de commande

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un moniteur GLB. Obligatoire.

• La zone obligatoire dans les données JSON est type.
  • type: Le protocole à utiliser pour le bilan de santé. Les valeurs valables sont HTTP, HTTPS, et TCP.
• Les zones facultatives sont description, timeout, retries, interval.
  • description: Description.
  • timeout: Le délai d'attente (en secondes) avant de considérer le test de santé comme ayant échoué.
  • retries: Nombre de tentatives à effectuer en cas de délai d'attente avant de signaler que l'origine est en état d'erreur.
  • interval: L'intervalle entre chaque contrôle de santé.
• Pour le contrôle de santé de type TCP. La zone obligatoire supplémentaire est port.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
• Pour le contrôle de santé de type HTTP/HTTPS. Les zones facultatives supplémentaires sont port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
  • expected_body: Une sous-chaîne (sans distinction de majuscules/minuscules) à rechercher dans le corps de la réponse.
  • expected_codes: Code de réponse « HTTP » attendu ou plage de codes attendus pour le test de bon fonctionnement.
  • method: La méthode de l' HTTP à utiliser pour le contrôle d'intégrité.
  • path: Chemin d'accès au point de terminaison à soumettre au contrôle de santé.
  • header: Les en-têtes de requête HTTP à envoyer lors du test de santé.
  • follow_redirects: Suivre les redirections si elles sont renvoyées par le serveur d'origine.
  • allow_insecure: Ne validez pas le certificat lorsque le moniteur utilise HTTPS.
  • probe_zone: Configurez ce moniteur pour qu'il émule la zone spécifiée pendant la détection.

Exemple de données JSON :

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

Pour TCP :

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

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un moniteur GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer un contrôleur des GLB.

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

Options de commande

GLB_MON_ID

L'identifiant du moniteur du répartiteur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Afficher les détails du moniteur GLB GLB_MON_ID.

ibmcloud cis glb-monitor GLB_MON_ID

Options de commande

GLB_MON_ID

ID du moniteur d'équilibreur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le moniteur GLB GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Options de commande

GLB_MON_ID

L'identifiant du moniteur du répartiteur de charge global. Obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un moniteur GLB. Obligatoire.

• La zone obligatoire dans les données JSON est type.
  • type: Le protocole à utiliser pour le bilan de santé. Les valeurs valables sont HTTP, HTTPS, et TCP.
• Les zones facultatives sont description, timeout, retries, interval.
  • description: Description.
  • timeout: Le délai d'attente (en secondes) avant de considérer le test de santé comme ayant échoué.
  • retries: Nombre de tentatives à effectuer en cas de délai d'attente avant de signaler que l'origine est en état d'erreur.
  • interval: L'intervalle entre chaque contrôle de santé.
• Pour le contrôle de santé de type TCP. La zone obligatoire supplémentaire est port.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
• Pour le contrôle de santé de type HTTP/HTTPS. Les zones facultatives supplémentaires sont port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
  • expected_body: Une sous-chaîne (sans distinction de majuscules/minuscules) à rechercher dans le corps de la réponse.
  • expected_codes: Code de réponse « HTTP » attendu ou plage de codes attendus pour le test de bon fonctionnement.
  • method: La méthode de l' HTTP à utiliser pour le contrôle d'intégrité.
  • path: Chemin d'accès au point de terminaison à soumettre au contrôle de santé.
  • header: Les en-têtes de requête HTTP à envoyer lors du test de santé.
  • follow_redirects: Suivre les redirections si elles sont renvoyées par le serveur d'origine.
  • allow_insecure: Ne validez pas le certificat lorsque le moniteur utilise HTTPS.
  • probe_zone: Configurez ce moniteur pour qu'il émule la zone spécifiée pendant la détection.

Exemple de données JSON :

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

Pour TCP :

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

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un moniteur GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mise à jour du moniteur GLB GLB_MON_ID.

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

Options de commande

-s, --since

Date de début de la période des données demandées au format ISO8601. Par exemple,2018-11-26.

-u, --until

Date de fin de la période des données demandées au format ISO8601. Par exemple,2018-11-28.

--origin-name

Nom de l'origine pour laquelle filtrer.

--pool-name

Nom du pool pour lequel filtrer.

--origin-healthy

Si la valeur est vraie, filtrer les événements dont l'état de l'origine est « normal »; si la valeur est fausse, filtrer les événements dont l'état de l'origine est « anormal ». La valeur par défaut est « true » et les valeurs valides sont « true » et « false ».

--pool-healthy

Si la valeur est vraie, filtrer les événements pour lesquels l'état du pool est « sain »; si la valeur est fausse, filtrer les événements pour lesquels l'état du pool est « défaillant ». La valeur par défaut est « true » et les valeurs valides sont « true » et « false ».

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir des événements glb.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--fields

Définissez l'ensemble de champs à renvoyer.

• Ce champ doit être renseigné sous la forme d'une liste de valeurs séparées par des virgules, sans espaces, et tous les champs doivent être renseignés.
• L'ordre dans lequel les zones sont spécifiées n'a pas d'importance, et l'ordre des zones dans la réponse n'est pas défini.
• Les champs doivent être sensibles à la casse.

--filter

Filtres permettant d'explorer des événements spécifiques. Les filtres se composent de trois parties : la clé, l'opérateur et la valeur. Pour plus d'informations sur les opérateurs pris en charge, voir Utilisation des champs, des fonctions et des expressions.

--sample

Le taux d'échantillonnage des enregistrements défini par le client : « sample: 1 » correspond à 100 % des enregistrements.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

-h, --help

Obtenir de l'aide sur cette commande.

Exemples

Créer un journal instantané pour le domaine DNS_DOMAIN_ID:

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

Voici trois exemples de filtres :

• Filtrer lorsque le pays de l'adresse IP du client n'est pas le Canada :

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

• Filtre lorsque le code de statut renvoyé par CIS est 200 ou 201 :

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

• Filtrer lorsque le chemin de la requête contient « /static » et que le nom d'hôte de la requête est « example.com » :

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

-h, --help

Aide sur cette commande.

Exemple

Obtenir la tâche de journalisation instantanée pour le domaine DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--available-fields

Liste de toutes les zones disponibles.

--ray-id

Rechercher des journaux par ID Ray spécifique.

--fields

Définissez l'ensemble de champs à renvoyer. Ce champ doit être renseigné sous la forme d'une liste de valeurs séparées par des virgules, sans espaces, et tous les champs doivent être renseignés. L'ordre dans lequel les zones sont spécifiées n'a pas d'importance, et l'ordre des zones dans la réponse n'est pas défini. Notez que les zones sont censées être sensibles à la casse.

--start

Début (inclusif) de la période demandée. Il peut s'agir d'un horodatage unix (en secondes ou en nanosecondes) ou d'un horodatage absolu conforme à la norme RFC 3339. Actuellement, cette date ne peut pas remonter à plus de 7 jours. La valeur par défaut est de 65 minutes plus tôt.

--end

Fin (exclusive) de la période demandée. Cette valeur peut être un horodatage Unix (en secondes ou en nanosecondes) ou un horodatage absolu conforme à la norme RFC 3339. La date de fin (end) doit être au moins 5 minutes plus tôt que maintenant et ne doit pas être postérieure à la date de début (start). La différence entre start et end ne doit pas être supérieure à 1h. Par défaut, l'heure est avancée de 5 minutes.

--count

Nombre de journaux à récupérer. La valeur par défaut est -1.

--sample

Pourcentage d'échantillonnage. Lorsqu'un échantillon est fourni, un ensemble d'enregistrements correspondants est renvoyé. Si « sample=0.1 », alors 10 % des enregistrements sont renvoyés. L'échantillonnage est aléatoire : non seulement les requêtes répétées renvoient des enregistrements différents, mais le nombre d'enregistrements renvoyés est également susceptible de varier légèrement. Si count est également spécifié, il est appliqué au nombre d'enregistrements renvoyés, et non aux enregistrements échantillonnés. Ainsi, avec les requêtes sample=0.05 et count=7, lorsqu'il y a au total 100 enregistrements disponibles, environ 5 enregistrements sont renvoyés. Sur 1 000 enregistrements, 7 sont renvoyés. Sur 10 000 enregistrements, 7 sont renvoyés. La valeur par défaut est 1.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont unix, unixnano et rfc3339.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--destination

Spécifier une destination où les données sont poussées. Pour plus d'informations sur les destinations prises en charge, voir Gestion des tâches Logpush.

• Syntaxe du chemin d'accès à « Cloud Object Storage » : cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Exemple : 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Pour classer les fichiers journaux dans des sous-dossiers quotidiens, utilisez la chaîne spéciale « {DATE} » dans le chemin d'accès au compartiment. Elle est remplacée par la date au format « YYYYMMDD », par exemple «20190423». Des sous-dossiers sont créés selon les besoins, par exemple : 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Nom du travail. Obligatoire.

--enable

Activer la tâche. Par défaut, il est déactivé.

--fields

Définir la liste des zones de journal à inclure dans les fichiers journaux. Les champs multiples peuvent être séparés par des virgules; utilisez la commande [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] pour obtenir la liste complète des champs de journalisation disponibles, ou utilisez all pour inclure tous les champs disponibles dans les fichiers journaux. Notez que les zones sont censées être sensibles à la casse.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont unix, unixnano et rfc3339.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events, dns_logs. La valeur par défaut est http_requests.

--frequency

Fréquence à laquelle CIS envoie des lots de journaux à votre destination. Si vous réglez la fréquence sur un niveau élevé, vos journaux seront envoyés sous forme de fichiers plus petits mais en plus grand nombre. En réglant la fréquence sur « faible », les journaux sont envoyés en plus petites quantités, mais sous forme de fichiers plus volumineux. Les valeurs valides sont : high, low.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer une tâche logpush pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--destination

Spécifier une destination où les données sont poussées. Pour plus d'informations sur les destinations prises en charge, voir Gestion des tâches Logpush. Syntaxe du chemin d'accès à « Cloud Object Storage » : cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Exemple : 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Pour séparer les journaux en sous-dossiers quotidiens, utilisez la chaîne spéciale {DATE} dans le chemin du compartiment. Il faut la remplacer par la date au format « YYYYMMDD », par exemple «20190423». Des sous-dossiers sont créés selon les besoins, par exemple : 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Activer la tâche. Par défaut, il est déactivé.

--fields

Définir la liste des zones de journal à inclure dans les fichiers journaux. Les zones multiples peuvent être séparées par des virgules et vous pouvez utiliser la commande ibmcloud cis logpush-available-fields DNS_DOMAIN_ID pour obtenir la liste complète des zones de journal disponibles ou utiliser all pour inclure toutes les zones disponibles dans les fichiers journaux. Notez que les zones sont censées être sensibles à la casse.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont : unix, unixnano, rfc3339.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

--frequency

Fréquence à laquelle CIS envoie des lots de journaux à votre destination. Si vous réglez la fréquence sur un niveau élevé, vos journaux seront envoyés sous forme de fichiers plus petits mais en plus grand nombre. En réglant la fréquence sur « faible », les journaux sont envoyés en plus petites quantités, mais sous forme de fichiers plus volumineux. Les valeurs valides sont high et low.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mise à jour de la tâche logpush de range_events pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

-output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir tous les travaux de logpush pour le domaine DNS_DOMAIN_ID.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir les détails du travail de http_requests logpush.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

-f, --force

Supprimer la tâche « logpush » sans demander de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer http_requests logpush job for domain DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Obtenez toutes les zones disponibles pour les journaux http_requests.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir un paramètre de conservation des journaux pour le domaine DNS_DOMAIN_ID.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--flag

Activer ou désactiver la conservation des journaux. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Activer la conservation des journaux pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

Jeu de données demandé. La valeur par défaut est firewallEventsAdaptiveGroups.

Utilisez le tableau suivant pour identifier les jeux de données inclus dans votre plan et la plage de données d'historique que vous pouvez interroger.

Ensembles de données inclus dans votre plan

Jeu de données	Essai / Standard / Standard-Next	Entreprise / Sécurité / GLB
firewallEventsAdaptiveGroups	30 jours	30 jours
firewallEventsAdaptive	30 jours	30 jours

--filter

Filtrer les événements. La valeur par défaut correspond aux 6 dernières heures de données.

Les opérateurs suivants sont pris en charge pour toutes les options de filtre :

Opérateurs pris en charge pour les options de filtre

Opérateur	Comparaison
gt	supérieur à
il	inférieur à
geq	supérieur ou égal à
leq	inférieur à
neq	non égal
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

Ordre de tri. (La valeur par défaut est datetime_ASC)

La liste suivante répertorie les options de commande utilisables pour le fichier correspondant et toutes les options de commande prennent en charge les actions ASC et DESC. Combinez ces options de filtre et l'action avec _.

Par exemple, datetime_ASC trie les commandes par date et heure, par ordre croissant.

• Options d'ordre 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

Le nombre d'événements à renvoyer. (minimum : 1, maximum : 10000, par défaut : 10000)

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Accédez aux analyses des événements du pare-feu pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

Jeu de données demandé. La valeur par défaut est httpRequests1dGroups. Utilisez le tableau suivant pour identifier les jeux de données inclus dans votre plan et la plage de données d'historique que vous pouvez interroger.

Identifier les ensembles de données inclus dans votre plan

Jeu de données	Essai / Standard / Standard-next	Entreprise / Sécurité / GLB
httpRequests1dGroups	365 jours	365 jours
httpRequests1hGroups	30 jours	90 jours
httpRequests1mGroups	3 jours	7 jours

--filter

Filtrer les événements. La valeur par défaut correspond aux données des 7 derniers jours. Les opérateurs suivants sont pris en charge pour toutes les options de filtre :

Opérateurs pris en charge pour les options de filtre

Opérateur	Comparaison
gt	supérieur à
il	inférieur à
geq	supérieur ou égal à
leq	inférieur à
neq	non égal
in	in

• Options de filtre httpRequests1dGroups et httpRequests1hGroups.

  • date

• Options de filtre httpRequests1mGroups.

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Ordre de tri. (La valeur par défaut est datetime_ASC)

La liste suivante répertorie les options de commande utilisables pour le fichier correspondant et toutes les options de commande prennent en charge les actions ASC et DESC. Combinez ces options d'ordre et l'action avec _.

Par exemple, date_ASC classe les commandes par date, par ordre croissant.

• Options d'ordre communes à chaque jeu de données HTTP.
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Options d'ordre httpRequests1dGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Options d'ordre httpRequests1hGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Options d'ordre httpRequests1mGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

Le nombre d'événements à renvoyer. (minimum : 1, maximum : 10000, par défaut : 10000)

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenir les statistiques sur les requêtes HTTP pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--recent

Début de la période demandée. Les valeurs valides sont : 6h (il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine), 1m (il y a 1 mois), 2m, 3m. La valeur par défaut est 1w.

-t, --table

Sortie sous forme de table. Les valeurs valides sont : requests, bandwidth, uniques, threats et status_code. Si ce champ n'est pas défini, toutes les tables sont éditées.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Accédez aux statistiques d'audience du domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DIMENSION

La dimension interrogée. Les valeurs valides sont queries-by-response-code, queries-by-type, queries-by-name. Obligatoire.

-s, --since

Temps écoulé jusqu'à maintenant. Les valeurs valides sont : 6h (il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine).

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Accédez aux statistiques DNS du domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--recent

Début de la période demandée. Les valeurs valides sont : 6h (il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine), 1m (il y a 1 mois), 2m, 3m. La valeur par défaut est 1w.

--time-delta

Intervalle (en secondes) de l'enregistrement de chaque analyse. Les valeurs valides sont 60, 3600, 86400, 2592000. La valeur par défaut est 3600.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Obtenez des analyses sur les limites de débit pour le domaine DNS_DOMAIN_ID.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Activer la mutualisation TLS.

ibmcloud cis access-enable

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier tous les certificats d'origine pour le domaine DNS_DOMAIN_ID.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--request-type REQUEST_TYPE

Type de signature que vous souhaitez voir figurer sur le certificat. Les valeurs valides sont origin-rsa et origin-ecc.

--hostnames HOSTNAME

le nom d'hôte ou le nom générique lié au certificat.

--requested-validity DAYS

Le nombre de jours pendant lesquels le certificat doit être valide. La valeur par défaut est 5475.

--csr CSR

Demande de signature de certificat (CSR). Si ce champ n'est pas défini, CIS en génère un.

--json value*

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire un certificat d'origine.

• Les zones obligatoires dans les données JSON sont request_type, hostnames.
  • request_type type de signature : Type de signature que vous souhaitez voir figurer sur le certificat. Les valeurs valides sont : origin-rsa, origin-ecc.
  • hostnames: Un tableau de noms d'hôtes ou de noms génériques associés au certificat.
• Les zones facultatives sont requested_validity, csr.
  • requested_validity: Nombre de jours pendant lesquels le certificat doit être valide. Les valeurs valides sont : 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: La demande de signature de certificat (CSR). Si ce champ n'est pas défini, CIS en génère un.

Exemple de données JSON :

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

-s, --json-str

Obsolète. Les données JSON décrivant un certificat d'origine.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer un certificat signé par « CIS » pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

CERT_ID

L'ID du certificat d'origine. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Pour plus d'informations sur le certificat d'origine, consultez le site CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

CERT_ID

L'identifiant du certificat d'origine. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le certificat d'origine CERT_ID.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Afficher les informations générales relatives au domaine DNS_DOMAIN_ID.

ibmcloud cis overview DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de page. Obligatoire.

• Les champs obligatoires dans les données JSON sont « targets » et « actions » :
  • targets: Le modèle d' URL s cible à évaluer lors d'une requête.
  • actions: Une liste d'actions à effectuer si les cibles de cette règle correspondent à la requête. Les actions disponibles sont :
    • 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
    • Déclassé. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Certaines actions sont réservées aux formules Enterprise :
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• Les champs facultatifs sont « priority » et « status » :
  • priority: Un nombre qui indique la priorité accordée à une règle de page par rapport à une autre. La valeur par défaut est 1.
  • status: État de la règle de la page. Les valeurs autorisées sont « active » et « disabled » (valeur par défaut).

Exemple de données JSON :

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

Obsolète. Données JSON décrivant une règle de page.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créez une règle de page pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

--json VALUE

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une règle de page. Obligatoire.

• Les champs obligatoires dans les données JSON sont « targets » et « actions » :
  • targets: Le modèle d' URL s cible à évaluer lors d'une requête.
  • actions: Une liste d'actions à effectuer si les cibles de cette règle correspondent à la requête. Les actions disponibles sont :
    • 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
    • Déclassé. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Certaines actions sont réservées aux formules Enterprise :
      • cache_on_cookie
      • disable_apps
      • disable_performance
      • minify
      • origin_error_page_pass_thru
      • response_buffering
      • true_client_ip_header
      • sort_query_string_for_cache
      • respect_strong_etag
• Les champs facultatifs sont « priority » et « status » :
  • priority: Un nombre qui indique la priorité accordée à une règle de page par rapport à une autre. La valeur par défaut est 1.
  • status: État de la règle de la page. Les valeurs valables sont active et disabled. La valeur par défaut est disabled.

Exemple de données JSON :

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

Obsolète. Données JSON décrivant une règle de page.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Mettre à jour la règle de la page 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer la règle de page PAGE_RULE_ID.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Répertorier toutes les règles de page du domaine DNS_DOMAIN_ID.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Pour plus d'informations sur la règle de page « PAGE_RULE_ID », cliquez ici.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Le nom de l'enregistrement DNS correspondant à la demande de plage d'adresses.

--edge-port

Configuration des ports à la périphérie de CIS. La valeur par défaut est 22.

--origin-direct

Adresses de destination pour l'origine.

--origin-lb-name

Nom de l'équilibreur de charge associé à l'application « range ».

--origin-lb-port

Le port du répartiteur de charge associé à l'application « range ». La valeur par défaut est 22.

--protocol

Type de protocole. Les valeurs valides sont tcp et udp. La prise en charge du protocole UDP est en accès anticipé, demandez un UDP personnalisé depuis le tableau de bord CIS avant de créer une application UDP Range. La valeur par défaut est tcp.

--proxy-protocol

Activer le protocole de proxy jusqu'à l'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.

--ip-firewall

Permet de contrôler si le pare-feu IP est activé pour cette application. Les valeurs valides sont on et off. La valeur par défaut est off.

--edge-connectivity

Les versions IP prises en charge pour les connexions entrantes sur une plage d'adresses IP anycast. Les valeurs valides sont all, ipv4, ipv6. La valeur par défaut est all.

--edge-tls

Type de terminaison TLS associée à l'application. Les valeurs valides sont off, flexible, full, strict. La valeur par défaut est off.

--traffic-type

Détermine comment les données transitent de la périphérie à votre origine. Les valeurs valides sont direct, http, https. La valeur par défaut est direct.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une demande d'autorisation d'exploitation.

• Les champs obligatoires dans les données JSON sont « protocol » et « dns ».
  • protocol: Configuration des ports au niveau de la périphérie d' CIS.
  • dns: Le nom et le type de l'enregistrement DNS correspondant à la demande de plage d'adresses.
    • name: Nom de l'enregistrement DNS correspondant à la demande de plage d'adresses.
    • type: Le type de l'enregistrement DNS associé à l'application. La valeur valide est « CNAME ».
• Les champs facultatifs sont les suivants : origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls et traffic_type.
  • origin_direct: Une liste d'adresses de destination par rapport à l'origine.
  • origin_dns: Méthode et paramètres utilisés pour déterminer l'adresse du serveur d'origine via le DNS.
    • name: Nom de l'enregistrement DNS.
  • origin_port: Le port de destination à l'origine.
  • proxy_protocol: Activer le protocole proxy vers le serveur d'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.
  • ip_firewall firewall : Contrôle si le pare-feu IP est activé pour cette application. Les valeurs valables sont on et off.
  • edge_ips: Configuration de l'adresse IP de périphérie en mode anycast pour le nom d'hôte de cette application.
    • type: Le type de configuration IP de périphérie spécifié. Les IP de périphérie allouées dynamiquement utilisent des IP anycast Range en fonction de la connectivité spécifiée. La valeur valide est « dynamic ».
    • connectivity: Versions IP prises en charge pour les connexions entrantes sur une plage d'adresses IP anycast. Valeurs valides : all, ipv4, ipv6.
  • tls : type d'arrêt TLS associé à l'application. Les valeurs valides sont : off, flexible, full et strict.
  • traffic_type: Détermine comment les données sont acheminées depuis la périphérie jusqu'à votre serveur d'origine. Lorsqu'il est défini sur « direct », « range » achemine le trafic directement vers votre serveur d'origine, et le type de l'application est déterminé à partir du protocole. Lorsqu'elle est définie sur « http » ou « https », la plage applique les fonctionnalités de CIS ( HTTP / HTTPS ) lors de l'acheminement du trafic vers votre serveur d'origine, et le type d'application correspond exactement à cette propriété. Les valeurs valides sont : direct, http et https. La valeur par défaut est direct.

Exemple de données JSON :

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

Obsolète. Données JSON décrivant une application Range.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. À l'heure actuelle, « json » est la seule valeur prise en charge.

Exemples

Créer une application de gamme pour le domaine 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"}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

APP_ID

L'identifiant de la demande de plage. Obligatoire.

--name

Le nom de l'enregistrement DNS correspondant à la demande de plage d'adresses.

--add-origin-direct

Ajouter de nouvelles adresses de destination à l'origine.

--remove-origin-direct

Retirer des adresses de destination de l'origine.

--origin-direct

Adresses de destination pour l'origine.

--origin-lb-name

Nom de l'équilibreur de charge associé à l'application « range ».

--origin-lb-port

Le port du répartiteur de charge associé à l'application « range ». La valeur par défaut est 22.

--proxy-protocol

Activer le protocole proxy vers le serveur d'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.

--ip-firewall

Permet de contrôler si le pare-feu IP est activé pour cette application. Les valeurs valides sont on et off. La valeur par défaut est off.

--edge-connectivity

Les versions IP prises en charge pour les connexions entrantes sur une plage d'adresses IP anycast. Les valeurs valides sont all, ipv4, ipv6. La valeur par défaut est all.

--edge-tls

Type de terminaison TLS associée à l'application. Les valeurs valides sont off, flexible, full, strict. La valeur par défaut est off.

--traffic-type

Détermine comment les données transitent de la périphérie à votre origine. Les valeurs valides sont direct, http, https. La valeur par défaut est direct.

--json

Le fichier JSON ou la chaîne JSON utilisé(e) pour décrire une demande d'autorisation d'exploitation.

• Les champs obligatoires dans les données JSON sont « protocol » et « dns ».
  • protocol: Configuration des ports au niveau de la périphérie d' CIS.
  • dns: Le nom et le type de l'enregistrement DNS correspondant à la demande de plage d'adresses.
    • name: Nom de l'enregistrement DNS correspondant à la demande de plage d'adresses.
    • type: Le type de l'enregistrement DNS associé à l'application. La valeur valide est « CNAME ».
• Les champs facultatifs sont les suivants : origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls et traffic_type.
  • origin_direct: Une liste d'adresses de destination par rapport à l'origine.
  • origin_dns: Méthode et paramètres utilisés pour déterminer l'adresse du serveur d'origine via le DNS.
    • name: Nom de l'enregistrement DNS.
  • origin_port: Le port de destination à l'origine.
  • proxy_protocol: Activer le protocole proxy vers le serveur d'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.
  • ip_firewall firewall : Contrôle si le pare-feu IP est activé pour cette application. Les valeurs valables sont on et off.
  • edge_ips: Configuration de l'adresse IP de périphérie en mode anycast pour le nom d'hôte de cette application.
    • type: Le type de configuration IP de périphérie spécifié. Les IP de périphérie allouées dynamiquement utilisent des IP anycast Range en fonction de la connectivité spécifiée. La valeur valide est « dynamic ».
    • connectivity : versions IP prises en charge pour les connexions entrantes sur les adresses IP anycast Range. Les valeurs valides sont : all, ipv4, ipv6.
  • tls : type d'arrêt TLS associé à l'application. Les valeurs valides sont : off, flexible, full, strict.
  • traffic_type: Détermine comment les données sont acheminées depuis la périphérie jusqu'à votre serveur d'origine. Lorsqu'il est défini sur « direct », « range » achemine le trafic directement vers votre serveur d'origine, et le type de l'application est déterminé à partir du protocole. Lorsqu'elle est définie sur « http » ou « https », la plage applique les fonctionnalités de CIS ( HTTP / HTTPS ) lors de l'acheminement du trafic vers votre serveur d'origine, et le type d'application correspond exactement à cette propriété. Les valeurs valides sont : direct, http et https. La valeur par défaut est direct.