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 periodo de validez de 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 para los que se solicita 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 para los que se solicita 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-DER_BASE64 » y « CF-Client-Cert-SHA256 ».

-v, --value

El valor establecido en la característica para certificados.

client_certificate_forwarding

Especifica el nombre de host para el que se debe 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 se ajusta al 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

Crea una política de acceso para la aplicación 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 20M solo 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

Seguir mostrando a los usuarios el contenido almacenado en caché cuando los servidores de origen estén fuera de línea, incluso si dicho 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 identificador 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 identificador 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 identificador 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 identificador 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 identificador 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 identificador de la lista personalizada.

--asn

El valor ASN.

--ip

La dirección de 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 identificador 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 identificador 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 y 500_errors. Campo 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 El proxy solo redirige el tráfico correspondiente a los registros A, AAAA y CNAME. 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 modelos A, AAAA, CNAME, NS y 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 servidores proxy solo gestionan el tráfico correspondiente a los registros de A, AAAA y CNAME.

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: Minutos de latitud
      • lat_seconds: Segundos de latitud.
      • lat_direction: Dirección de la 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 del lugar en metros.
      • size: Dimensiones del emplazamiento 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 récord. - 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

En desuso. Datos JSON utilizados para describir un registro DNS.

-j, --json-file

En desuso. 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

Crea 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 El proxy solo redirige el tráfico correspondiente a los registros A, AAAA y CNAME. 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 modelos A, AAAA, CNAME, NS y 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 servidores proxy solo gestionan el tráfico correspondiente a los registros de A, AAAA y CNAME.

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: Minutos de latitud
      • lat_seconds: Segundos de latitud.
      • lat_direction: Dirección de la 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 del lugar en metros.
      • size: Dimensiones del emplazamiento 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 récord.
      • 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

En desuso. Datos JSON utilizados para describir un registro DNS.

-j, --json-file

En desuso. 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

Actualiza 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 ordenará la lista de registros DNS. Los valores válidos son type, name, content, ttl y proxied.

--direction

Orden en el que se deben ordenar 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 de ellos. 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 en el que se guardan 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ñade 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: Redirigir todas las solicitudes con el esquema http a https. Esta configuración se aplica a todas las solicitudes de tipo « HTTP » dirigidas al dominio.
• automatic_https_rewrites: Ayuda a solucionar el problema del contenido mixto cambiando http por https en 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: Analiza los encabezados « HTTP » del navegador de tus visitantes para detectar posibles amenazas. Si se encuentra una amenaza, se entrega una página de bloqueo.
• challenge_ttl: Indica 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 seguridad.
• 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 cifrado incluido en la lista de permitidos, la lista estará vacía y se utilizarán los cifrados 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 el destino al que 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 los enlaces externos.
• http2: Acelera tu página web con HTTP/2.
• http3: Acelera tu página 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 que se realicen a tu sitio web.
• ipv6: Activar la compatibilidad con « IPv6 » y la pasarela.
• max_upload: El número de visitantes que pueden cargar datos en tu página web en una sola solicitud.
• min_tls_version: Permitir únicamente conexiones HTTPS de visitantes que admitan la versión del protocolo TLS seleccionada 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 una página web optimizada para móviles.
• opportunistic_encryption: El cifrado oportunista permite a los navegadores aprovechar el mejor rendimiento de HTTP/2 al indicarles que tu 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 para tu sitio web.
• security_level: Elige el perfil de seguridad adecuado para tu página web.
• server_side_exclude: Ocultar automáticamente contenido específico a los visitantes sospechosos.
• tls_client_auth: Se ha presentado un certificado de cliente de TLS para la autenticación en la solicitud de obtención del 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

Consigue los ajustes de « ciphers » para el 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 deben actualizar. Obligatorio. Valores válidos:

• always_use_https: Redirigir 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 solucionar el problema del contenido mixto cambiando http por https en 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: Analiza los encabezados « HTTP » del navegador de tus visitantes para detectar posibles amenazas. Si se encuentra una amenaza, se entrega una página de bloqueo.
• challenge_ttl: Indica 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 seguridad.
• ciphers: Una lista de cifrados para la terminación de TLS. Estos cifrados deben estar en formato BoringSSL.
• cname_flattening: Sigue un CNAME hasta el destino al que 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 los enlaces externos.
• http2: Acelera tu página web con HTTP/2.
• http3: Acelera tu página 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 que se realicen a tu sitio web.
• ipv6: Activar la compatibilidad con « IPv6 » y la pasarela.
• max_upload: El número de visitantes que pueden cargar datos en tu página web en una sola solicitud.
• min_tls_version: Permitir ú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 una página web optimizada para móviles.
• opportunistic_encryption: El cifrado oportunista permite a los navegadores aprovechar el mejor rendimiento de HTTP/2 al indicarles que tu 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 para tu sitio web.
• security_level: Elige el perfil de seguridad adecuado para tu página web.
• server_side_exclude: Ocultar automáticamente contenido específico a los visitantes sospechosos.
• tls_client_auth: Se ha presentado un certificado de cliente de TLS para la autenticación en la solicitud de obtención del 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: Elimina 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 se indica « hold_after », la retención se desactiva temporalmente y, posteriormente, el sistema la vuelve a activar automáticamente a la hora especificada.

  Para habilitar el dominio y los subdominios, visita: -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.

