Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear una aplicación de acceso para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar una lista de todas las aplicaciones de acceso para los dominios 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-apps DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar detalles de la aplicación de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

--name

El nombre de la aplicación. Obligatorio.

--domain

El dominio y la ruta que bloquea Access. Obligatorio.

--session-duration

Define el tiempo durante el cual son válidos los tokens emitidos para esta aplicación. Los valores válidos son 30m, 6h, 12h, 24h, 168h y 730h.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar la aplicación de acceso a5836c2a7ea72d2e225890caea70ae32.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Suprimir la aplicación de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--name

El nombre del certificado. Obligatorio.

--ca-cert-file

El archivo de entidad emisora de certificados raíz para los certificados. Obligatorio.

--associated-hostnames

Los nombres de host que se solicitan para este certificado.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Crear un certificado de acceso para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener una lista de todos los certificados de acceso para el dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_CERTIFICATE_ID

El ID del certificado de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar detalles del certificado de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_CERTIFICATE_ID

El ID del certificado de acceso. Obligatorio.

--name

El nombre del certificado. Obligatorio.

--associated-hostnames

Los nombres de host que se solicitan para este certificado. Obligatorio.

Los nombres de host asociados se restablecen si no se especifican con associated-hostnames.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualiza el certificado de acceso a5836c2a7ea72d2e225890caea70ae32.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_CERTIFICATE_ID

El ID del certificado de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Elimina el certificado de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener valores de certificados de acceso para el dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-f, --feature

Característica de valores de certificados. Valores válidos:

client_certificate_forwarding

La carga útil del certificado de cliente y su firma SHA256 se reenvían a los servidores de origen a través de los encabezados CF-Client-Cert-SHA256 y CF-Client-Cert-DER_BASE64.

-v, --value

El valor establecido en la característica para certificados.

client_certificate_forwarding

Especifique el nombre de host para reenviar o no el certificado de cliente. Por ejemplo, -v host1=on,host2=on,host3=off.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar valores de certificados de acceso para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

--name

El nombre de la política. Obligatorio.

--decision

Define la acción que lleva a cabo Access si la política coincide con el usuario. El valor válido es non_identity. Obligatorio.

--include

La regla incluida de la política. Los valores válidos son certificate y common_name. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear una política de acceso para la aplicación de acceso a5836c2a7ea72d2e225890caea70ae32.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener una lista de todas las políticas de acceso para la aplicación de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

ACCESS_POLICY_ID

El identificador de la política de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar detalles de la política de acceso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

ACCESS_APPLICATION_ID

El identificador de la aplicación de acceso. Obligatorio.

ACCESS_POLICY_ID

El identificador de la política de acceso. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Suprimir la política de acceso 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--all

Depurar todos los archivos almacenados en caché. Esta opción es mutuamente excluyente con --file.

--file

Elimine de forma granular uno o más archivos especificando las URL. Esta opción es mutuamente excluyente con --all.

--tag

Elimine de forma granular uno o más archivos por la etiqueta de memoria caché asociada. Esta opción es mutuamente excluyente con --all. Solo planes Enterprise

--host

Elimine de forma granular uno o más archivos especificando el host. Esta opción es mutuamente excluyente con --all. Solo planes Enterprise

--prefix

Elimine de forma granular uno o más archivos por un prefijo. Esta opción es mutuamente excluyente con --all. Solo planes Enterprise

-f, --force

Depurar todos los archivos almacenados en memoria caché sin solicitar confirmación.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Borrar todo el archivo de activos en memoria caché para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener valores de almacenamiento en memoria caché para el dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--caching-level

Especifica en qué condiciones URL deseas entregar los recursos almacenados en caché al usuario. Los valores válidos son no-query-string, query-string-independent, y query-string-dependent.

• no-query-string entrega recursos desde la caché sólo cuando no hay una cadena de consulta presente.
• query-string-independent: Proporciona el mismo recurso a todos los usuarios, independientemente de la cadena de consulta.
• query-string-dependent: Proporciona un recurso diferente cada vez que cambia la cadena de consulta.

--browser-expiration

Especifica durante cuánto tiempo quieres que el navegador almacene los recursos en caché.

• Los valores válidos son respect-existing-header, 30s, 1M, 5M, 20M,, 30M, 1h, 2h, 4h, 8h``16h,, 1d``3d, 8d, 16d, 1m``6m, y 1y.
• 30s, 1M, 5M, y solo 20M están disponibles para instancias con un plan Enterprise o Security.
• 30s significa 30 seconds.
• 30M significa 30 minutes.
• 1h significa 1 hour.
• 1d significa 1 day.
• 1m significa 1 month.
• 1y significa 1 year.

--development-mod

Pasa por alto todas las memorias caché de extremo y envía el tráfico hacia los servidores de origen.

--serve-stale-content

Sigue ofreciendo contenido almacenado en caché a los usuarios cuando los servidores de origen estén fuera de línea, incluso si el contenido ha caducado.

--query-string-sort: En la caché, CIS considera que los archivos con las mismas cadenas de consulta son el mismo archivo, independientemente del orden de dichas cadenas.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar valores de almacenamiento en memoria caché para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis custom-lists lists

Opciones de comando

LIST_ID

El ID de la lista personalizada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis custom-lists list LIST_ID --output json

Opciones de comando

--kind

Tipo de lista personalizada. Los valores válidos son ip, asn, y hostname.

--name

El nombre de la lista.

--description

Descripción de la lista.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una lista personalizada.

Los campos obligatorios en los datos JSON son:

kind: Tipo de lista personalizada. Los valores válidos son ip, asn, y hostname.

name nombre de la lista.

El campo opcional es:

"description": Descripción de la lista.

Datos JSON de ejemplo:

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

Ejemplos

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

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

Opciones de comando

LIST_ID

El ID de la lista personalizada.

--description

Describa brevemente la lista.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

json

El archivo JSON o la cadena JSON que se utiliza para describir una lista personalizada.

El campo opcional es:

"description": Para describir brevemente la lista.

Datos JSON de ejemplo:

  {
    "description": "string"
  }

Ejemplos

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

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

Opciones de comando

LIST_ID

El ID de la lista personalizada.

-f, --force

Intentar eliminar una lista personalizada sin solicitar confirmación.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

Ejemplo

ibmcloud cis custom-lists list-delete LIST_ID

Opciones de comando

LIST_ID

El ID de la lista personalizada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis custom-lists items LIST_ID

Opciones de comando

LIST_ID

El ID de la lista personalizada.

ITEM_ID

El ID del elemento de la lista personalizada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Opciones de comando

LIST_ID

El ID de la lista personalizada.

--asn

El valor ASN.

--ip

La dirección IPv4.

--hostname

El nombre de host.

--comment

Comentar brevemente el tema.

-i, --instance

Nombre o ID de instancia. Si no se define la instancia o el ID, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una lista personalizada.

Los campos obligatorios en los datos JSON son:

items lista de elementos de lista personalizados para crear.

asn el ASN.

hostname el nombre del host.

ip: La dirección IPv4.

comment el Presidente: Para hacer un breve comentario sobre el tema.

Datos JSON de ejemplo:

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

Ejemplos de mandato

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

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

Opciones de comando

LIST_ID

El ID de la lista personalizada.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una lista personalizada.

Los campos obligatorios en los datos JSON son:

items lista de elementos de lista personalizados para crear.

asn: El valor ASN.

hostname el nombre del host.

ip: La dirección IPv4.

comment el Presidente: Para hacer un breve comentario sobre el tema.

Datos JSON de ejemplo:

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

-f, --force

Intentar eliminar una lista personalizada sin solicitar confirmación.

--output value

El formato de salida. Actualmente, json es el único valor admitido.

-i, --instance

Nombre o ID de instancia. Si no se establece el valor o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

Ejemplo

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

Opciones de comando

LIST_ID

El ID de la lista personalizada.

--item-id

CUSTOM_LIST_ITEM_ID es el ID del elemento de la lista personalizada.

-f, --force

Intentar eliminar una lista personalizada sin solicitar confirmación.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una lista personalizada.

Los campos obligatorios en los datos JSON son:

items lista de elementos de lista personalizados a eliminar por ID.

id: ID único del elemento de la lista personalizada.

Datos JSON de ejemplo:

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

Ejemplos

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

Opciones de comando

OPERATION_ID

El ID de la operación de lista personalizada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis custom-lists operation OPERATION_ID --output json

Opciones de comando

PAGE_ID

Nombre del tipo de página predeterminada. Los valores válidos son basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Obligatorio.

PAGE_URL

URL asociado a la página personalizada. Por ejemplo, http://www.example.com/example.html. El valor default significa utilizar la página predeterminada. Obligatorio.

-d, --domain

ID de dominio DNS.

-i,- --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar la página basic_challenge para el dominio 31984fea73a15b45779fa0df4ef62f9b.

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

Opciones de comando

PAGE_ID

Nombre del tipo de página predeterminada. Los valores válidos son basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block,, waf_challenge``1000_errors, y 500_errors. Obligatorio.

-d, --domain

ID de dominio DNS.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener la página basic_challenge para el dominio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Opciones de comando

-d, --domain

ID de dominio DNS.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Lista de páginas personalizadas existentes para el dominio DNS_DOMAIN_ID.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--name

Nombre del registro DNS.

--type

Tipo de registro DNS.

--content

Contenido del registro DNS.

--ttl

Tiempo de vida del registro DNS. Un valor de 1 es automatic. El valor predeterminado es 1.

--proxied

Controle si el tráfico fluye a través de funciones de seguridad y rendimiento en CIS. CIS Redirige el tráfico únicamente para los registros CNAME A, AAAA, y. Los valores válidos son true y false.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un registro DNS. Los tipos de registros de DNS admitidos son: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Para los tipos A, AAAA, CNAME, NS, : TXT
  • Los campos obligatorios en datos JSON son name, type, content.
  • Los campos opcionales son ttl, : proxied
    • proxied Controle si el tráfico fluye a través de funciones de seguridad y rendimiento en CIS. CIS Los proxies solo gestionan el tráfico de registros CNAME, A,``AAAA y.

Datos JSON de ejemplo:

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