• En desuso. 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 que ello afecte 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: Minifica automáticamente todo el código CSS de tu página web. Los valores válidos para css son on, off.
  • html: Minimiza automáticamente todo el código HTML de tu página web. Los valores válidos para html son on, off.
  • js: Minifica automáticamente todo el código JS de tu página 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 está activada la redirección móvil. Los valores válidos para « status » son « on » y « off ».
  • mobile_subdomain: A qué prefijo de subdominio quieres redirigir a los visitantes que utilicen dispositivos móviles (el subdominio debe existir).
  • strip_uri: Si se debe descartar 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: Aunque se anuncian algoritmos poscuánticos, estos solo se utilizan cuando así lo solicita el remitente.
  • preferred: La opción «Preferred» indica a CIS que, cuando sea posible, envíe un intercambio de claves poscuánticas (PQ) en el primer mensaje al origen (para conexiones más rápidas cuando el origen admita y prefiera PQ).
  • off: No se anuncian 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ñade ú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 cual se almacenan en caché los encabezados de seguridad en los navegadores.
  • include_subdomains: Todos los dominios subordinados a este dominio heredan el mismo «security_header». Los valores válidos para include_subdomains son true, false.
  • preload: Si se permite a los navegadores precargar la configuración de security_header. Los valores válidos para enabled son true, false.
  • nosniff: Si se debe enviar el encabezad 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 « URL » que lleva a cabo CIS. Los valores válidos para type son cis, rfc3986.
  • scope: Configura el ámbito de la normalización « 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

Activa la función « 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

Mostrar todos los desencadenantes de las funciones de Edge 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 las funciones de Edge: 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 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

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

Actualización: las funciones de Edge se activan al 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 las funciones de Edge que activan TRIGGER_ID.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Opciones de comando

-t, --type

Tipo de reglas de cortafuegos que se van a 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 son los siguientes.
  • Los campos obligatorios son mode, configuration.
    • mode: El tipo de acción que se debe realizar. Los valores válidos son block, challenge, whitelist y js_challenge.
    • configuration: Par «Valor objetivo/Valor» que se utilizará para esta regla.
      • target: La propiedad de la solicitud a la que se dirige. 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 limitado 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 te ayudará a comprender 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 son los siguientes.
  • Los campos obligatorios son mode, configuration.
    • mode: El tipo de acción que se debe realizar. Los valores válidos son block, challenge, y js_challenge.
    • configuration: Par «Valor objetivo/Valor» que se utilizará para esta regla.
      • target: La propiedad de la solicitud a la que se dirige. 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 te ayudará a comprender 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: Las URL que deben incluirse en la definición de esta regla.
      • Se pueden utilizar caracteres comodín.
      • El patrón « URL » introducido aquí se escapa antes de su uso.
      • Este campo limita el « URL » a patrones simples con comodines.
    • configurations: Lista de direcciones IP o rangos CIDR que se utilizarán para esta regla.
      • Este campo puede incluir cualquier número de configuraciones de direcciones IP o rangos de direcciones IP que puedan acceder a las URL indicadas.
      • target: La propiedad de la solicitud a la que se dirige. 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 te ayudará a comprender 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

En desuso. Los datos JSON que describen una regla de cortafuegos.

-j, --json-file

En desuso. 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 va a 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 tu sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Aplicar el control de acceso cuando coincida exactamente con el UserAgent facilitado 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 se debe realizar. Los valores válidos son block, challenge, whitelist y js_challenge.
    • notes: Información útil sobre esta norma que te ayudará a comprender 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 se debe realizar. Los valores válidos son block, challenge, y js_challenge.
    • configuration: Par «Valor objetivo/Valor» que se utilizará para esta regla.
      • target: La propiedad de la solicitud a la que se dirige. 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 te ayudará a comprender 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: Las URL que deben incluirse en la definición de esta regla.
      • Se pueden utilizar caracteres comodín.
      • El patrón « URL » introducido aquí se escapa antes de su uso.
      • Este campo limita el « URL » a patrones simples con comodines.
    • configurations: Lista de direcciones IP o rangos CIDR que se utilizarán para esta regla.
      • Este campo puede incluir cualquier número de configuraciones de direcciones IP o rangos de direcciones IP que puedan acceder a las URL indicadas.
      • target: La propiedad de la solicitud a la que se dirige. 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 te ayudará a comprender 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