• Para el tipo: PTR
  • Los campos obligatorios en datos JSON son name, type, content.
  • El campo opcional es ttl.

Datos JSON de ejemplo:

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

• Para el tipo: MX
  • Los campos obligatorios en datos JSON son name, type, content.
  • Los campos opcionales son ttl y priority.

Datos JSON de ejemplo:

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

• Para el tipo: LOC
  • Los campos obligatorios en datos JSON son name, type, data:
    • data:
      • lat_degrees: Grados de latitud.
      • lat_minutes: Unos minutos de latitud
      • lat_seconds: Segundos de latitud.
      • lat_direction: Dirección de latitud.
      • long_degrees: Grados de longitud.
      • long_minutes: Minutos de longitud.
      • long_seconds: Segundos de longitud.
      • long_direction: Dirección de la longitud.
      • altitude: Altitud de la ubicación en metros.
      • size: Dimensiones de la ubicación en metros.
      • precision_horz: Precisión horizontal de la ubicación.
      • precision_vert: Precisión vertical de la ubicación.
    • El campo opcional es ttl.

Datos JSON de ejemplo:

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

• Para el tipo: SRV
  • Los campos obligatorios en datos JSON son type, data:
    • data: - : service Un tipo de servicio, precedido por un guión bajo. - : proto Un protocolo válido. - : priority Prioridad. - : weight El peso del registro. - : port El puerto del servicio. - : target Un nombre de host válido.
    • El campo opcional es ttl.

Datos JSON de ejemplo:

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

• Para el tipo CAA:
  • Los campos obligatorios en los datos JSON son name, type, y data.
  • El campo opcional es ttl.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Datos JSON utilizados para describir un registro DNS.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear un registro DNS en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DNS_RECORD_ID

El identificador del registro DNS. Obligatorio.

--name

Nombre del registro DNS.

--type

Tipo de registro DNS.

--content

Contenido del registro DNS.

--ttl

Tiempo de vida del registro DNS. Un valor de 1 es automatic. El valor predeterminado es 1.

--proxied

Controle si el tráfico fluye a través de funciones de seguridad y rendimiento en CIS. CIS Redirige el tráfico únicamente para los registros CNAME A, AAAA, y. Los valores válidos son true y false.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un registro DNS. Los tipos de registros de DNS admitidos son: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Para los tipos A, AAAA, CNAME, NS, : TXT
  • Los campos obligatorios en datos JSON son name, type, content.
  • Los campos opcionales son ttl y : proxied
    • proxied Controle si el tráfico fluye a través de funciones de seguridad y rendimiento en CIS. CIS Los proxies solo gestionan el tráfico de los registros CNAME A, AAAA, y.

Datos JSON de ejemplo:

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

• Para el tipo: PTR
  • Los campos obligatorios en datos JSON son name, type, content.
  • El campo opcional es ttl.

Datos JSON de ejemplo:

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

• Para el tipo: MX

  • Los campos obligatorios en datos JSON son name, type, content.
  • Los campos opcionales son ttl y priority.

  Datos JSON de ejemplo:

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

• Para el tipo: LOC

  • Los campos obligatorios en datos JSON son name, type, data:
    • data:
      • lat_degrees: Grados de latitud.
      • lat_minutes: Unos minutos de latitud
      • lat_seconds: Segundos de latitud.
      • lat_direction: Dirección de latitud.
      • long_degrees: Grados de longitud.
      • long_minutes: Minutos de longitud.
      • long_seconds: Segundos de longitud.
      • long_direction: Dirección de la longitud.
      • altitude: Altitud de la ubicación en metros.
      • size: Dimensiones de la ubicación en metros.
      • precision_horz: Precisión horizontal de la ubicación.
      • precision_vert: Precisión vertical de la ubicación.
  • El campo opcional es ttl.

  Datos JSON de ejemplo:

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

• Para el tipo: SRV

  • Los campos obligatorios en datos JSON son type, data:
    • data:
      • service: Un tipo de servicio, precedido por un guión bajo.
      • proto: Un protocolo válido.
      • priority: Prioridad.
      • weight: El peso del disco.
      • port: El puerto del servicio.
      • target: Un nombre de host válido.
  • El campo opcional es ttl.

  Datos JSON de ejemplo:

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

• Para el tipo: CAA

  • Los campos obligatorios en los datos JSON son name, type, data
  • El campo opcional es ttl.

  Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Datos JSON utilizados para describir un registro DNS.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar un registro DNS en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DNS_RECORD_ID

El identificador del registro DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtenga los detalles del registro DNS en el dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DNS_RECORD_ID

El identificador del registro DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar un registro DNS del dominio DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--type

Tipo de registros DNS que se deben visualizar.

--name

Valor del campo de nombre por el que filtrar.

--content

Valor del campo de contenido por el que filtrar.

--page

Número de página de los resultados paginados.

--per_page

Número máximo de registros DNS por página.

--order

Campo según el cual se ordena la lista de registros DNS. Los valores válidos son type, name, content, ttl, y proxied.

--direction

Orden en el que se deben mostrar los resultados (ascendente o descendente). Los valores válidos son asc y desc.

--match

Si se debe coincidir con todos los parámetros de búsqueda o al menos con uno. Los valores válidos son any y all.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumera todos los registros DNS del dominio DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--file

Configuración BIND que se debe importar. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Importar la configuración de BIND en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--file

El archivo de configuración de BIND que almacena los registros DNS exportados.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Exportar la configuración de BIND para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

type

Especifique la configuración del tipo de dominio. Los valores válidos son full y partial (por defecto full).

• full: Una zona completa implica que el DNS está alojado.
• partial: Una zona parcial implica un dominio configurado con un registro CNAME.

jump-start

Intenta automáticamente captar los registros de DNS existentes.

DNS_DOMAIN_NAME

El nombre de dominio completo (FQDN) del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Añadir un dominio DNS_DOMAIN_NAME.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Reanudar el dominio especificado.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Poner en pausa el dominio especificado.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar los detalles del dominio especificados.

ibmcloud cis domain DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar el dominio especificado.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Lista de dominios para la instancia de servicio.

ibmcloud cis domains

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Realizar una comprobación de la activación en el dominio especificado.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-g, --group

Muestra las características en un mismo grupo. Los valores válidos para group son all, domain, reliability``performance, y security. Esta opción es mutuamente excluyente con -f, --feature.

-f, --feature

Característica de valores de dominio que se deben comprobar. Esta opción es mutuamente excluyente con -g, --group. Los valores válidos son los siguientes:

• always_use_https: Redirige todas las solicitudes con el esquema http a https. Esta configuración se aplica a todas las solicitudes de HTTP dirigidas al dominio.
• automatic_https_rewrites: Ayuda a corregir el contenido mixto cambiando http por en https todos los recursos o enlaces de tu sitio web que puedan servirse con HTTPS.
• bot_management: Detecta y mitiga el tráfico de bots en tu dominio.
• brotli: Cuando el cliente que solicita un recurso es compatible con el algoritmo de compresión Brotli, CIS sirve una versión del recurso comprimida con Brotli.
• browser_check: Evalúa los encabezados HTTP del navegador de tus visitantes en busca de amenazas. Si se encuentra una amenaza, se entrega una página de bloqueo.
• challenge_ttl: Especifica durante cuánto tiempo se permite el acceso a tu sitio web a un visitante con mala reputación de IP después de que haya superado una prueba de autenticación.
• ciphers: Una lista de cifrados permitidos para la terminación TLS en el formato BoringSSL. Este comando muestra una lista de cifrados que están permitidos por los clientes. Si no hay ningún algoritmo de cifrado incluido en la lista de permitidos, la lista estará vacía y se utilizarán los algoritmos predeterminados. Consulte Suites de cifrado de borde y Suites de cifrado de origen para ver la lista de cifrados predeterminados.
• cname_flattening: Sigue un CNAME hasta donde apunta y devuelve esa dirección IP en lugar del registro CNAME. Por defecto, solo se simplifica el CNAME de la raíz de tu dominio.
• domain_hold: Las restricciones de dominios impiden que los equipos de tu organización añadan dominios que ya estén activos en otra cuenta. Solo planes Enterprise
• email_obfuscation encriptar las direcciones de correo electrónico en su página web de los robots, mientras que se mantiene visible para los seres humanos.
• opportunistic_onion: Permite que los usuarios legítimos del navegador Tor accedan a tus sitios web.
• hotlink_protection: Protege tus imágenes contra enlaces externos.
• http2: Acelera tu sitio web con HTTP/2.
• http3: Acelera tu sitio web con HTTP/3.
• image_load_optimization: Deprecated. Mejorar el tiempo de carga de las páginas que contienen imágenes en los dispositivos móviles con conexiones de red lentas.
• image_size_optimization: Mejora el tiempo de carga de las imágenes optimizando las que están alojadas en tu dominio.
• image_resizing: Proporciona redimensionamiento, conversión y optimización a la carta para imágenes servidas a través de la red CIS.
• ip_geolocation: Incluye el código de país de la ubicación del visitante en todas las solicitudes a tu sitio web.
• ipv6: Habilitar la compatibilidad con IPv6 y la pasarela.
• max_upload: El número de visitantes que pueden cargar datos en su sitio web en una sola solicitud.
• min_tls_version: Permita únicamente conexiones HTTPS de visitantes que admitan la versión seleccionada del protocolo TLS o una más reciente.
• minify: Reduce el tamaño de los archivos de código fuente de tu página web.
• mobile_redirect: Redirige a los visitantes que utilicen dispositivos móviles a un sitio web optimizado para móviles.
• opportunistic_encryption: El cifrado oportunista permite a los navegadores beneficiarse del rendimiento mejorado de HTTP/2 al indicarles que su sitio web está disponible a través de una conexión cifrada.
• origin_error_page_pass_thru: Cuando la página de error de origen está configurada en On, CIS redirige las páginas de error 502 y 504 directamente desde el origen. Solo planes Enterprise
• origin_max_http_version: Configura la versión de HTTP como Origin.
• origin_post_quantum_encryption: Indica a CIS que utilice algoritmos de acuerdo de claves poscuánticos (PQ) cuando se conecte a tu origen.
• prefetch_preload: CIS recupera previamente cualquier URL incluida en el encabezado prefetch HTTP. Solo planes Enterprise
• pseudo_ipv4: Añade un encabezado IPv4 a las solicitudes cuando un cliente utiliza IPv6, pero el servidor solo admite IPv4.
• response_buffering: Activa o desactiva el almacenamiento en búfer de las respuestas del servidor de origen. Solo planes Enterprise
• script_load_optimization: Mejorar el tiempo de renderizado de las páginas que incluyen JavaScript.
• security_header: Aplica una política de seguridad web a tu sitio web.
• security_level: Elige el perfil de seguridad adecuado para tu sitio web.
• server_side_exclude: Ocultar automáticamente contenido específico a los visitantes sospechosos.
• tls_client_auth: Se presenta el certificado de cliente TLS para la autenticación en la solicitud de origen. Solo planes Enterprise
• true_client_ip_header: CIS envía la dirección IP del usuario en el encabezado True-Client-IP. Solo planes Enterprise
• waf: Un cortafuegos de aplicaciones web (WAF) bloquea las solicitudes que contienen contenido malicioso.
• websockets: Permite las conexiones WebSockets a tu servidor de origen.
• proxy_read_timeout: Tiempo máximo entre dos operaciones de lectura desde el origen. Solo planes Enterprise
• url_normalization: Modificar las URL de las solicitudes entrantes.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener la configuración ciphers del dominio DNS_DOMAIN_ID.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-f, --feature

Características de la configuración del dominio que se va a actualizar. Obligatorio. Valores válidos:

• always_use_https: Redirige todas las solicitudes con el esquema http a https. Esta redirección se aplica a todas las solicitudes HTTP dirigidas al dominio.
• automatic_https_rewrites: Ayuda a corregir el contenido mixto cambiando http por en https todos los recursos o enlaces de tu sitio web que puedan servirse con HTTPS.
• bot_management: Detecta y mitiga el tráfico de bots en tu dominio.
• brotli: Cuando el cliente que solicita un recurso es compatible con el algoritmo de compresión Brotli, CIS sirve una versión del recurso comprimida con Brotli.
• browser_check: Evalúa los encabezados HTTP del navegador de tus visitantes en busca de amenazas. Si se encuentra una amenaza, se entrega una página de bloqueo.
• challenge_ttl: Especifica durante cuánto tiempo se permite el acceso a tu sitio web a un visitante con mala reputación de IP después de que haya superado una prueba de autenticación.
• ciphers: Una lista de cifrados para la terminación de TLS. Estos cifrados deben estar en formato BoringSSL.
• cname_flattening: Sigue un CNAME hasta donde apunta y devuelve esa dirección IP en lugar del registro CNAME. De forma predeterminada, solo se simplifica el CNAME en la raíz del dominio.
• domain_hold: Las restricciones de dominios impiden que los equipos de tu organización añadan dominios que ya estén activos en otra cuenta. Solo planes Enterprise
• email_obfuscation encriptar las direcciones de correo electrónico en su página web de los robots, mientras que se mantiene visible para los seres humanos.
• opportunistic_onion: Permite que los usuarios legítimos del navegador Tor accedan a tus sitios web.
• hotlink_protection: Protege tus imágenes contra enlaces externos.
• http2: Acelera tu sitio web con HTTP/2.
• http3: Acelera tu sitio web con HTTP/3.
• image_load_optimization: Deprecated. Mejorar el tiempo de carga de las páginas que contienen imágenes en los dispositivos móviles con conexiones de red lentas.
• image_size_optimization: Mejora el tiempo de carga de las imágenes optimizando las que están alojadas en tu dominio.
• image_resizing: Proporciona redimensionamiento, conversión y optimización a la carta para imágenes servidas a través de la red CIS.
• ip_geolocation: Incluye el código de país de la ubicación del visitante en todas las solicitudes a tu sitio web.
• ipv6: Habilitar la compatibilidad con IPv6 y la pasarela.
• max_upload: El número de visitantes que pueden cargar datos en su sitio web en una sola solicitud.
• min_tls_version: Permita únicamente conexiones HTTPS de visitantes que admitan la versión seleccionada del protocolo TLS o una más reciente.
• minify: Reduce el tamaño de los archivos de código fuente de tu página web.
• mobile_redirect: Redirige a los visitantes que utilicen dispositivos móviles a un sitio web optimizado para móviles.
• opportunistic_encryption: El cifrado oportunista permite a los navegadores beneficiarse del rendimiento mejorado de HTTP/2 al indicarles que su sitio web está disponible a través de una conexión cifrada.
• origin_error_page_pass_thru: Cuando la opción Página de error de origen está configurada en On, CIS redirige las páginas de error 502 y 504 directamente desde el origen. Solo planes Enterprise
• origin_max_http_version: Configura la versión de HTTP como Origin.
• origin_post_quantum_encryption: Indica a CIS que utilice algoritmos de acuerdo de claves poscuánticos (PQ) cuando se conecte a tu origen.
• prefetch_preload: CIS recupera previamente cualquier URL incluida en el encabezado prefetch HTTP. Solo planes Enterprise
• pseudo_ipv4: Añade un encabezado IPv4 a las solicitudes cuando un cliente utiliza IPv6, pero el servidor solo admite IPv4.
• response_buffering: Activa o desactiva el almacenamiento en búfer de las respuestas del servidor de origen. Solo planes Enterprise
• script_load_optimization: Mejorar el tiempo de renderizado de las páginas que incluyen JavaScript.
• security_header: Aplica una política de seguridad web a tu sitio web.
• security_level: Elige el perfil de seguridad adecuado para tu sitio web.
• server_side_exclude: Ocultar automáticamente contenido específico a los visitantes sospechosos.
• tls_client_auth: Se presenta el certificado de cliente TLS para la autenticación en la solicitud de origen. Solo planes Enterprise
• true_client_ip_header: CIS envía la dirección IP del usuario en el encabezado True-Client-IP. Solo planes Enterprise
• waf: Un cortafuegos de aplicaciones web (WAF) bloquea las solicitudes que contienen contenido malicioso.
• websockets: Permite las conexiones WebSockets a tu servidor de origen.
• proxy_read_timeout: Tiempo máximo entre dos operaciones de lectura desde el origen.
• url_normalization: Modificar las URL de las solicitudes entrantes.

-v, --value

Valor establecido en la característica para el dominio. Obligatorio.

• Los valores válidos para always_use_https son on y off.

• Los valores válidos para automatic_https_rewrites son on y off.

• Los valores válidos para bot_management son "use_latest_model", "fight_mode", "session_score", "enable_js". Por ejemplo, -v fight_mode=true,session_score=true

  • use_latest_model permite activar la última versión del modelo. Los valores válidos para use_latest_model son true y false.
  • fight_mode permite activar el modo de lucha. Los valores válidos para fight_mode son true y false.
  • session_score: Si se activa el marcador de sesión. Los valores válidos para session_score son true y false.
  • enable_js: Si se activan las detecciones de JavaScript. Los valores válidos para enable_js son true y false.

• Los valores válidos para browser_check son on y off.

• Los valores válidos para challenge_ttl son 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• Los valores válidos para cname_flattening son flatten_at_root, flatten_all.

  • flatten_at_root: Simplificar el CNAME en el dominio raíz. Este es el valor predeterminado.
  • flatten_all: Unifica todos los registros CNAME de tu dominio.

• Los valores válidos para domain_hold son hold, include_subdomains y hold_after.

  • hold permite activar la retención de dominio. Los valores válidos para hold son true y false.
  • include_subdomains: Si habilitar la retención de dominio. Los valores válidos para include_subdomains son true y false.
  • hold_after: Si hold_after se proporciona, la retención se desactiva temporalmente y, a continuación, el sistema la vuelve a activar automáticamente a la hora especificada.

  Para habilitar el dominio y los subdominios, utilice: -v hold=true,include_subdomains=true. Para desactivar la retención de dominio: -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• Los valores válidos para hotlink_protection son on, off.

• Los valores válidos para email_obfuscation son on, off.

• Los valores válidos para opportunistic_onion son on, off.

• Los valores válidos para http2 son on, off.

• Los valores válidos para http3 son on, off.

• Obsoleto. Los valores válidos para image_load_optimization son on, off.

• Los valores válidos para image_resizing son on, off.

• Los valores válidos para image_size_optimization son off, lossless, lossy.

  • off: inhabilitar la optimización de tamaño de imagen.
  • lossless: Reducir el tamaño de los archivos de imagen sin afectar a la calidad visual.
  • lossy: El tamaño de los archivos de imágenes JPEG se reduce mediante una compresión con pérdida, lo que puede disminuir la calidad visual.

• Los valores válidos para ip_geolocation son on, off.

• Los valores válidos para ipv6 son on, off.

• Los valores válidos (en MB) para max_upload son: 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Solo planes Enterprise

• Los valores válidos para min_tls_version son 1.0, 1.1, 1.2, 1,3.

• Los valores válidos para minify son css, html, js. Por ejemplo, -v css=on,html=off,js=on

  • css: Minimiza automáticamente todo el código CSS de tu sitio web. Los valores válidos para css son on, off.
  • html: Minimiza automáticamente todo el código HTML de tu sitio web. Los valores válidos para html son on, off.
  • js: Minimiza automáticamente todo el código JS de tu sitio web. Los valores válidos para js son on, off.

• Los valores válidos para mobile_redirect son status, mobile_subdomain, strip_uri. Por ejemplo, -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Si la redirección móvil está activada. Los valores válidos para status son on y off.
  • mobile_subdomain: Prefijo de subdominio al que desea redirigir a los visitantes que utilicen dispositivos móviles (el subdominio debe existir).
  • strip_uri: Si se debe eliminar la ruta de la página actual y redirigir a la raíz del subdominio móvil URL. Los valores válidos para strip_uri son true, false.

• Los valores válidos para opportunistic_encryption son on, off.

• Los valores válidos para origin_error_page_pass_thru son 1, 2.

• Los valores válidos para origin_max_http_version son supported, preferred, off.

  • supported: Se anuncian algoritmos poscuánticos, pero solo se utilizan cuando lo solicita el origen.
  • preferred: La opción Preferred indica a CIS que, cuando sea oportuno, envíe un intercambio de claves poscuánticas (PQ) en el primer mensaje al origen (para conseguir las conexiones más rápidas cuando el origen admita y prefiera PQ).
  • off: No se promocionan los algoritmos poscuánticos.