En desuso. Los datos JSON que describen una regla de cortafuegos.

-j, --json-file

En desuso. 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 va a 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 tu sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Aplicar el control de acceso cuando coincida exactamente con el UserAgent facilitado 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 tu sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Aplicar el control de acceso cuando coincida exactamente con el UserAgent facilitado 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 tu sitio web. Puede aplicar reglas de acceso a un solo dominio o a todos los dominios de la misma instancia de servicio.
• ua-rules: Aplicar el control de acceso cuando coincida exactamente con el UserAgent facilitado 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 van desde 0 hasta 2147483647. El valor « 0 » significa establecer 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 van desde 0 hasta 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 se deben omitir. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit y waf. Por 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

En desuso. Los datos JSON que describen una regla cortafuegos.

-j, --json-file

En desuso. 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 van desde 0 hasta 2147483647. El valor « 0 » significa establecer 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 van desde 0 hasta 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 se deben omitir. Los valores válidos son zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit y waf. Por 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

En desuso. Los datos JSON que describen una regla cortafuegos.

-j, --json-file

En desuso. 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 tu 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 los ID de los grupos 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 tu 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 en CIS.
  • enabled: Si se desea activar (opción predeterminada) 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 debe estar comprendido entre [1800, 604800]. El valor predeterminado es 82800.
  • steering_policy: Los valores válidos para « steering_policy » son « off », « geo », « random » y « dynamic_latency ».
    • off: Utiliza default_pools.
    • geo: Utiliza region_pools/pop_pools.
    • random: Selecciona un grupo al azar.
    • dynamic_latency: Utiliza 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

En desuso. Datos JSON que describen un equilibrador de carga global.

-j, --json-file

En desuso. 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

Crea 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 tu 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 los ID de los grupos 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 tu 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 desea activar (opción predeterminada) 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 en que se crea. El valor válido debe estar comprendido entre [1800, 604800]. El valor predeterminado es 82800.
  • steering_policy: Los valores válidos para « steering_policy » son « off », « geo », « random » y « dynamic_latency ».
    • off: Utiliza default_pools.
    • geo: Utiliza region_pools/pop_pools.
    • random: Selecciona un grupo al azar.
    • dynamic_latency: Utiliza 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

En desuso. Datos JSON que describen un equilibrador de carga global.

-j, --json-file

En desuso. 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

Mostrar los equilibradores de carga del 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 breve (etiqueta) para el grupo.
  • origins: Una lista de orígenes incluidos en este conjunto.
  • check_regions: Una 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

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

-j, --json-file

En desuso. 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 identificador 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 identificador 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 identificador 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 breve (etiqueta) para el grupo.
  • origins: Una lista de orígenes incluidos en este conjunto.
  • check_regions: Una 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

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

-j, --json-file

En desuso. 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 del 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 revisión médica.
• Para la comprobación de estado de tipo TCP. Los campos obligatorios adicionales son port.
  • port: El puerto del servicio « 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 del servicio « 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 de « 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 « HTTP » que hay que enviar en la comprobación de estado.
  • follow_redirects: Seguir las redirecciones si las devuelve el origen.
  • allow_insecure: No valides el certificado cuando el monitor 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

En desuso. Los datos JSON utilizados para describir un supervisor de GLB.

-j, --json-file

En desuso. 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 del 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 revisión médica.
• Para la comprobación de estado de tipo TCP. Los campos obligatorios adicionales son port.
  • port: El puerto del servicio « 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 del servicio « 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 de « 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 « HTTP » que hay que enviar en la comprobación de estado.
  • follow_redirects: Seguir las redirecciones si las devuelve el origen.
  • allow_insecure: No valides el certificado cuando el monitor 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

En desuso. Los datos JSON utilizados para describir un supervisor de GLB.

-j, --json-file

En desuso. 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 presentes.
• 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: « sample: 1» corresponde al 100 % de los registros.

-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

Consulta la 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 gestión 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.