• Los valores válidos para origin_post_quantum_encryption son on, off.

• Los valores válidos para brotli son on, off.

• Los valores válidos para prefetch_preload son on, off.

• Los valores válidos para pseudo_ipv4 son off, add_header, overwrite_header.

  • off: inhabilitar pseudo IPv4.
  • add_header: Añadir únicamente un encabezado adicional Cf-Pseudo-IPv4.
  • overwrite_header: sobrescribir las cabeceras Cf-Connecting-IP y X-Forwarded-For existentes con una dirección Pseudo IPv4.

• Los valores válidos para response_buffering son on, off.

• Los valores válidos para script_load_optimization son on, off.

• Los valores válidos para security_header son enabled, max_age, include_subdomains, preload, nosniff. Por ejemplo, -v enabled=true,max_age=100, include_subdomains=true, preload=true, nosniff=true

  • enabled: Si el encabezado security_header está activado. Los valores válidos para enabled son true, false.
  • max_age: Especifica el tiempo (en segundos) durante el que los security_header se almacenan en la caché de los navegadores.
  • include_subdomains: Todos los dominios subordinados al dominio heredan el mismo security_header. Los valores válidos para include_subdomains son true, false.
  • preload: Si se debe permitir que los navegadores precarguen la configuración de security_header. Los valores válidos para enabled son true, false.
  • nosniff: Si se debe enviar el encabezado X-Content-Type-Options: nosniff. Los valores válidos para nosniff son true, false.

• Los valores válidos para server_level son off, essentially_off, low, medium, high, under_attack.

• Los valores válidos para server_side_exclude son on, off.

• Los valores válidos para tls_client_auth son on, off.

• Los valores válidos para true_client_ip_header son on, off.

• Los valores válidos para waf son on, off.

• Los valores válidos para websockets son on, off.

• Valores válidos para proxy_read_timeout, 1-6000, valor predeterminado: 100.

• Los valores válidos para ciphers son 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. Por ejemplo, -v AES256-SHA256,AES256-SHA, utilizando -v default para restablecer las suites de cifrado configuradas al valor predeterminado.

• Los valores válidos para url_normalization son "type", "scope". Por ejemplo, -v type=cis,scope=both

  • type: Selecciona el tipo de normalización de URL que realiza CIS. Los valores válidos para type son cis, rfc3986.
  • scope: Configura el ámbito de la normalización de URL. Los valores válidos para scope son both, incoming.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Habilitar tls_client_auth para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumera todas las acciones de las Funciones de Borde.

ibmcloud cis edge-functions-actions

Opciones de comando

--name

Nombre de acción. Solo planes Enterprise

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Mostrar detalles de la acción Edge Functions ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Opciones de comando

--name

Nombre de acción. Solo planes Enterprise

--javascript-str

Serie de Javascript. Por ejemplo, addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Archivo Javascript.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crea una acción de Edge Functions.

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

Opciones de comando

--name

Nombre de acción. Solo planes Enterprise

--javascript-str

Serie de Javascript. Por ejemplo, addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Archivo Javascript.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar una acción de Edge Functions.

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

Opciones de comando

--name

Nombre de acción. Solo planes Enterprise

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Acción Eliminar funciones de Edge ACTION_NAME.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumera todos los desencadenantes de Edge Functions para el dominio DNS_DOMAIN_ID.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

TRIGGER_ID

El identificador del disparador. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar detalles del disparador de Edge Functions TRIGGER_ID.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

PATTERN_URL

La solicitud URL, que activa la acción. Obligatorio.

name

El nombre de la acción a la que se asocia el disparador creado. Solo planes Enterprise

disable

Inhabilite un desencadenante de Edge Functions.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crea un disparador de Edge Functions para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

TRIGGER_ID

El identificador del disparador. Obligatorio.

PATTERN_URL

La solicitud URL, que activa la acción. Obligatorio.

name

El nombre de la acción a la que está asociado el disparador creado. Solo planes Enterprise

disable

Inhabilite un desencadenante de Edge Functions.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar el disparador de Edge Functions TRIGGER_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

TRIGGER_ID

El identificador del disparador. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar el desencadenador de Edge Functions TRIGGER_ID.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Opciones de comando

-t, --type

Tipos de reglas de cortafuegos que se deben crear. Valores válidos: access-rules, ua-rules, lockdowns. Obligatorio.

• access-rules: Las reglas de acceso constituyen una forma de permitir, plantear un desafío o bloquear las solicitudes a su sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Realizar control de acceso cuando coincida con el UserAgent exacto notificado por el cliente. Los mecanismos de control de accesos se pueden definir en una regla para ayudar a gestionar el tráfico de clientes concretos. Esta opción te permite personalizar el acceso a tu sitio web.
• lockdowns: Bloquear el acceso a los URL del dominio y solo permitirlo a direcciones o rangos de direcciones permitidos.

-d, --domain

ID de dominio DNS. Para la regla de tipo ua-rules y lockdowns, es un parámetro obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una regla de cortafuegos. Obligatorio.

• Para: --type access-rules Los datos JSON que describen una regla de acceso del cortafuegos de la siguiente manera.
  • Los campos obligatorios son mode, configuration.
    • mode: El tipo de acción que hay que realizar. Los valores válidos son block, challenge, whitelist, y js_challenge.
    • configuration: Par Valor/Destino que se debe utilizar para esta regla.
      • target: La propiedad de la solicitud a la que se debe dirigir. Los valores válidos son ip, ip_range, asn, y country.
      • value: El valor correspondiente al objetivo seleccionado.
        • En el caso de ip, el valor es una dirección IP válida.
        • En el caso de ip_range, el valor especifica un rango de direcciones IP que se limita a /16 y /24.
        • En el caso de asn, el valor es un número AS.
        • En el caso de un país, el valor es el código de país correspondiente.
  • Los campos opcionales son notes.
    • notes: Información útil sobre esta norma que ayude a identificar su finalidad.

Datos JSON de ejemplo:

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

• Para: --type ua-rules Los datos JSON que describen una regla de agente de usuario de la siguiente manera.
  • Los campos obligatorios son mode, configuration.
    • mode: El tipo de acción que hay que realizar. Los valores válidos son block, challenge, y js_challenge.
    • configuration: Par Valor/Destino que se debe utilizar para esta regla.
      • target: La propiedad de la solicitud a la que se debe dirigir. El valor válido es ua.
      • value: La cadena exacta UserAgent que debe coincidir con esta regla.
  • Los campos opcionales son paused, description.
    • paused: Si esta regla está desactivada actualmente.
    • description: Información útil sobre esta norma que ayude a identificar su finalidad.

Datos JSON de ejemplo:

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

• Para --type lockdowns: Los datos JSON que describen una regla de bloqueo son los siguientes.
  • Los campos obligatorios son urls, configurations.
    • urls: URL que deben incluirse en esta definición de regla.
      • Se pueden utilizar caracteres comodín.
      • El patrón URL introducido aquí se escapa antes de su uso.
      • Este campo limita el campo URL a patrones simples con comodines.
    • configurations: Lista de direcciones IP o rangos CIDR que se deben utilizar para esta regla.
      • Este campo puede incluir cualquier número de configuraciones de ip o ip_range que puedan acceder a las URL proporcionadas.
      • target: La propiedad de la solicitud a la que se debe dirigir. Los valores válidos son ip, y ip_range.
      • value: Direcciones IP o CIDR. Si el destino es ip, el valor debe ser una dirección IP; en caso contrario, debe ser CIDR.
  • Los campos opcionales son paused, description.
    • paused: Si esta regla está desactivada actualmente.
    • description: Información útil sobre esta norma que ayude a identificar su finalidad.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla de cortafuegos.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear reglas de cortafuegos.

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

Opciones de comando

• FIREWALL_RULE_ID: el ID de la regla de cortafuegos. Obligatorio.

-t, --type

El tipo de regla de cortafuegos que se debe crear. Los valores válidos son access-rules, ua-rules, y lockdowns. Obligatorio.

• access-rules: Las reglas de acceso son una forma de permitir, verificar o bloquear las solicitudes dirigidas a su sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Realizar el control de acceso cuando coincida exactamente con el UserAgent indicado por el cliente. Los mecanismos de control de accesos se pueden definir en una regla para ayudar a gestionar el tráfico de clientes concretos. Esto le permite personalizar el acceso al sitio.
• lockdowns: Limita el acceso a las URL de este dominio únicamente a las direcciones o rangos de direcciones autorizados.

-d, --domain

ID de dominio DNS. Para la regla de tipo ua-rules y lockdowns, es un parámetro obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una regla de cortafuegos. Obligatorio.

• Para --type access-rules: Los datos JSON que describen una regla de acceso al cortafuegos son los siguientes.
  • Los campos opcionales son mode, notes.
    • mode: El tipo de acción que hay que realizar. Los valores válidos son block, challenge, whitelist, y js_challenge.
    • notes: Información útil sobre esta norma que ayude a identificar su finalidad.

Datos JSON de ejemplo:

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

• Para --type ua-rules: Los datos JSON que describen una regla de agente de usuario son los siguientes.

  • Los campos obligatorios son mode, configuration.
    • mode: El tipo de acción que hay que realizar. Los valores válidos son block, challenge, y js_challenge.
    • configuration: Par Valor/Destino que se debe utilizar para esta regla.
      • target: La propiedad de la solicitud a la que se debe dirigir. El valor válido es ua.
      • value: La cadena exacta UserAgent que debe coincidir con esta regla.
  • Los campos opcionales son paused, description.
    • paused: Si esta regla está desactivada actualmente.
    • description: Información útil sobre esta norma que ayude a identificar su finalidad.

  Datos JSON de ejemplo:

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

• Para --type lockdowns: Los datos JSON que describen una regla de bloqueo son los siguientes.
  • Los campos obligatorios son urls, configurations.
    • urls: URL que deben incluirse en esta definición de regla.
      • Se pueden utilizar caracteres comodín.
      • El patrón URL introducido aquí se escapa antes de su uso.
      • Este campo limita el campo URL a patrones simples con comodines.
    • configurations: Lista de direcciones IP o rangos CIDR que se deben utilizar para esta regla.
      • Este campo puede incluir cualquier número de configuraciones de ip o ip_range que puedan acceder a las URL proporcionadas.
      • target: La propiedad de la solicitud a la que se debe dirigir. Los valores válidos son ip y ip_range.
      • value: Direcciones IP o CIDR. Si el destino es ip, el valor debe ser una dirección IP; en caso contrario, debe ser un CIDR.
  • Los campos opcionales son paused, description.
    • paused: Si esta regla está desactivada actualmente.
    • description: Información útil sobre esta norma que ayude a identificar su finalidad.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla de cortafuegos.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar reglas de cortafuegos.

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

Opciones de comando

-t, --type

El tipo de regla de cortafuegos que se debe crear. Los valores válidos son access-rules, ua-rules, y lockdowns. Obligatorio.

• access-rules: Las reglas de acceso son una forma de permitir, verificar o bloquear las solicitudes dirigidas a su sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Realizar el control de acceso cuando coincida exactamente con el UserAgent indicado por el cliente. Los mecanismos de control de accesos se pueden definir en una regla para ayudar a gestionar el tráfico de clientes concretos. Esta acción te permite personalizar el acceso a tu sitio web.
• lockdowns: Limita el acceso a las URL de este dominio únicamente a las direcciones o rangos de direcciones autorizados.

-d, --domain

ID de dominio DNS. Para la regla de tipo ua-rules y lockdowns, es un parámetro obligatorio.

--page

Número de página de los resultados paginados. El valor predeterminado es 0.

--per-page

Número máximo de reglas de acceso por página. El valor mínimo es 5. El valor predeterminado es 20.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar una lista de reglas de cortafuegos.

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

Opciones de comando

FIREWALL_RULE_ID

El identificador de la regla del cortafuegos. Obligatorio.

-t, --type

Tipo de regla de cortafuegos que se debe crear. Los valores válidos son access-rules, ua-rules, y lockdowns.

• access-rules: Las reglas de acceso son una forma de permitir, verificar o bloquear las solicitudes dirigidas a su sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Realizar el control de acceso cuando coincida exactamente con el UserAgent indicado por el cliente. Los mecanismos de control de accesos se pueden definir en una regla para ayudar a gestionar el tráfico de clientes concretos. Esto le permite personalizar el acceso al sitio.
• lockdowns: Limita el acceso a las URL de este dominio únicamente a las direcciones o rangos de direcciones autorizados.

-d, --domain

ID de dominio DNS. Para la regla de tipo ua-rules y lockdowns, es un parámetro obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener detalles de regla de cortafuegos.

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

Opciones de comando

FIREWALL_RULE_ID

El identificador de la regla del cortafuegos. Obligatorio.

-t, --type

Tipo de regla de cortafuegos que se debe crear. Los valores válidos son access-rules, ua-rules, y lockdowns. Obligatorio.

• access-rules: Las reglas de acceso son una forma de permitir, verificar o bloquear las solicitudes dirigidas a su sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Realizar el control de acceso cuando coincida exactamente con el UserAgent indicado por el cliente. Los mecanismos de control de accesos se pueden definir en una regla para ayudar a gestionar el tráfico de clientes concretos. Este campo te permite personalizar el acceso a tu sitio web.
• lockdowns: Limita el acceso a las URL de este dominio únicamente a las direcciones o rangos de direcciones autorizados.

-d, --domain

ID de dominio DNS. Para la regla de tipo ua-rules y lockdowns, es un parámetro obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Suprimir una regla de cortafuegos.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--page

Número de página de los resultados paginados. El valor predeterminado es 1.

--per-page

Número de reglas de cortafuegos por página. El valor mínimo es 5 y el valor máximo es 100. El valor predeterminado es 25.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Lista de reglas de cortafuegos existentes en el dominio DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

FIREWALL_RULE_ID

El ID de la regla del cortafuegos. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Consulta los detalles de la regla de cortafuegos FIREWALL_RULE_ID.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--expression

Una expresión de filtro. Por ejemplo, ip.src eq 93.184.216.0.

--action

Acción de regla que se debe realizar. Los valores válidos son log, allow, challenge, js_challenge, block y bypass.

--priority

Prioridad de la regla. Los valores válidos oscilan entre 0 y 2147483647. El valor 0 se establece en el valor por defecto.

--description

Descripción breve de la regla.

--paused

Indica si la regla está activa o no. Los valores válidos son on y off. El valor predeterminado es off.

--products

Lista de productos de seguridad que se van a ignorar. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, y waf.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una regla de cortafuegos.

• Los campos obligatorios en los datos JSON son expression y action.
  • expression: Una expresión de filtro. Por ejemplo, ip.src eq 93.184.216.0
  • action: La acción que debe realizar la regla. Los valores válidos son log, allow, challenge, js_challenge, block, y bypass.
• Los campos opcionales son description, priority, paused, products.
  • description: Para describir brevemente la norma.
  • priority: La prioridad de la regla. Los valores válidos oscilan entre 0 y 2147483647. El valor 0 significa establecer el valor por defecto.
  • paused: Indica si la regla está activa o no. Los valores válidos son on y off. El valor predeterminado es off.
  • products: La lista de productos de seguridad que deben omitirse. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, y. Por waf ejemplo: --products zoneLockdown, rateLimit

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla cortafuegos.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Cree una regla cortafuegos en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

FIREWALL_RULE_ID

El ID de la regla del cortafuegos. Obligatorio.

--expression

Una expresión de filtro. Por ejemplo, ip.src eq 93.184.216.0.

--action

Acción de regla que se debe realizar. Los valores válidos son log, allow, challenge, js_challenge, block y bypass.

--priority

Prioridad de la regla. Los valores válidos oscilan entre 0 y 2147483647. El valor 0 se establece en el valor por defecto.

--description

Descripción breve de la regla.

--paused

Indica si la regla está activa o no. Los valores válidos son on y off. El valor predeterminado es off.

--products

Lista de productos de seguridad que se van a ignorar. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, y waf.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una regla de cortafuegos.

• Los campos obligatorios en los datos JSON son expression, y action.
  • expression: Una expresión de filtro. Por ejemplo, ip.src eq 93.184.216.0
  • action: La acción que debe realizar la regla. Los valores válidos son log, allow, challenge, js_challenge, block, y bypass.
• Los campos opcionales son description, priority, paused, products.
  • description: Para describir brevemente la norma.
  • priority: La prioridad de la regla. Los valores válidos oscilan entre 0 y 2147483647. El valor 0 significa establecer el valor por defecto.
  • paused: Indica si la regla está activa o no. Los valores válidos son on y off. El valor predeterminado es off.
  • products: La lista de productos de seguridad que deben omitirse. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, y. Por waf ejemplo: --products zoneLockdown, rateLimit

Los campos description, priority, y paused, que no se establecen explícitamente en los datos JSON se sobrescriben con el valor predeterminado.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla cortafuegos.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar regla de cortafuegos 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"}'

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

FIREWALL_RULE_ID

El ID de la regla del cortafuegos. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Borrar regla cortafuegos FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

EXPRESSION

La expresión del filtro. Por ejemplo, ip.src eq 93.184.216.0. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Validar expresión de regla cortafuegos.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un equilibrador de carga global. Obligatorio.

• Los campos obligatorios en los datos JSON son name, fallback_pool y : default_pools
  • name: El nombre de host DNS que se debe asociar a su equilibrador de carga.
  • fallback_pool: El ID del grupo que se debe utilizar cuando se detecta que todos los demás grupos no funcionan correctamente.
  • default_pools: Una lista de identificadores de grupo ordenados según su prioridad de conmutación por error.
• Los campos opcionales son description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: La descripción de su equilibrador de carga.
  • ttl: vida (TTL - Time To Live) de la entrada DNS para la dirección IP que ha devuelto este equilibrador de carga.
  • region_pools: Una correspondencia entre los códigos de región y de país y una lista de identificadores de grupo (ordenados según su prioridad de conmutación por error) para la región.
  • proxied: Controla si el tráfico debe pasar por las funciones de seguridad y rendimiento de CIS.
  • enabled: Si se debe habilitar (por defecto) este equilibrador de carga.
  • session_affinity garantiza que las solicitudes de un usuario se dirijan siempre al mismo servidor backend durante una sesión. Los valores válidos son cookie y none.
  • session_affinity_ttl: Tiempo, en segundos, hasta que caduque la cookie de afinidad de sesión de este equilibrador de carga tras su creación. El valor válido está comprendido entre [1800, 604800]. El valor predeterminado es 82800.
  • steering_policy: Los valores válidos para steering_policy son off, geo, random, dynamic_latency.
    • off: Utiliza default_pools.
    • geo: Utiliza region_pools/pop_pools.
    • random: Selecciona un grupo al azar.
    • dynamic_latency: Utilice el tiempo de ida y vuelta para seleccionar el grupo más cercano en ( default_pools requiere comprobaciones de estado del grupo).

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Datos JSON que describen un equilibrador de carga global.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear un equilibrador de carga global en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

GLB_ID

El ID del equilibrador de carga global. Obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un equilibrador de carga global. Obligatorio.

• Los campos obligatorios en los datos JSON son name, fallback_pool, y : default_pools
  • name: El nombre de host DNS que se debe asociar a su equilibrador de carga.
  • fallback_pool: El ID del grupo que se debe utilizar cuando se detecta que todos los demás grupos no funcionan correctamente.
  • default_pools: Una lista de identificadores de grupo ordenados según su prioridad de conmutación por error.