--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 presentes. 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 corresponder a una fecha del pasado anterior 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 de 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 start y end no 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 se establece « sample=0.1 », se devuelve el 10 % de los registros. El muestreo es aleatorio: las consultas repetidas no solo devuelven registros diferentes, sino que probablemente también varían ligeramente en cuanto al 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 1000 registros, se devuelven 7. Cuando hay 10 000 registros, se devuelven 7. 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 clasificar los registros en subcarpetas diarias, utiliza la cadena especial « {DATE} » en la ruta del depósito. Se sustituye por la fecha en 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-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 campos múltiples se pueden separar con comas y utilizar 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 deseas 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 ajustas la frecuencia a un valor alto, los registros se enviarán en cantidades mayores, pero en archivos más pequeños. Si se ajusta la frecuencia a un valor bajo, los registros se envían en cantidades más pequeñas, 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

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 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 y rfc3339.

--dataset

La categoría de registros que deseas 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 ajustas la frecuencia a un valor alto, los registros se enviarán en cantidades mayores, pero en archivos más pequeños. Si se ajusta la frecuencia a un valor bajo, los registros se envían en cantidades más pequeñas, 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 deseas 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 deseas 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 envío de registros 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 deseas 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

Consigue 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 desea activar o desactivar el registro de actividad. 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

Activar 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 los resultados 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 » ordena los resultados por fecha, de menor a mayor.

• 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 estadísticas 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, threats y 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 estadísticas 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 rate 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

Muestra 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 debe ser válido el certificado. 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 y origin-ecc.
  • hostnames: Una lista de nombres de host o nombres con comodines asociados al certificado.
• Los campos opcionales son requested_validity, csr.
  • requested_validity: El número de días durante los cuales debe ser válido el certificado. Los valores válidos son: 0, 7, 30, 90, 365, 730, 1095 y 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

En desuso. Los datos JSON que describen un certificado de origen.

-j, --json-file

En desuso. 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

Crea 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

Consulta los detalles del certificado de origen en 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 número de identificación 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 del 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 va a evaluar en una solicitud.
  • actions: Un 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 restringidas 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: Un 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

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

-j, --json-file

En desuso. 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

Crea 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 identificador 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 va a evaluar en una solicitud.
  • actions: Un 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 restringidas 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: Un 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

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

-j, --json-file

En desuso. 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 identificador 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 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 reglas de página 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 identificador 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 correspondiente a la solicitud 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. 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. El valor predeterminado es off.

--edge-connectivity

Las versiones de IP compatibles para las 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 solicitud 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 correspondiente a la solicitud de rango.
    • name: El nombre del registro DNS correspondiente a la solicitud 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 con respecto al origen.
  • origin_dns: Método y parámetros que se utilizan para averiguar 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 punto de origen.
  • proxy_protocol: Habilita el protocolo de proxy hacia el servidor de 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 la dirección IP de borde de anycast para el nombre de host de esta aplicación.
    • type: El tipo de configuración de IP de borde 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 las 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 tu origen. Cuando se configura en « direct », «range» envía el tráfico directamente a tu origen, y el tipo de aplicación se deduce a partir del protocolo. Cuando se configura en « http » o « https », el rango aplica las funciones de CIS ( HTTP / HTTPS ), ya que envía el tráfico a tu 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.

Datos JSON de ejemplo:

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

-s, --json-str

En desuso. Los datos JSON que describen una aplicación Range.

-j, --json-file

En desuso. 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 aplicación de rango para el dominio DNS_DOMAIN_ID.

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

Opciones de comando

DNS_DOMAIN_ID

El ID del dominio DNS. Obligatorio.

APP_ID

El identificador de la solicitud de rango. Obligatorio.

--name

El nombre del registro DNS correspondiente a la solicitud de rango.

--add-origin-direct

Añade nuevas direcciones de destino al origen.

--remove-origin-direct

Elimine las direcciones de destino del origen.

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

--proxy-protocol

Activa el protocolo de proxy hacia el servidor de 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. El valor predeterminado es off.

--edge-connectivity

Las versiones de IP compatibles para las 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 solicitud 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 correspondiente a la solicitud de rango.
    • name: El nombre del registro DNS correspondiente a la solicitud 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 con respecto al origen.
  • origin_dns: Método y parámetros que se utilizan para averiguar 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 punto de origen.
  • proxy_protocol: Habilitar el protocolo de proxy hacia el servidor de 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 la dirección IP de borde de anycast para el nombre de host de esta aplicación.
    • type: El tipo de configuración de IP de borde 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 soportadas para conexiones de entrada en direcciones IP de cualquier rango. Los valores válidos son all, ipv4 y 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 tu origen. Cuando se configura en « direct », «range» envía el tráfico directamente a tu origen, y el tipo de aplicación se deduce a partir del protocolo. Cuando se configura en « http » o « https », el rango aplica las funciones de CIS ( HTTP / HTTPS ), ya que envía el tráfico a tu 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.