• Los campos opcionales son description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: La descripción de su equilibrador de carga.
  • ttl: Tiempo de vida (TTL) de la entrada DNS correspondiente a la dirección IP devuelta por este equilibrador de carga.
  • region_pools: Una correspondencia entre los códigos de región y de país y una lista de identificadores de grupo (ordenados según su prioridad de conmutación por error) para la región.
  • proxied: Controla si el tráfico debe pasar por las funciones de seguridad y rendimiento de CIS.
  • enabled: Si se debe habilitar (por defecto) este equilibrador de carga.
  • session_affinity garantiza que las solicitudes de un usuario se dirijan siempre al mismo servidor backend durante una sesión. Los valores válidos son cookie y none.
  • session_affinity_ttl: Tiempo, en segundos, hasta que caduque la cookie de afinidad de sesión de este equilibrador de carga desde el momento de su creación. El valor válido está comprendido entre [1800, 604800]. El valor predeterminado es 82800.
  • steering_policy: Los valores válidos para steering_policy son off, geo, random, dynamic_latency.
    • off: Utiliza default_pools.
    • geo: Utiliza region_pools/pop_pools.
    • random: Selecciona un grupo al azar.
    • dynamic_latency: Utilice el tiempo de ida y vuelta para seleccionar el grupo más cercano en ( default_pools requiere comprobaciones de estado del grupo).

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Datos JSON que describen un equilibrador de carga global.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualice el equilibrador de carga global GLB_ID en el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

GLB_ID

El ID del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar el equilibrador de carga global GLB_ID en el dominio DNS_DOMAIN_ID.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

GLB_ID

El ID del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar el equilibrador de carga global GLB_ID del dominio DNS_DOMAIN_ID.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Lista de equilibradores de carga para el dominio DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

Especifique el formato de salida. Solo se admite JSON.

Ejemplos

Lista de todos los grupos GLB.

ibmcloud cis glb-pools

Opciones de comando

--json

El archivo JSON o la cadena JSON que se utiliza para describir un grupo GLB. Obligatorio.

• Los campos obligatorios en los datos JSON son name, origins y : check_regions
  • name: Un nombre corto (etiqueta) para el grupo.
  • origins: Una lista de orígenes dentro de este conjunto.
  • check_regions: Lista de códigos de regiones geográficas.
• Los campos opcionales son description, minimum_origins, enabled, monitor.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON utilizados para describir una agrupación GLB.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

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

Opciones de comando

GLB_POOL_ID

El ID del grupo del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar los detalles del grupo GLB GLB_POOL_ID.

ibmcloud cis glb-pool GLB_POOL_ID

Opciones de comando

GLB_POOL_ID

El ID del grupo del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar el grupo GLB GLB_POOL_ID.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Opciones de comando

GLB_POOL_ID

El ID del grupo del equilibrador de carga global. Obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un grupo GLB.

• Los campos obligatorios en los datos JSON son name, origins y : check_regions
  • name: Un nombre corto (etiqueta) para el grupo.
  • origins: Una lista de orígenes dentro de este conjunto.
  • check_regions: Lista de códigos de regiones geográficas.
• Los campos opcionales son description, minimum_origins, enabled, monitor.

Datos JSON de ejemplo:

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

Habilite el origen dentro de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

--disable-origin

Inhabilite el origen dentro de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

--add-origin

Añada un origen a la agrupación. ORIGIN_NAME y ORIGIN_ADDRESS son obligatorios. Por ejemplo: --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Elimine un origen de la agrupación. El valor puede ser ORIGIN_NAME u ORIGIN_ADDRESS.

-s, --json-str

Obsoleto. Los datos JSON utilizados para describir una agrupación GLB.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar el grupo 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}]}'

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumerar todos los monitores GLB.

ibmcloud cis glb-monitors

Opciones de comando

--json

El archivo JSON o la cadena JSON que se utiliza para describir un monitor GLB. Obligatorio.

• Los campos obligatorios en los datos JSON son type.
  • type: El protocolo que se debe utilizar para la comprobación de estado. Los valores válidos son HTTP, HTTPS, y TCP.
• Los campos opcionales son description, timeout, retries, interval.
  • description: Descripción.
  • timeout: El tiempo de espera (en segundos) antes de marcar la comprobación de estado como fallida.
  • retries: El número de reintentos que se deben realizar en caso de que se agote el tiempo de espera antes de marcar el origen como no operativo.
  • interval: El intervalo entre cada comprobación de estado.
• Para la comprobación de estado de tipo TCP. Los campos obligatorios adicionales son port.
  • port: El puerto TCP que se debe utilizar para la comprobación de estado.
• Para la comprobación de estado de tipo HTTP/HTTPS. Los campos opcionales adicionales son port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: El puerto TCP que se debe utilizar para la comprobación de estado.
  • expected_body: Una subcadena, sin distinción entre mayúsculas y minúsculas, que se debe buscar en el cuerpo de la respuesta.
  • expected_codes: El código de respuesta HTTP esperado o el rango de códigos de la comprobación de estado.
  • method: El método HTTP que se debe utilizar para la comprobación de estado.
  • path: La ruta del punto final con el que se realizará la comprobación de estado.
  • header: Los encabezados de solicitud de HTTP que hay que enviar en la comprobación de estado.
  • follow_redirects: Seguir las redirecciones si las devuelve el origen.
  • allow_insecure: No valide el certificado cuando utilice HTTPS.
  • probe_zone: Asigna este monitor para que emule la zona especificada durante la comprobación.

Datos JSON de ejemplo:

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

Para TCP:

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

-s, --json-str

Obsoleto. Los datos JSON utilizados para describir un supervisor de GLB.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear un monitor GLB.

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

Opciones de comando

GLB_MON_ID

El ID del monitor del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar los detalles del monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor GLB_MON_ID

Opciones de comando

GLB_MON_ID

El ID del supervisor del equilibrador de carga global. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Borrar el monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Opciones de comando

GLB_MON_ID

El ID del monitor del equilibrador de carga global. Obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir un monitor GLB. Obligatorio.

• Los campos obligatorios en los datos JSON son type.
  • type: El protocolo que se debe utilizar para la comprobación de estado. Los valores válidos son HTTP, HTTPS, y TCP.
• Los campos opcionales son description, timeout, retries, interval.
  • description: Descripción.
  • timeout: El tiempo de espera (en segundos) antes de marcar la comprobación de estado como fallida.
  • retries: El número de reintentos que se deben realizar en caso de que se agote el tiempo de espera antes de marcar el origen como no operativo.
  • interval: El intervalo entre cada comprobación de estado.
• Para la comprobación de estado de tipo TCP. Los campos obligatorios adicionales son port.
  • port: El puerto TCP que se debe utilizar para la comprobación de estado.
• Para la comprobación de estado de tipo HTTP/HTTPS. Los campos opcionales adicionales son port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: El puerto TCP que se debe utilizar para la comprobación de estado.
  • expected_body: Una subcadena, sin distinción entre mayúsculas y minúsculas, que se debe buscar en el cuerpo de la respuesta.
  • expected_codes: El código de respuesta HTTP esperado o el rango de códigos de la comprobación de estado.
  • method: El método HTTP que se debe utilizar para la comprobación de estado.
  • path: La ruta del punto final con el que se realizará la comprobación de estado.
  • header: Los encabezados de solicitud de HTTP que hay que enviar en la comprobación de estado.
  • follow_redirects: Seguir las redirecciones si las devuelve el origen.
  • allow_insecure: No valide el certificado cuando utilice HTTPS.
  • probe_zone: Asigna este monitor para que emule la zona especificada durante la comprobación.

Datos JSON de ejemplo:

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

Para TCP:

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

-s, --json-str

Obsoleto. Los datos JSON utilizados para describir un supervisor de GLB.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualización del monitor GLB GLB_MON_ID.

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

Opciones de comando

-s, --since

Fecha de inicio solicita el periodo de datos en formato ISO8601. Por ejemplo, 2018-11-26.

-u, --until

Fecha de finalización solicita el periodo de datos en formato ISO8601. Por ejemplo, 2018-11-28.

--origin-name

Nombre del origen por el que filtrar.

--pool-name

Nombre de la agrupación por la que filtrar.

--origin-healthy

Si es verdadero, filtra los eventos en los que el estado del origen sea correcto; si es falso, filtra los eventos en los que el estado del origen sea incorrecto. El valor por defecto es true y los valores válidos son true y false.

--pool-healthy

Si es verdadero, filtra los eventos en los que el estado del grupo sea correcto; si es falso, filtra los eventos en los que el estado del grupo sea incorrecto. El valor por defecto es true y los valores válidos son true y false.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener eventos glb.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--fields

Define el conjunto de campos en la respuesta.

• Este campo debe especificarse como una lista separada por comas sin espacios en blanco, y todos los campos deben estar rellenados.
• No importa el orden en que se especifiquen los campos y el orden de los campos en la respuesta no se especifica.
• Los campos deben distinguir entre mayúsculas y minúsculas.

--filter

Filtros para detallar más en sucesos específicos. Los filtros constan de tres partes: clave, operador y valor. Para obtener información sobre los operadores admitidos, consulte Uso de campos, funciones y expresiones.

--sample

La tasa de muestreo de los registros establecida por el cliente: 1 equivale al 100 % de los registros sample.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

-h, --help

Obtén ayuda sobre este comando.

Ejemplos

Crear un registro instantáneo para el dominio DNS_DOMAIN_ID:

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

A continuación se presentan tres ejemplos de filtros:

• Filtrar cuando el país de la IP del cliente no sea Canadá:

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

• Filtrar cuando el código de estado devuelto por CIS sea 200 o 201:

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

• Filtrar cuando la ruta de la solicitud contenga "/static" y el nombre de host de la solicitud sea " example.com ":

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

-h, --help

Ayuda sobre este comando.

Ejemplo

Consigue el trabajo de registros instantáneos para el dominio DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis leaked-credential-checks status-get DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--enabled

Indica si están activadas las comprobaciones de credenciales filtradas para el dominio DNS. Los valores válidos son true y false.

--json

El archivo JSON o la cadena JSON que describe la configuración de comprobación de credenciales filtradas. El campo obligatorio es enabled.

{
  "enabled": true
}

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID --enabled true
ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID --json @status.json --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis leaked-credential-checks detection-list DNS_DOMAIN_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DETECTION_ID

El ID de la detección personalizada de credenciales filtradas. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplo

ibmcloud cis leaked-credential-checks detection-get DNS_DOMAIN_ID DETECTION_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--username

La expresión del conjunto de reglas que localiza el nombre de usuario en una solicitud. Obligatorio cuando no --json se utiliza.

--password

La expresión del conjunto de reglas que localiza la contraseña en una solicitud. Obligatorio cuando no --json se utiliza.

--json

El archivo JSON o la cadena JSON que describe la detección personalizada. Los campos obligatorios son username y password.

{
  "username": "lookup_json_string(http.request.body.raw, \"username\")",
  "password": "lookup_json_string(http.request.body.raw, \"password\")"
}

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID --username 'lookup_json_string(http.request.body.raw, "username")' --password 'lookup_json_string(http.request.body.raw, "password")'
ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID --json @detection.json --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DETECTION_ID

El ID de la detección personalizada de credenciales filtradas. Obligatorio.

--username

La expresión del conjunto de reglas que localiza el nombre de usuario en una solicitud.

--password

La expresión del conjunto de reglas que localiza la contraseña en una solicitud.

--json

El archivo JSON o la cadena JSON que describe la detección personalizada. Los campos opcionales son y username password; especifique al menos uno.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID --username 'lookup_json_string(http.request.body.raw, "email")'
ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID --json @detection.json --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DETECTION_ID

El ID de la detección personalizada de credenciales filtradas. Obligatorio.

-f, --force

Eliminar la detección sin solicitar confirmación.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplo

ibmcloud cis leaked-credential-checks detection-delete DNS_DOMAIN_ID DETECTION_ID --force

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

RAY_ID

El ID de Ray de la solicitud. Obligatorio.

--fields

Una lista, separada por comas, de campos de registro (que distinguen entre mayúsculas y minúsculas) que se van a devolver.

--timestamps

El formato de los campos de fecha y hora. Los valores válidos son unix, unixnano, y rfc3339. El valor predeterminado es unix.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

ibmcloud cis log-lookup-rayid DNS_DOMAIN_ID RAY_ID
ibmcloud cis log-lookup-rayid DNS_DOMAIN_ID RAY_ID --fields RayID,ClientIP,EdgeResponseStatus --timestamps rfc3339 --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--available-fields

Lista de todos los campos disponibles.

--ray-id

Buscar registros por ray id específico.

--fields

Define el conjunto de campos en la respuesta. Este campo debe especificarse como una lista separada por comas, sin espacios, y todos los campos deben estar rellenados. No importa el orden en que se especifiquen los campos y el orden de los campos en la respuesta no se especifica. Tenga en cuenta que los campos distingan entre mayúsculas y minúsculas.

--start

El inicio (inclusivo) del intervalo de tiempo solicitado. Puede ser una indicación de fecha y hora de unix (en segundos o nanosegundos) o una indicación de fecha y hora absoluta que cumpla con RFC 3339. Actualmente, no puede superar un periodo en el pasado superior a 7 días. El valor predeterminado es 65 minutos antes.

--end

El final (exclusivo) del intervalo de tiempo solicitado. Este valor puede ser una marca de tiempo Unix (en segundos o nanosegundos) o una marca de tiempo absoluta que cumpla con la norma RFC 3339. El valor de end debe ser al menos 5 minutos anterior que ahora y debe ser posterior al valor de start. La diferencia entre y start no end debe ser superior a 1h. El valor predeterminado es 5 minutos antes.

--count

Número de registros que se deben recuperar. El valor predeterminado es -1.

--sample

Porcentaje de muestreo. Cuando se proporciona una muestra, se devuelve una muestra de registros coincidentes. Si sample=0.1 entonces se devuelven el 10 % de los registros. El muestreo es aleatorio: las llamadas repetidas no solo devuelven registros diferentes, sino que probablemente también varían ligeramente en el número de registros devueltos. Cuando también se especifica el recuento, éste se aplica al número de registros devueltos, no a los registros de muestreo. Así pues, con sample=0.05 y count=7, cuando hay un total de 100 registros disponibles, se devuelven aproximadamente 5 registros. Cuando hay 1.000 registros, se devuelven 7 registros. Cuando hay 10 000 registros, se devuelven 7 registros. El valor predeterminado es 1.

--timestamps

Establezca el formato en el que se devolverán las indicaciones de fecha y hora de la respuesta. Los valores válidos son unix, unixnano y rfc3339.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--destination

Especifica el destino al que se envían los datos. Para obtener más información sobre los destinos admitidos, consulte Gestión de trabajos Logpush.

• Sintaxis de la ruta « Cloud Object Storage »: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Ejemplo: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Para separar los registros en subcarpetas diarias, utiliza la cadena especial en {DATE} la ruta del depósito. Se sustituye por la fecha en el formato YYYYMMDD 20190423, por ejemplo. Se crean subcarpetas según sea necesario, por ejemplo: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Nombre del trabajo. Obligatorio.

--enable

Habilitar el trabajo. El trabajo está inhabilitado de forma predeterminada.

--fields

Definir la lista de campos que se deben incluir en los archivos de registro. Los distintos campos se pueden separar con comas; utilice comando [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] para obtener la lista completa de campos de registro disponibles, o utilice all para incluir todos los campos disponibles en los archivos de registro. Tenga en cuenta que los campos distingan entre mayúsculas y minúsculas.

--timestamps

Establezca el formato en el que se devolverán las indicaciones de fecha y hora de la respuesta. Los valores válidos son unix, unixnano y rfc3339.

--dataset

La categoría de registros que desea recibir. Este valor no se puede modificar una vez creado el trabajo. Los valores válidos son http_requests, range_events, firewall_events, dns_logs. El valor por defecto es http_requests.

--frequency

La frecuencia con la que CIS envía lotes de registros a su destino. Si se establece la frecuencia en alta, los registros se envían en mayor cantidad, pero en archivos más pequeños. Al establecer la frecuencia en baja, los registros se envían en cantidades más reducidas, pero en archivos de mayor tamaño. Los valores válidos son high, low.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear una tarea logpush para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--destination

Especifica el destino al que se envían los datos. Para obtener más información sobre los destinos admitidos, consulte Gestión de trabajos Logpush. Sintaxis de la ruta « Cloud Object Storage »: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Ejemplo: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Para separar los registros en subcarpetas diarias, utilice la serie especial {DATE} en la vía de acceso del grupo. Debe sustituirse por la fecha en el formato YYYYMMDD, por ejemplo, 20190423. Se crean subcarpetas según sea necesario, por ejemplo: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Habilitar el trabajo. El trabajo está inhabilitado de forma predeterminada.

--fields

Definir la lista de campos que se deben incluir en los archivos de registro. Si especifica varios campos, sepárelos con comas y utilice el mandato ibmcloud cis logpush-available-fields DNS_DOMAIN_ID para obtener la lista completa de campos de registro disponibles, o bien utilice all para incluir todos los campos disponibles en los archivos de registro. Tenga en cuenta que los campos distingan entre mayúsculas y minúsculas.

--timestamps

Establezca el formato en el que se devolverán las indicaciones de fecha y hora de la respuesta. Los valores válidos son unix, unixnano, rfc3339.

--dataset

La categoría de registros que desea recibir. Este valor no se puede modificar una vez creado el trabajo. Los valores válidos son http_requests, range_events, firewall_events,dns_logs. El valor por defecto es http_requests.

--jobid

JOB_ID es el ID del trabajo logpush.

--frequency

La frecuencia con la que CIS envía lotes de registros a su destino. Si se establece la frecuencia en alta, los registros se envían en mayor cantidad, pero en archivos más pequeños. Al establecer la frecuencia en baja, los registros se envían en cantidades más reducidas, pero en archivos de mayor tamaño. Los valores válidos son high y low.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar range_events logpush job para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

-output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener todos los trabajos logpush para el dominio DNS_DOMAIN_ID.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--dataset

La categoría de registros que desea recibir. Este valor no se puede modificar una vez creado el trabajo. Los valores válidos son http_requests, range_events, firewall_events,dns_logs. El valor por defecto es http_requests.

--jobid

JOB_ID es el ID del trabajo logpush.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtenga detalles del trabajo logpush de http_requests.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--dataset

La categoría de registros que desea recibir. Este valor no se puede modificar una vez creado el trabajo. Los valores válidos son http_requests, range_events, firewall_events,dns_logs. El valor por defecto es http_requests.

--jobid

JOB_ID es el ID del trabajo logpush.

-f, --force

Eliminar la tarea de logpush sin solicitar confirmación.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Borrar http_requests logpush job para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--dataset

La categoría de registros que desea recibir. Este valor no se puede modificar una vez creado el trabajo. Los valores válidos son http_requests, range_events, firewall_events,dns_logs. El valor por defecto es http_requests.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Obtener todos los campos disponibles para los registros de http_requests.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener una configuración de retención de registros para el dominio DNS_DOMAIN_ID.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--flag

Si se debe activar o desactivar la retención de registros. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Habilitar la retención de registros para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--dataset

Conjunto de datos solicitado. El valor predeterminado es firewallEventsAdaptiveGroups.

Utilice la siguiente tabla para identificar qué conjuntos de datos se incluyen en el plan y el rango de datos históricos que puede consultar.

Conjuntos de datos incluidos en su plan

Conjunto de datos	De prueba / Estándar / Estándar-Siguiente	Empresa / Seguridad / GLB
firewallEventsAdaptiveGroups	30 días	30 días
firewallEventsAdaptive	30 días	30 días

--filter

Filtrar sucesos. El valor predeterminado en las últimas 6 horas de datos.

Los siguientes operadores están soportados para todas las opciones de filtro:

Operadores compatibles con las opciones de filtro

Operador	Comparación
gt	mayor que
lt	menor que
geq	mayor que o igual que
leq	menor que o igual a
neq	no igual a
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

Orden de salida. (El valor por defecto es datetime_ASC)

La lista siguiente contiene las opciones de orden que se pueden utilizar para el conjunto de datos correspondiente y todas las opciones de orden dan soporte a la acción ASC y DESC. Combine estas opciones de filtro y la acción con _.

Por ejemplo, datetime_ASC ordena por fecha y hora en orden ascendente.

• Opciones de orden 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

El número de eventos a devolver. (mínimo: 1, máximo: 10000, predeterminado: 10000)

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtén análisis de eventos del cortafuegos para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--dataset

Conjunto de datos solicitado. El valor predeterminado es httpRequests1dGroups. Utilice la siguiente tabla para identificar qué conjuntos de datos se incluyen en el plan y el rango de datos históricos que puede consultar.

Identificar los conjuntos de datos incluidos en su plan

Conjunto de datos	De prueba / Estándar / Estándar-siguiente	Empresa / Seguridad / GLB
httpRequests1dGroups	365 días	365 días
httpRequests1hGroups	30 días	90 días
httpRequests1mGroups	3 días	7 días

--filter

Filtrar sucesos. El valor predeterminado son los últimos 7 días de datos. Los siguientes operadores están soportados para todas las opciones de filtro:

Operadores compatibles con las opciones de filtro

Operador	Comparación
gt	mayor que
lt	menor que
geq	mayor que o igual que
leq	menor que o igual a
neq	no igual a
in	in

• Opciones de filtro httpRequests1dGroups y httpRequests1hGroups.

  • date

• Opciones de filtro de httpRequests1mGroups.

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Orden de salida. (El valor por defecto es datetime_ASC)

La lista siguiente contiene las opciones de orden que se pueden utilizar para el conjunto de datos correspondiente y todas las opciones de orden dan soporte a la acción ASC y DESC. Combine estas opciones de orden y acción con _.

Por ejemplo, date_ASC ordenar por fecha ascendente.

• Opciones de orden común para cada conjunto de datos http.
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Opciones de orden httpRequests1dGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Opciones de orden httpRequests1hGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Opciones de orden httpRequests1mGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

El número de eventos a devolver. (mínimo: 1, máximo: 10000, predeterminado: 10000)

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtén análisis de solicitudes HTTP para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--recent

Inicio del intervalo de tiempo solicitado. Los valores válidos son ( 6h hace 6 horas), 12h, 1d (hace 1 día), 1w (hace 1 semana), 1m (hace 1 mes), 2m, 3m. El valor por defecto es 1w.

-t, --table

Genera la salida de la tabla. Los valores válidos son requests, bandwidth, uniques, y threats status_code. Si este campo no está configurado, da salida a todas las tablas.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Consigue estadísticas web para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

DIMENSION

La dimensión consultada. Los valores válidos son queries-by-response-code, queries-by-type, queries-by-name. Obligatorio.

-s, --since

Desde la hora hasta ahora. Los valores válidos son ( 6h hace 6 horas), 12h, 1d (hace 1 día), 1w (hace 1 semana).

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtén análisis de DNS para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--recent

Inicio del intervalo de tiempo solicitado. Los valores válidos son ( 6h hace 6 horas), 12h, 1d (hace 1 día), 1w (hace 1 semana), 1m (hace 1 mes), 2m, 3m. El valor por defecto es 1w.

--time-delta

Intervalo de tiempo (segundos) de cada registro de analítica. Los valores válidos son 60, 3600, 86400, 2592000. El valor por defecto es 3600.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtén análisis de límites de tasa para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Activar Mutua TLS.

ibmcloud cis access-enable

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumera todos los certificados de origen del dominio DNS_DOMAIN_ID.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--request-type REQUEST_TYPE

Tipo de firma que desea en el certificado. Los valores válidos son origin-rsa y origin-ecc.

--hostnames HOSTNAME

nombre de host o nombre comodín que está vinculado al certificado.

--requested-validity DAYS

El número de días durante los cuales el certificado debe ser válido. El valor predeterminado es 5475.

--csr CSR

La solicitud de firma de certificado (CSR). Si este campo no está configurado, CIS genera uno.

--json value*

El archivo JSON o la cadena JSON que se utiliza para describir un certificado de origen.

• Los campos obligatorios en los datos JSON son request_type, hostnames.
  • request_type tipo de firma que desea en el certificado. Los valores válidos son origin-rsa, origin-ecc.
  • hostnames: Un conjunto de nombres de host o nombres con comodín vinculados al certificado.
• Los campos opcionales son requested_validity, csr.
  • requested_validity: El número de días durante los cuales el certificado debe ser válido. Los valores válidos son 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: La solicitud de firma de certificado (CSR). Si este campo no está configurado, CIS genera uno.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen un certificado de origen.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear un certificado firmado por CIS para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

CERT_ID

El ID del Certificado de Origen. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Obtener detalles del certificado de origen CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

CERT_ID

El ID del certificado de origen. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar el certificado de origen CERT_ID.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Mostrar la información general sobre el dominio DNS_DOMAIN_ID.

ibmcloud cis overview DNS_DOMAIN_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una regla de página. Obligatorio.

• Los campos obligatorios en los datos JSON son targets y actions:
  • targets: El patrón de URL de destino que se debe evaluar en una solicitud.
  • actions: Conjunto de acciones que se deben llevar a cabo si los objetivos de esta regla coinciden con la solicitud. Las acciones disponibles son:
    • 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
    • Desaprobado. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Algunas acciones están limitadas a los planes 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
• Los campos opcionales son priority y : status
  • priority: Número que indica la preferencia de una regla de página frente a otra. El valor predeterminado es 1.
  • status: Estado de la regla de la página. Los valores válidos son active y ( disabled por defecto).

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla de página.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Crear una regla de página para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

PAGE_RULE_ID

El ID de la regla de página. Obligatorio.

--json VALUE

El archivo JSON o la cadena JSON que se utiliza para describir una regla de página. Obligatorio.

• Los campos obligatorios en los datos JSON son targets y : actions
  • targets: El patrón de URL de destino que se debe evaluar en una solicitud.
  • actions: Conjunto de acciones que se deben llevar a cabo si los objetivos de esta regla coinciden con la solicitud. Las acciones disponibles son:
    • 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
    • Desaprobado. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Algunas acciones están limitadas a los planes 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
• Los campos opcionales son priority y : status
  • priority: Número que indica la preferencia de una regla de página frente a otra. El valor predeterminado es 1.
  • status: Estado de la regla de la página. Los valores válidos son active y disabled. El valor predeterminado es disabled.

Datos JSON de ejemplo:

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

-s, --json-str

Obsoleto. Los datos JSON que describen una regla de página.

-j, --json-file

Obsoleto. Un archivo que contiene datos JSON de entrada.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Actualizar la regla de la página 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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

PAGE_RULE_ID

El ID de la regla de página. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

Ejemplos

Eliminar la regla de la página PAGE_RULE_ID.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Enumera todas las normas de las páginas del dominio DNS_DOMAIN_ID.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

PAGE_RULE_ID

El ID de la regla de página. Obligatorio.

-i, --instance

Nombre o ID de instancia. Si no se define el nombre o el ID de la instancia, se utilizará la instancia de contexto especificada en ibmcloud cis instance-set INSTANCE.

--output

El formato de salida. Actualmente, json es el único valor admitido.

Ejemplos

Consulta los detalles de la regla de página PAGE_RULE_ID.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

--name

El nombre del registro DNS para la aplicación de rango.

--edge-port

Configuración de puerto en el extremo de CIS. El valor predeterminado es 22.

--origin-direct

Direcciones de destino en el origen.

--origin-lb-name

El nombre del equilibrador de carga asociado a la aplicación range.

--origin-lb-port

El puerto del equilibrador de carga asociado a la aplicación range. El valor predeterminado es 22.

--protocol

Tipo de protocolo. Los valores válidos son tcp y udp. El soporte para el protocolo UDP está en la fase de acceso anticipado; solicite un UDP personalizado desde el panel de control de CIS antes de crear una app UDP de rango. El valor predeterminado es tcp.

--proxy-protocol

Habilitar Protocolo proxy en el origen. Los valores válidos son on, off, v1, v2, simple. El valor por defecto es off. Obsoleto. El valor on equivale a v1.

--ip-firewall

Controla si el Firewall IP para esta aplicación está activado. Los valores válidos son on y off. El valor predeterminado es off.

--edge-connectivity

Las versiones de IP compatibles para conexiones entrantes en un rango de direcciones IP de anycast. Los valores válidos son all, ipv4, ipv6. El valor por defecto es all.

--edge-tls

Tipo de terminación TLS asociado a la aplicación. Los valores válidos son off, flexible, full, strict. El valor por defecto es off.

--traffic-type

Determina cómo viajan los datos desde el extremo al origen. Los valores válidos son direct, http, https. El valor por defecto es direct.

--json

El archivo JSON o la cadena JSON que se utiliza para describir una aplicación de rango.

• Los campos obligatorios en los datos JSON son protocol y dns.
  • protocol: Configuración de puertos en el perímetro de CIS.
  • dns: El nombre y el tipo del registro DNS para la aplicación de rango.
    • name: El nombre del registro DNS para la aplicación de rango.
    • type: El tipo de registro DNS asociado a la aplicación. El valor válido es CNAME.
• Los campos opcionales son origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls, y traffic_type.
  • origin_direct: Una lista de direcciones de destino del origen.
  • origin_dns: Método y parámetros que se utilizan para determinar la dirección del servidor de origen a través del DNS.
    • name: Nombre del registro DNS.
  • origin_port: El puerto de destino en el origen.
  • proxy_protocol: Habilite el protocolo proxy en el origen. Los valores válidos son on, off, v1, v2, simple. El valor por defecto es off. En desuso. El valor on equivale a v1.
  • ip_firewall: Controla si el Firewall IP para esta aplicación está activado. Los valores válidos son on y off.
  • edge_ips: La configuración de IP de borde anycast para el nombre de host de esta aplicación.
    • type: El tipo de configuración de IP perimetral especificado. Las IP de extremo asignadas dinámicamente utilizan las IP anycast de rango en función de la conectividad que especifique. El valor válido es dynamic.
    • connectivity: Las versiones de IP compatibles para conexiones entrantes en un rango de direcciones IP de anycast. Valores válidos: all, ipv4, ipv6.
  • tls: el tipo de terminación TLS asociada a la aplicación. Los valores válidos son off, flexible, full, y strict.
  • traffic_type: Determina cómo se transmiten los datos desde el borde hasta su origen. Cuando se configura en direct, range envía el tráfico directamente a tu origen, y el tipo de aplicación se deriva del protocolo. Cuando se establece en http o https, range aplica las características HTTP / HTTPS de CIS al enviar tráfico a su origen, y el tipo de aplicación coincide exactamente con esta propiedad. Los valores válidos son direct, http, y https. El valor predeterminado es direct.