Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie um aplicativo de acesso para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste todos os aplicativos de acesso para domínios 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-apps DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Mostre detalhes do aplicativo de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

--name

O nome do aplicativo. Obrigatório.

--domain

O domínio e o caminho bloqueados pelo Access. Obrigatório.

--session-duration

Define o período de validade dos tokens emitidos para este aplicativo. Os valores válidos são 30m, 6h, 12h, 24h, 168h e 730h.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize o aplicativo de acesso a5836c2a7ea72d2e225890caea70ae32.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Exclua o aplicativo de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--name

O nome do Certificado. Obrigatório.

--ca-cert-file

O arquivo raiz da autoridade de certificação raiz para seus certificados. Obrigatório.

--associated-hostnames

Os nomes de host solicitados para este certificado.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Crie um certificado de acesso para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste todos os certificados de acesso para o domínio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_CERTIFICATE_ID

A ID do certificado de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Mostre detalhes do certificado de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_CERTIFICATE_ID

A ID do certificado de acesso. Obrigatório.

--name

O nome do Certificado. Obrigatório.

--associated-hostnames

Os nomes de host solicitados para este certificado. Obrigatório.

Os nomes de host associados são reconfigurados se não especificados por associated-hostnames.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize o certificado de acesso a5836c2a7ea72d2e225890caea70ae32.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_CERTIFICATE_ID

A ID do certificado de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Exclua o certificado de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha as configurações de certificados de acesso para o domínio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-f, --feature

Recurso de configurações de certificados. Valores válidos:

client_certificate_forwarding

A carga útil do certificado do cliente e sua assinatura de SHA256 e são encaminhadas aos servidores de origem por meio dos cabeçalhos CF-Client-Cert-DER_BASE64 e CF-Client-Cert-SHA256.

-v, --value

O valor configurado para o recurso para certificados.

client_certificate_forwarding

Especifique o nome do host para determinar se o certificado do cliente deve ou não ser encaminhado. Por exemplo, -v host1=on,host2=on,host3=off.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize as configurações de certificados de acesso para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

--name

O nome da política. Obrigatório.

--decision

Define a ação que o Access executa caso a política corresponda ao usuário. O valor válido é non_identity. Obrigatório.

--include

A regra incluída da política. Os valores válidos são certificate e common_name. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie uma política de acesso para o aplicativo a5836c2a7ea72d2e225890caea70ae32.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste todas as políticas de acesso para o aplicativo de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

ACCESS_POLICY_ID

O ID da política de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Mostre detalhes da política de acesso a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

ACCESS_APPLICATION_ID

O ID do aplicativo de acesso. Obrigatório.

ACCESS_POLICY_ID

O ID da política de acesso. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Exclua a política de acesso 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--all

Removendo todos os arquivos armazenados em cache. Essa opção é mutuamente exclusiva com --file.

--file

De forma granular, remova um ou mais arquivos ao especificar as URLs. Essa opção é mutuamente exclusiva com --all.

--tag

De forma granular, remova um ou mais arquivos pelo Cache-Tag associado. Essa opção é mutuamente exclusiva com --all. Apenas planos empresariais

--host

De forma granular, remova um ou mais arquivos ao especificar o host. Essa opção é mutuamente exclusiva com --all. Apenas planos empresariais

--prefix

De forma granular, remova um ou mais arquivos por um prefixo. Essa opção é mutuamente exclusiva com --all. Apenas planos empresariais

-f, --force

Removendo todos os arquivos armazenados em cache sem solicitar confirmação.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Limpe o arquivo de todos os ativos em cache para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha configurações de armazenamento em cache para o domínio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--caching-level

Especifique em quais condições URL você deseja fornecer os recursos armazenados em cache ao usuário. Os valores válidos são no-query-string, query-string-independent e query-string-dependent.

• no-query-string cache: fornece recursos do cache somente quando nenhuma string de consulta está presente.
• query-string-independent: Fornece o mesmo recurso a todos, independentemente da string de consulta.
• query-string-dependent: Retorna um recurso diferente sempre que a string de consulta é alterada.

--browser-expiration

Especifique por quanto tempo você deseja que o navegador armazene os recursos em cache.

• Os valores válidos são respect-existing-header, 30s, 1M, 5M, 20M, 30M, 1h, 2h, 4h, 8h, 16h, 1d 3d, 8d, 16d, 1m, 6m e 1y.
• 30s, 1M, 5M e 20M estão disponíveis apenas para instâncias dos planos Enterprise ou 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

Ignorar todos os edge caches e enviar o tráfego para seus servidores de origem.

--serve-stale-content

Continuar a fornecer conteúdo armazenado em cache aos usuários quando os servidores de origem estiverem offline, mesmo que o conteúdo tenha expirado.

--query-string-sort: No cache, CIS considera os arquivos com as mesmas sequências de consulta como o mesmo arquivo, independentemente da ordem dessas sequências.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize as configurações de armazenamento em cache para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplo

ibmcloud cis custom-lists lists

Opções de comando

LIST_ID

O ID da lista personalizada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplo

ibmcloud cis custom-lists list LIST_ID --output json

Opções de comando

--kind

Tipo de lista personalizada. Os valores válidos são ip, asn e hostname.

--name

O nome da lista.

--description

Descrição da lista.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma lista personalizada.

Os campos obrigatórios nos dados JSON são:

kind tipo de lista personalizada. Os valores válidos são ip, asn e hostname.

name nome da lista: O nome da lista.

O campo opcional é:

"description": Descrição da lista.

Dados JSON de amostra:

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

Exemplos

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

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

Opções de comando

LIST_ID

O ID da lista personalizada.

--description

Descreva brevemente a lista.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

json

O arquivo JSON ou a string JSON utilizada para descrever uma lista personalizada.

O campo opcional é:

"description": Para descrever brevemente a lista.

Dados JSON de amostra:

  {
    "description": "string"
  }

Exemplos

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

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

Opções de comando

LIST_ID

O ID da lista personalizada.

-f, --force

Tentar excluir uma lista personalizada sem solicitar confirmação.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

Exemplo

ibmcloud cis custom-lists list-delete LIST_ID

Opções de comando

LIST_ID

O ID da lista personalizada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplo

ibmcloud cis custom-lists items LIST_ID

Opções de comando

LIST_ID

O ID da lista personalizada.

ITEM_ID

O ID do item da lista personalizada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplo

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Opções de comando

LIST_ID

O ID da lista personalizada.

--asn

O valor ASN.

--ip

O endereço do site IPv4.

--hostname

O nome do host.

--comment

Fazer um breve comentário sobre o item.

-i, --instance

O ID ou o nome da instância. Se a instância ou ID não for definida, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma lista personalizada.

Os campos obrigatórios nos dados JSON são:

items lista de itens de lista personalizados a serem criados.

asn: O ASN.

hostname: O nome do host.

ip o endereço IPv4.

comment comentário breve sobre o item.

Dados JSON de amostra:

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

Exemplos de comando

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

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

Opções de comando

LIST_ID

O ID da lista personalizada.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma lista personalizada.

Os campos obrigatórios nos dados JSON são:

items lista de itens de lista personalizados a serem criados.

asn valor ASN: O valor ASN.

hostname: O nome do host.

ip o endereço IPv4.

comment comentário breve sobre o item.

Dados JSON de amostra:

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

-f, --force

Tentar excluir uma lista personalizada sem solicitar confirmação.

--output value

O formato de saída. Atualmente, json é o único valor compatível.

-i, --instance

O ID ou o nome da instância. Se o valor ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

Exemplo

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

Opções de comando

LIST_ID

O ID da lista personalizada.

--item-id

CUSTOM_LIST_ITEM_ID é o ID do item da lista personalizada.

-f, --force

Tentar excluir uma lista personalizada sem solicitar confirmação.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma lista personalizada.

Os campos obrigatórios nos dados JSON são:

items lista de itens da lista personalizada a serem excluídos por ID.

id iD exclusivo do item de lista personalizado.

Dados JSON de amostra:

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

Exemplos

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

Opções de comando

OPERATION_ID

A ID da operação de lista personalizada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplo

ibmcloud cis custom-lists operation OPERATION_ID --output json

Opções de comando

PAGE_ID

O nome do tipo da página customizada. Os valores válidos são: basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Obrigatório.

PAGE_URL

Uma URL associada à página customizada. Por exemplo, http://www.example.com/example.html. O valor default significa usar a página padrão. Obrigatório.

-d, --domain

ID do Domínio DNS.

-i,- --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize a página basic_challenge para o domínio 31984fea73a15b45779fa0df4ef62f9b.

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

Opções de comando

PAGE_ID

O nome do tipo da página customizada. Os valores válidos são basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors e 500_errors. Obrigatório.

-d, --domain

ID do Domínio DNS.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha a página basic_challenge para o domínio 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Opções de comando

-d, --domain

ID do Domínio DNS.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar as páginas personalizadas existentes para o domínio DNS_DOMAIN_ID.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--name

Nome do registro DNS.

--type

Tipo de registro DNS.

--content

Conteúdo do registro DNS.

--ttl

Tempo de vida do registro DNS. Um valor igual a 1 significa “ automatic ”. O valor padrão é 1.

--proxied

Controlar se o tráfego flui através das funções de segurança e de desempenho no CIS. CIS O proxy redireciona o tráfego apenas para os registros A, AAAA e CNAME. Os valores válidos são true e false.

--json

O arquivo JSON ou a string JSON utilizada para descrever um registro DNS. Os tipos de Registro DNS suportados são: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Para os tipos A, AAAA, CNAME, NS, TXT:
  • Os campos obrigatórios em dados JSON são name, type, content.
  • Os campos opcionais são ttl e proxied:
    • proxied Controlar se o tráfego flui através das funções de segurança e de desempenho no CIS. CIS Os proxies redirecionam apenas o tráfego dos registros A, AAAA e CNAME.

Dados JSON de amostra:

{
   "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 o tipo “ PTR ”:
  • Os campos obrigatórios em dados JSON são name, type, content.
  • O campo opcional é ttl.

Dados JSON de amostra:

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

• Para o tipo “ MX ”:
  • Os campos obrigatórios em dados JSON são name, type, content.
  • Os campos opcionais são ttl e priority.

Dados JSON de amostra:

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

• Para o tipo “ LOC ”:
  • Os campos obrigatórios nos dados JSON são name, type, data:
    • data:
      • lat_degrees: Graus de latitude.
      • lat_minutes: Minutos de latitude
      • lat_seconds: Segundos de latitude.
      • lat_direction: Direção da latitude.
      • long_degrees: Graus de longitude.
      • long_minutes: Minutos de longitude.
      • long_seconds: Segundos de longitude.
      • long_direction: Direção da longitude.
      • altitude: Altitude do local em metros.
      • size: Dimensão do local em metros.
      • precision_horz: Precisão horizontal da localização.
      • precision_vert: Precisão vertical da localização.
    • O campo opcional é ttl.

Dados JSON de amostra:

{
   "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 o tipo “ SRV ”:
  • Os campos obrigatórios nos dados JSON são type, data:
    • data: - service: Um tipo de serviço, precedido por um sublinhado. - proto: Um protocolo válido. - priority: Prioridade. - weight: O peso recorde. - port: A porta do serviço. - target: Um nome de host válido.
    • O campo opcional é ttl.

Dados JSON de amostra:

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

• Para tipo CAA:
  • Os campos obrigatórios nos dados JSON são name, type e data.
  • O campo opcional é ttl.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um Registro DNS.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie um registro DNS no domínio 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"

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

DNS_RECORD_ID

O ID do registro DNS. Obrigatório.

--name

Nome do registro DNS.

--type

Tipo de registro DNS.

--content

Conteúdo do registro DNS.

--ttl

Tempo de vida do registro DNS. Um valor igual a 1 significa “ automatic ”. O valor padrão é 1.

--proxied

Controlar se o tráfego flui através das funções de segurança e de desempenho no CIS. CIS O proxy redireciona o tráfego apenas para os registros A, AAAA e CNAME. Os valores válidos são true e false.

--json

O arquivo JSON ou a string JSON utilizada para descrever um registro DNS. Os tipos de Registro DNS suportados são: A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA, PTR.

• Para os tipos A, AAAA, CNAME, NS, TXT:
  • Os campos obrigatórios em dados JSON são name, type, content.
  • Os campos opcionais são ttl e proxied:
    • proxied Controlar se o tráfego flui através das funções de segurança e de desempenho no CIS. CIS Os proxies encaminham apenas o tráfego dos registros A, AAAA e CNAME.

Dados JSON de amostra:

{
   "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 o tipo “ PTR ”:
  • Os campos obrigatórios em dados JSON são name, type, content.
  • O campo opcional é ttl.

Dados JSON de amostra:

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

• Para o tipo “ MX ”:

  • Os campos obrigatórios em dados JSON são name, type, content.
  • Os campos opcionais são ttl e priority.

  Dados JSON de amostra:

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

• Para o tipo “ LOC ”:

  • Os campos obrigatórios nos dados JSON são name, type, data:
    • data:
      • lat_degrees: Graus de latitude.
      • lat_minutes: Minutos de latitude
      • lat_seconds: Segundos de latitude.
      • lat_direction: Direção da latitude.
      • long_degrees: Graus de longitude.
      • long_minutes: Minutos de longitude.
      • long_seconds: Segundos de longitude.
      • long_direction: Direção da longitude.
      • altitude: Altitude do local em metros.
      • size: Dimensão do local em metros.
      • precision_horz: Precisão horizontal da localização.
      • precision_vert: Precisão vertical da localização.
  • O campo opcional é ttl.

  Dados JSON de amostra:

{
   "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 o tipo “ SRV ”:

  • Os campos obrigatórios nos dados JSON são type, data:
    • data:
      • service: Um tipo de serviço, precedido por um sublinhado.
      • proto: Um protocolo válido.
      • priority: Prioridade.
      • weight: O peso recorde.
      • port: A porta do serviço.
      • target: Um nome de host válido.
  • O campo opcional é ttl.

  Dados JSON de amostra:

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

• Para o tipo “ CAA ”:

  • Os campos obrigatórios nos dados JSON são name, type, data
  • O campo opcional é ttl.

  Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um Registro DNS.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize um registro DNS no domínio 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"

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

DNS_RECORD_ID

O ID do registro DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha detalhes do registro DNS no domínio DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

DNS_RECORD_ID

O ID do registro DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir um registro DNS no domínio DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--type

Tipo de registros DNS a serem exibidos.

--name

O valor para filtragem do campo de nome.

--content

O valor para filtragem do campo de conteúdo.

--page

O número da página dos resultados paginados.

--per_page

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

--order

Campo pelo qual a lista de registros DNS deve ser ordenada. Os valores válidos são type, name, content, ttl e proxied.

--direction

Ordem em que os resultados devem ser exibidos (ordem crescente ou decrescente). Os valores válidos são asc e desc.

--match

Se deve corresponder a todos ou a pelo menos um dos parâmetros de pesquisa. Os valores válidos são any e all.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste todos os registros DNS do domínio DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--file

Configuração BIND para importar. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Importar a configuração do BIND no domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--file

O arquivo de configuração do BIND que armazena os registros DNS exportados.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Exportar a configuração do BIND para o domínio DNS_DOMAIN_ID.

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

Opções de comando

type

Especifique a configuração do tipo de domínio. Os valores válidos são full e partial (padrão: full).

• full: Uma zona completa significa que o DNS está hospedado.
• partial: Uma zona parcial implica um domínio configurado com CNAME.

jump-start

Tentar buscar automaticamente registros DNS existentes.

DNS_DOMAIN_NAME

O FQDN do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Adicione um domínio DNS_DOMAIN_NAME.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Retome o domínio especificado.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Pause o domínio especificado.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Exiba os detalhes de domínio especificados.

ibmcloud cis domain DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Remova o domínio especificado.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Lista de domínios para a instância de serviço.

ibmcloud cis domains

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Execute a verificação de ativação no domínio especificado.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-g, --group

Exibir recursos em um mesmo grupo. Os valores válidos para group são all, ` `domain, reliability, ` `performance e security``. Essa opção é mutuamente exclusiva com -f, --feature.

-f, --feature

Recurso de configurações de domínio a ser verificado. Essa opção é mutuamente exclusiva com g, --group. Os valores válidos são os seguintes:

• always_use_https: Redirecione todas as solicitações com o esquema http para https. Essa configuração se aplica a todas as solicitações do tipo “ HTTP ” enviadas ao domínio.
• automatic_https_rewrites: Ajude a corrigir o conteúdo misto alterando http para https em todos os recursos ou links do seu site que possam ser acessados por meio de HTTPS.
• bot_management: Detecte e reduza o tráfego de bots no seu domínio.
• brotli: Quando o cliente que está solicitando um recurso é compatível com o algoritmo de compressão Brotli, o CIS fornece uma versão desse recurso comprimida com o Brotli.
• browser_check: Avalie os cabeçalhos “ HTTP ” do navegador dos visitantes para detectar ameaças. Se uma ameaça for encontrada, uma página de bloqueio será exibida.
• challenge_ttl: Especifique por quanto tempo um visitante com má reputação de IP terá acesso ao seu site após concluir um desafio.
• ciphers: Uma lista de algoritmos de criptografia permitidos para a terminação “ TLS ”, no formato BoringSSL. Esse comando lista as cifras que estão na lista de permissões dos clientes. Se nenhuma cifra estiver na lista de permitidas, a lista ficará vazia e serão utilizadas as cifras padrão. Consulte Suítes de cifras de borda e Suítes de cifras de origem para obter a lista de cifras padrão.
• cname_flattening: Siga um CNAME até o destino para o qual ele aponta e retorne esse endereço IP em vez do registro CNAME. Por padrão, simplifique apenas o CNAME na raiz do seu domínio.
• domain_hold: As restrições de domínio impedem que as equipes da sua organização adicionem domínios que já estejam ativos em outra conta. Apenas planos empresariais
• email_obfuscation criptografia: criptografa os endereços de e-mail em sua página da Web contra bots, mas os mantém visíveis para humanos.
• opportunistic_onion: Permita que usuários legítimos do Tor Browser acessem seus sites.
• hotlink_protection: Proteja suas imagens contra links externos.
• http2: Acelere seu site com HTTP/2.
• http3: Acelere seu site com HTTP/3.
• image_load_optimization: Depreciado. melhore o tempo de carregamento para páginas que incluem imagens em dispositivos móveis com conexões de rede lentas.
• image_size_optimization: Melhore o tempo de carregamento das imagens otimizando as imagens hospedadas no seu domínio.
• image_resizing redimensionamento, conversão e otimização sob demanda de imagens fornecidas pela rede CIS.
• ip_geolocation: Inclua o código do país de origem do visitante em todas as solicitações enviadas ao seu site.
• ipv6: Ativar o suporte ao IPv6 e o gateway.
• max_upload: O número de visitantes que podem enviar dados para o seu site em uma única solicitação.
• min_tls_version: Permitir apenas conexões HTTPS de visitantes que suportem a versão selecionada do protocolo TLS ou uma versão mais recente.
• minify: Reduza o tamanho dos arquivos de código-fonte no seu site.
• mobile_redirect: Redirecione os visitantes que estiverem usando dispositivos móveis para um site otimizado para dispositivos móveis.
• opportunistic_encryption: A Criptografia Oportunista permite que os navegadores se beneficiem do melhor desempenho do protocolo HTTP/2, informando-os de que seu site está disponível por meio de uma conexão criptografada.
• origin_error_page_pass_thru: Quando a página de erro de origem está configurada como On, o CIS redireciona as páginas de erro 502 e 504 diretamente da origem. Apenas planos empresariais
• origin_max_http_version: Configure a versão do HTTP para “Origin”.
• origin_post_quantum_encryption: Instrui o CIS a utilizar algoritmos de acordo de chave pós-quânticos (PQ) ao se conectar ao seu servidor de origem.
• prefetch_preload: CIS pré-carrega quaisquer URLs incluídos no cabeçalho HTTP de pré-carregamento. Apenas planos empresariais
• pseudo_ipv4: Adiciona um cabeçalho IPv4 às solicitações quando um cliente está usando IPv6, mas o servidor suporta apenas IPv4.
• response_buffering: Ativar ou desativar o armazenamento em buffer das respostas do servidor de origem. Apenas planos empresariais
• script_load_optimization: Melhorar o tempo de renderização das páginas que incluem JavaScript.
• security_header: Implemente uma política de segurança para o seu site.
• security_level: Escolha o perfil de segurança adequado para o seu site.
• server_side_exclude: Ocultar automaticamente determinados conteúdos de visitantes suspeitos.
• tls_client_auth: Certificado de cliente TLS apresentado para autenticação na solicitação de pull da origem. Apenas planos empresariais
• true_client_ip_header: O comando “ CIS ” envia o endereço IP do usuário no cabeçalho “True-Client-IP”. Apenas planos empresariais
• waf: Um Web Application Firewall (WAF) bloqueia solicitações que contenham conteúdo malicioso.
• websockets: Permitir conexões WebSockets com seu servidor de origem.
• proxy_read_timeout: Tempo máximo entre duas operações de leitura a partir da origem. Apenas planos empresariais
• url_normalization: Modificar as URLs das solicitações recebidas.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha as configurações d ciphers para o domínio DNS_DOMAIN_ID.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-f, --feature

Recursos das configurações de domínio a serem atualizados. Obrigatório. Valores válidos:

• always_use_https: Redirecione todas as solicitações com o esquema http para https. Esse redirecionamento se aplica a todas as solicitações HTTP feitas ao domínio.
• automatic_https_rewrites: Ajude a corrigir o conteúdo misto alterando http para https em todos os recursos ou links do seu site que possam ser acessados por meio de HTTPS.
• bot_management: Detecte e reduza o tráfego de bots no seu domínio.
• brotli: Quando o cliente que está solicitando um recurso é compatível com o algoritmo de compressão Brotli, o CIS fornece uma versão desse recurso comprimida com o Brotli.
• browser_check: Avalie os cabeçalhos “ HTTP ” do navegador dos visitantes para detectar ameaças. Se uma ameaça for encontrada, uma página de bloqueio será exibida.
• challenge_ttl: Especifique por quanto tempo um visitante com má reputação de IP terá acesso ao seu site após concluir um desafio.
• ciphers lista de permissões de cifras para a terminação TLS. Essas cifras devem estar no formato BoringSSL.
• cname_flattening: Siga um CNAME até o destino para o qual ele aponta e retorne esse endereço IP em vez do registro CNAME. Por padrão, somente comprimir o CNAME na raiz do seu domínio.
• domain_hold: As restrições de domínio impedem que as equipes da sua organização adicionem domínios que já estejam ativos em outra conta. Apenas planos empresariais
• email_obfuscation criptografia: criptografa os endereços de e-mail em sua página da Web contra bots, mas os mantém visíveis para humanos.
• opportunistic_onion: Permita que usuários legítimos do Tor Browser acessem seus sites.
• hotlink_protection: Proteja suas imagens contra links externos.
• http2: Acelere seu site com HTTP/2.
• http3: Acelere seu site com HTTP/3.
• image_load_optimization: Depreciado. melhore o tempo de carregamento para páginas que incluem imagens em dispositivos móveis com conexões de rede lentas.
• image_size_optimization: Melhore o tempo de carregamento das imagens otimizando as imagens hospedadas no seu domínio.
• image_resizing redimensionamento, conversão e otimização sob demanda de imagens fornecidas pela rede CIS.
• ip_geolocation: Inclua o código do país de origem do visitante em todas as solicitações enviadas ao seu site.
• ipv6: Ativar o suporte ao IPv6 e o gateway.
• max_upload: O número de visitantes que podem enviar dados para o seu site em uma única solicitação.
• min_tls_version: Permitir apenas conexões HTTPS de visitantes que suportem a versão selecionada do protocolo TLS ou uma versão mais recente.
• minify: Reduza o tamanho dos arquivos de código-fonte no seu site.
• mobile_redirect: Redirecione os visitantes que estiverem usando dispositivos móveis para um site otimizado para dispositivos móveis.
• opportunistic_encryption: A Criptografia Oportunista permite que os navegadores se beneficiem do melhor desempenho do protocolo HTTP/2, informando-os de que seu site está disponível por meio de uma conexão criptografada.
• origin_error_page_pass_thru: Quando a “Página de erro de origem” está configurada como On, o CIS redireciona as páginas de erro 502 e 504 diretamente da origem. Apenas planos empresariais
• origin_max_http_version: Configure a versão do HTTP para “Origin”.
• origin_post_quantum_encryption: Instrui o CIS a utilizar algoritmos de acordo de chave pós-quânticos (PQ) ao se conectar ao seu servidor de origem.
• prefetch_preload: CIS pré-carrega quaisquer URLs incluídos no cabeçalho HTTP de pré-carregamento. Apenas planos empresariais
• pseudo_ipv4: Adiciona um cabeçalho IPv4 às solicitações quando um cliente está usando IPv6, mas o servidor suporta apenas IPv4.
• response_buffering: Ativar ou desativar o armazenamento em buffer das respostas do servidor de origem. Apenas planos empresariais
• script_load_optimization: Melhorar o tempo de renderização das páginas que incluem JavaScript.
• security_header: Implemente uma política de segurança para o seu site.
• security_level: Escolha o perfil de segurança adequado para o seu site.
• server_side_exclude: Ocultar automaticamente determinados conteúdos de visitantes suspeitos.
• tls_client_auth: Certificado de cliente TLS apresentado para autenticação na solicitação de pull da origem. Apenas planos empresariais
• true_client_ip_header: O comando “ CIS ” envia o endereço IP do usuário no cabeçalho “True-Client-IP”. Apenas planos empresariais
• waf: Um Web Application Firewall (WAF) bloqueia solicitações que contenham conteúdo malicioso.
• websockets: Permitir conexões WebSockets com seu servidor de origem.
• proxy_read_timeout: Tempo máximo entre duas operações de leitura a partir da origem.
• url_normalization: Modificar as URLs das solicitações recebidas.

-v, --value

O valor configurado para o recurso para o domínio. Obrigatório.

• Os valores válidos para always_use_https são on e off``.

• Os valores válidos para automatic_https_rewrites são on e off``.

• Os valores válidos para bot_management são "use_latest_model", "fight_mode", "session_score", "enable_js". Por exemplo, -v fight_mode=true,session_score=true

  • use_latest_model se deve ativar a versão mais recente do modelo. Os valores válidos para use_latest_model são true e false``.
  • fight_mode se deve ativar o modo de combate. Os valores válidos para fight_mode são true e false``.
  • session_score se deve ativar a pontuação da sessão. Os valores válidos para session_score são true e false``.
  • enable_js se deve ativar as detecções de JavaScript. Os valores válidos para enable_js são true e false``.

• Os valores válidos para browser_check são on e off``.

• Os valores válidos para challenge_ttl são 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• Os valores válidos para cname_flattening são flatten_at_root, flatten_all.

  • flatten_at_root: Simplificar o CNAME no domínio raiz. Este valor é o valor padrão.
  • flatten_all: Simplifique todos os registros CNAME do seu domínio.

• Os valores válidos para domain_hold são hold, include_subdomains e hold_after.

  • hold se deve habilitar a retenção de domínio. Os valores válidos para hold são true e false``.
  • include_subdomains: Se deve habilitar a retenção de domínio. Os valores válidos para include_subdomains são true e false``.
  • hold_after: Se for fornecido um hold_after, a retenção é temporariamente desativada e, em seguida, reativada automaticamente pelo sistema no horário especificado.

  Para ativar o domínio e os subdomínios, acesse: -v hold=true,include_subdomains=true. Para desativar a retenção de domínio: -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• Os valores válidos para hotlink_protection são on, off.

• Os valores válidos para email_obfuscation são on, off.

• Os valores válidos para opportunistic_onion são on, off.

• Os valores válidos para http2 são on, off.

• Os valores válidos para http3 são on, off.

• Obsoleto. Os valores válidos para image_load_optimization são on, off.

• Os valores válidos para image_resizing são on, off.

• Os valores válidos para image_size_optimization estão off, lossless, lossy.

  • off: desative a Otimização de tamanho da imagem.
  • lossless: Reduza o tamanho dos arquivos de imagem sem comprometer a qualidade visual.
  • lossy: O tamanho dos arquivos de imagens JPEG é reduzido por meio da compressão com perda, o que pode diminuir a qualidade visual.

• Os valores válidos para ip_geolocation são on, off.

• Os valores válidos para ipv6 são on, off.

• Os valores válidos (em MB) para max_upload são: 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Apenas planos empresariais

• Os valores válidos para min_tls_version são 1.0, 1.1, 1.2, 1,3.

• Os valores válidos para minify são css, html, js. Por exemplo, -v css=on,html=off,js=on

  • css: Minifique automaticamente todo o CSS do seu site. Os valores válidos para css são on, off.
  • html: Minifique automaticamente todo o código HTML do seu site. Os valores válidos para html são on, off.
  • js: Minifique automaticamente todos os arquivos JS do seu site. Os valores válidos para js são on, off.

• Os valores válidos para mobile_redirect são status, mobile_subdomain, strip_uri. Por exemplo, -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Se o redirecionamento para dispositivos móveis está ativado. Os valores válidos para status são on e off``.
  • mobile_subdomain: Para qual prefixo de subdomínio você deseja redirecionar os visitantes em dispositivos móveis (o subdomínio deve existir).
  • strip_uri: Se deve descartar o caminho da página atual e redirecionar para a raiz do subdomínio móvel URL. Os valores válidos para strip_uri são true, false.

• Os valores válidos para opportunistic_encryption são on, off.

• Os valores válidos para origin_error_page_pass_thru são 1, 2.

• Os valores válidos para origin_max_http_version estão supported, preferred, off.

  • supported: Os algoritmos pós-quânticos são divulgados, mas só são utilizados quando solicitado pelo remetente.
  • preferred: A opção “Preferred” instrui o servidor de autenticação ( CIS ) a enviar, quando for oportuno, um compartilhamento de chaves pós-quântico (PQ) na primeira mensagem enviada à origem (para conexões mais rápidas, quando a origem suportar e preferir PQ).
  • off: Os algoritmos pós-quânticos não são divulgados.

• Os valores válidos para origin_post_quantum_encryption são on, off.

• Os valores válidos para brotli são on, off.

• Os valores válidos para prefetch_preload são on, off.

• Os valores válidos para pseudo_ipv4 estão off, add_header, overwrite_header.

  • off: desative o Pseudo IPv4.
  • add_header: Adicione apenas mais um cabeçalho Cf-Pseudo-IPv4.
  • overwrite_header: sobrescrever os cabeçalhos existentes Cf-Connecting-IP e X-Forwarded-For por um endereço pseudo IPv4.

• Os valores válidos para response_buffering são on, off.

• Os valores válidos para script_load_optimization são on, off.

• Os valores válidos para security_header são enabled, max_age, include_subdomains, preload, nosniff. Por exemplo, -v enabled=true,max_age=100,include_subdomains=true,preload=true,nosniff=true

  • enabled se o security_header está ativado. Os valores válidos para enabled são true, false.
  • max_age: Especifique o tempo (em segundos) durante o qual os cabeçalhos de segurança ficam armazenados em cache nos navegadores.
  • include_subdomains: Todos os domínios subordinados a esse domínio herdam o mesmo security_header. Os valores válidos para include_subdomains são true, false.
  • preload: Se deve ser permitido que os navegadores carreguem previamente a configuração security_header. Os valores válidos para enabled são true, false.
  • nosniff : Se deve ser enviado o cabeçalho X-Content-Type-Options: nosniff . Os valores válidos para nosniff são true, false.

• Os valores válidos para server_level são off, essentially_off, low, medium, high, under_attack.

• Os valores válidos para server_side_exclude são on, off.

• Os valores válidos para tls_client_auth são on, off.

• Os valores válidos para true_client_ip_header são on, off.

• Os valores válidos para waf são on, off.

• Os valores válidos para websockets são on, off.

• Os valores válidos para proxy_read_timeout, 1-6000, padrão: 100.

• Os valores válidos para ciphers são 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 exemplo, -v AES256-SHA256,AES256-SHA, usando -v default para redefinir as suítes de cifras configuradas para o valor padrão.

• Os valores válidos para url_normalization são "type", "scope". Por exemplo, -v type=cis,scope=both

  • type: Seleciona o tipo de normalização “ URL ” realizada pelo CIS. Os valores válidos para type são cis, rfc3986.
  • scope: Configura o escopo da normalização do URL. Os valores válidos para scope são both, incoming.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Ativar o recurso “ tls_client_auth ” para o domínio DNS_DOMAIN_ID.

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

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar todas as ações das Funções de Borda.

ibmcloud cis edge-functions-actions

Opções de comando

--name

Nome da Ação. Apenas planos empresariais

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Mostrar detalhes da ação “Edge Functions” ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Opções de comando

--name

Nome da Ação. Apenas planos empresariais

--javascript-str

Sequência Javascript. Por exemplo,addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Arquivo Javascript.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie uma ação do Edge Functions.

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

Opções de comando

--name

Nome da Ação. Apenas planos empresariais

--javascript-str

Sequência Javascript. Por exemplo,addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Arquivo Javascript.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualizar uma ação do Edge Functions.

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

Opções de comando

--name

Nome da Ação. Apenas planos empresariais

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Ação “Excluir funções de borda” ACTION_NAME.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar todos os gatilhos das Funções de Borda para o domínio DNS_DOMAIN_ID.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

TRIGGER_ID

O ID do gatilho. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Mostrar detalhes do gatilho das Funções de Borda TRIGGER_ID.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

PATTERN_URL

A solicitação URL, que aciona a ação. Obrigatório.

name

O nome da ação à qual o gatilho criado está vinculado. Apenas planos empresariais

disable

Desativar um acionador do Edge Functions.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie um gatilho do Edge Functions para o domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

TRIGGER_ID

O ID do gatilho. Obrigatório.

PATTERN_URL

A solicitação URL, que aciona a ação. Obrigatório.

name

O nome da ação à qual o gatilho criado está vinculado. Apenas planos empresariais

disable

Desativar um acionador do Edge Functions.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualização: As funções de borda acionam TRIGGER_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

TRIGGER_ID

O ID do gatilho. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o gatilho “ TRIGGER_ID ” das funções de borda.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Opções de comando

-t, --type

Tipo de regras de firewall a serem criadas. Valores válidos: access-rules, ua-rules, lockdowns. Obrigatório.

• access-rules: regras de acesso são uma maneira de permitir, desafiar ou bloquear solicitações para o seu website. É possível aplicar as regras de acesso somente a um domínio ou a todos os domínios na mesma instância de serviço.
• ua-rules: executa controle de acesso ao corresponder ao exato UserAgent relatado pelo cliente. O mecanismo de controle de acesso pode ser definido dentro de uma regra para ajudar a gerenciar o tráfego de clientes determinados. Essa opção permite que você personalize o acesso ao seu site.
• lockdowns: bloquear o acesso às URLs nesse domínio somente para endereços ou variações de endereços permitidos.

-d, --domain

ID do Domínio DNS. Para a regra de tipo ua-rules e lockdowns, é um parâmetro necessário.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma regra de firewall. Obrigatório.

• Para --type access-rules: Os dados JSON que descrevem uma regra de acesso do firewall são os seguintes.
  • Os campos obrigatórios são mode, configuration.
    • mode: O tipo de ação a ser realizada. Os valores válidos são block, challenge, whitelist e js_challenge.
    • configuration: Par meta/valor a ser usado para esta regra.
      • target: A propriedade da solicitação a ser selecionada. Os valores válidos são ip, ip_range, asn e country.
      • value: O valor do alvo selecionado.
        • Para “ip”, o valor é um endereço IP válido.
        • Para ip_range, o valor especifica um intervalo de IPs restrito a /16 e /24.
        • Para o ASN, o valor é um número AS.
        • Para um país, o valor corresponde ao código do país.
  • Os campos de opção são notes.
    • notes: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

Dados JSON de amostra:

{
   "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: Os dados JSON que descrevem uma regra de agente de usuário são os seguintes.
  • Os campos obrigatórios são mode, configuration.
    • mode: O tipo de ação a ser realizada. Os valores válidos são block, challenge e js_challenge.
    • configuration: Par meta/valor a ser usado para esta regra.
      • target: A propriedade da solicitação a ser selecionada. O valor válido é ua.
      • value: A sequência exata de caracteres UserAgent a ser comparada com esta regra.
  • Os campos de opção são paused, description.
    • paused: Se essa regra está desativada no momento.
    • description: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

Dados JSON de amostra:

{
   "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: Os dados JSON que descrevem uma regra de bloqueio são os seguintes.
  • Os campos obrigatórios são urls, configurations.
    • urls: URLs a serem incluídas nesta definição de regra.
      • Curingas são permitidos.
      • O padrão de URL inserido aqui é escapado antes do uso.
      • Este campo limita o URL a padrões simples com caracteres curinga.
    • configurations: Lista de endereços IP ou intervalos CIDR a serem usados nesta regra.
      • Este campo pode incluir qualquer número de configurações de endereços IP ou intervalos de IPs que possam acessar as URLs fornecidas.
      • target: A propriedade da solicitação a ser selecionada. Os valores válidos são ip e ip_range.
      • value: Endereços IP ou CIDR. Se o destino for ip, o valor deve ser um endereço IP; caso contrário, deve ser um CIDR.
  • Os campos de opção são paused, description.
    • paused: Se essa regra está desativada no momento.
    • description: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de firewall.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie regras de firewall.

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

Opções de comando

• FIREWALL_RULE_ID: o ID da regra de firewall. Obrigatório.

-t, --type

O tipo de regra de firewall a ser criada. Os valores válidos são access-rules, ua-rules e lockdowns. Obrigatório.

• access-rules: As regras de acesso são uma forma de permitir, verificar ou bloquear solicitações ao seu site. É possível aplicar as regras de acesso somente a um domínio ou a todos os domínios na mesma instância de serviço.
• ua-rules: Realizar o controle de acesso ao comparar o endereço exato UserAgent informado pelo cliente. O mecanismo de controle de acesso pode ser definido dentro de uma regra para ajudar a gerenciar o tráfego de clientes determinados. Isso permite customizar o acesso ao seu site.
• lockdowns: Limite o acesso às URLs deste domínio apenas aos endereços ou intervalos de endereços permitidos.

-d, --domain

ID do Domínio DNS. Para a regra de tipo ua-rules e lockdowns, é um parâmetro necessário.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma regra de firewall. Obrigatório.

• Para --type access-rules: Os dados JSON que descrevem uma regra de acesso ao firewall são os seguintes.
  • Os campos de opção são mode, notes.
    • mode: O tipo de ação a ser realizada. Os valores válidos são block, challenge, whitelist e js_challenge.
    • notes: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

Dados JSON de amostra:

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

• Para --type ua-rules: Os dados JSON que descrevem uma regra de agente de usuário são os seguintes.

  • Os campos obrigatórios são mode, configuration.
    • mode: O tipo de ação a ser realizada. Os valores válidos são block, challenge e js_challenge.
    • configuration: Par meta/valor a ser usado para esta regra.
      • target: A propriedade da solicitação a ser selecionada. O valor válido é ua.
      • value: A sequência exata de caracteres UserAgent a ser comparada com esta regra.
  • Os campos de opção são paused, description.
    • paused: Se essa regra está desativada no momento.
    • description: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

  Dados JSON de amostra:

{
   "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: Os dados JSON que descrevem uma regra de bloqueio são os seguintes.
  • Os campos obrigatórios são urls, configurations.
    • urls: URLs a serem incluídas nesta definição de regra.
      • Curingas são permitidos.
      • O padrão de URL inserido aqui é escapado antes do uso.
      • Este campo limita o URL a padrões simples com caracteres curinga.
    • configurations: Lista de endereços IP ou intervalos CIDR a serem usados nesta regra.
      • Este campo pode incluir qualquer número de configurações de endereços IP ou intervalos de IPs que possam acessar as URLs fornecidas.
      • target: A propriedade da solicitação a ser selecionada. Os valores válidos são ip e ip_range.
      • value: Endereços IP ou CIDR. Se o destino for ip, o valor deve ser um endereço IP; caso contrário, deve ser um endereço CIDR.
  • Os campos de opção são paused, description.
    • paused: Se essa regra está desativada no momento.
    • description: Algumas informações úteis sobre essa regra para ajudar a identificar seu objetivo.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de firewall.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize regras de firewall.

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

Opções de comando

-t, --type

O tipo de regra de firewall a ser criada. Os valores válidos são access-rules, ua-rules e lockdowns. Obrigatório.

• access-rules: As regras de acesso são uma forma de permitir, verificar ou bloquear solicitações ao seu site. É possível aplicar as regras de acesso somente a um domínio ou a todos os domínios na mesma instância de serviço.
• ua-rules: Realizar o controle de acesso ao comparar o endereço exato UserAgent informado pelo cliente. O mecanismo de controle de acesso pode ser definido dentro de uma regra para ajudar a gerenciar o tráfego de clientes determinados. Essa ação permite que você personalize o acesso ao seu site.
• lockdowns: Limite o acesso às URLs deste domínio apenas aos endereços ou intervalos de endereços permitidos.

-d, --domain

ID do Domínio DNS. Para a regra de tipo ua-rules e lockdowns, é um parâmetro necessário.

--page

O número da página dos resultados paginados. O valor padrão é 0.

--per-page

Número máximo de regras de acesso por página. O valor mínimo é 5. O valor padrão é 20.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste regras de firewall.

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

Opções de comando

FIREWALL_RULE_ID

O ID da regra do firewall. Obrigatório.

-t, --type

Tipo de regra de firewall a ser criada. Os valores válidos são access-rules, ua-rules e lockdowns.

• access-rules: As regras de acesso são uma forma de permitir, verificar ou bloquear solicitações ao seu site. É possível aplicar as regras de acesso somente a um domínio ou a todos os domínios na mesma instância de serviço.
• ua-rules: Realizar o controle de acesso ao comparar o endereço exato UserAgent informado pelo cliente. O mecanismo de controle de acesso pode ser definido dentro de uma regra para ajudar a gerenciar o tráfego de clientes determinados. Isso permite customizar o acesso ao seu site.
• lockdowns: Limite o acesso às URLs deste domínio apenas aos endereços ou intervalos de endereços permitidos.

-d, --domain

ID do Domínio DNS. Para a regra de tipo ua-rules e lockdowns, é um parâmetro necessário.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha detalhes da regra de firewall.

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

Opções de comando

FIREWALL_RULE_ID

O ID da regra do firewall. Obrigatório.

-t, --type

Tipo de regra de firewall a ser criada. Os valores válidos são access-rules, ua-rules e lockdowns. Obrigatório.

• access-rules: As regras de acesso são uma forma de permitir, verificar ou bloquear solicitações ao seu site. É possível aplicar as regras de acesso somente a um domínio ou a todos os domínios na mesma instância de serviço.
• ua-rules: Realizar o controle de acesso ao comparar o endereço exato UserAgent informado pelo cliente. O mecanismo de controle de acesso pode ser definido dentro de uma regra para ajudar a gerenciar o tráfego de clientes determinados. Este campo permite que você personalize o acesso ao seu site.
• lockdowns: Limite o acesso às URLs deste domínio apenas aos endereços ou intervalos de endereços permitidos.

-d, --domain

ID do Domínio DNS. Para a regra de tipo ua-rules e lockdowns, é um parâmetro necessário.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Exclua uma regra de firewall.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--page

O número da página dos resultados paginados. O valor padrão é 1.

--per-page

Número de regras de firewall por página. O valor mínimo é 5 e o valor máximo é 100. O valor padrão é 25.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar as regras de firewall existentes no domínio DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

FIREWALL_RULE_ID

O ID da regra do firewall. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Veja os detalhes da regra de firewall FIREWALL_RULE_ID.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--expression

Uma expressão de filtro. Por exemplo, ip.src eq 93.184.216.0.

--action

A ação de regra a ser executada. Os valores válidos são log, allow, challenge, js_challenge, block e bypass.

--priority

A prioridade da regra. Os valores válidos variam de 0 a 2147483647. O valor “ 0 ” significa definir o valor padrão.

--description

Para descrever brevemente a regra.

--paused

Indica se a regra está ativa ou não. Os valores válidos são on e off. O valor padrão é off.

--products

A lista de produtos de segurança a ser ignorada. Os valores válidos são zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma regra de firewall.

• Os campos obrigatórios nos dados JSON são expression e action.
  • expression: Uma expressão de filtro. Por exemplo, ip.src eq 93.184.216.0
  • action: A ação da regra a ser executada. Os valores válidos são log, allow, challenge, js_challenge, block e bypass.
• Os campos opcionais são description, priority, paused, products.
  • description: Para descrever resumidamente a regra.
  • priority: A prioridade da regra. Os valores válidos variam de 0 a 2147483647. O valor “ 0 ” significa definir o valor padrão.
  • paused: Indica se a regra está ativa ou não. Os valores válidos são on e off. O valor padrão é off.
  • products: A lista de produtos de segurança a serem ignorados. Os valores válidos são zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf. Por exemplo, --products, zoneLockdown, rateLimit

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de firewall.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie uma regra de firewall no domínio 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"}'

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

FIREWALL_RULE_ID

O ID da regra do firewall. Obrigatório.

--expression

Uma expressão de filtro. Por exemplo, ip.src eq 93.184.216.0.

--action

A ação de regra a ser executada. Os valores válidos são log, allow, challenge, js_challenge, block e bypass.

--priority

A prioridade da regra. Os valores válidos variam de 0 a 2147483647. O valor “ 0 ” significa definir o valor padrão.

--description

Para descrever brevemente a regra.

--paused

Indica se a regra está ativa ou não. Os valores válidos são on e off. O valor padrão é off.

--products

A lista de produtos de segurança a ser ignorada. Os valores válidos são zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma regra de firewall.

• Os campos obrigatórios nos dados JSON são expression e e action.
  • expression: Uma expressão de filtro. Por exemplo, ip.src eq 93.184.216.0
  • action: A ação da regra a ser executada. Os valores válidos são log, allow, challenge, js_challenge, block e bypass.
• Os campos opcionais são description, priority, paused, products.
  • description: Para descrever resumidamente a regra.
  • priority: A prioridade da regra. Os valores válidos variam de 0 a 2147483647. O valor “ 0 ” significa definir o valor padrão.
  • paused: Indica se a regra está ativa ou não. Os valores válidos são on e off. O valor padrão é off.
  • products: A lista de produtos de segurança a serem ignorados. Os valores válidos são zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit e waf. Por exemplo, --products, zoneLockdown, rateLimit

Os campos description, priority e paused, que não estão explicitamente definidos nos dados JSON, são substituídos pelo valor padrão.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de firewall.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize a regra do firewall FIREWALL_RULE_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

FIREWALL_RULE_ID

O ID da regra do firewall. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir regra de firewall FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

EXPRESSION

A expressão do filtro. Por exemplo, ip.src eq 93.184.216.0. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Validar a expressão da regra de firewall.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--json

O arquivo JSON ou a string JSON utilizada para descrever um balanceador de carga global. Obrigatório.

• Os campos obrigatórios nos dados JSON são name, fallback_pool e default_pools:
  • name: O nome de host DNS a ser associado ao seu balanceador de carga.
  • fallback_pool: O ID do pool a ser utilizado quando todos os outros pools forem detectados como inoperantes.
  • default_pools: Uma lista de IDs de pool ordenados por sua prioridade de failover.
• Os campos opcionais são description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: A descrição do seu balanceador de carga.
  • ttl: tempo de vida (TTL) da entrada DNS para o endereço IP retornado por este balanceador de carga.
  • region_pools: Uma correspondência entre os códigos de região e de país e uma lista de IDs de pool (ordenados por sua prioridade de failover) para a região.
  • proxied: Defina se o tráfego deve passar pelas funções de segurança e desempenho no CIS.
  • enabled: Se deseja ativar (opção padrão) este balanceador de carga.
  • session_affinity servidor de backend: garante que as solicitações de um usuário sejam direcionadas de forma consistente para o mesmo servidor de backend durante uma sessão. Os valores válidos são cookie e none.
  • session_affinity_ttl: Tempo, em segundos, até que o cookie de afinidade de sessão deste balanceador de carga expire após sua criação. O valor válido está entre [1800, 604800]. O valor padrão é 82800.
  • steering_policy : Os valores válidos para steering_policy são off, ` `geo, random e ` `dynamic_latency.
    • off: Use default_pools.
    • geo: Use region_pools/pop_pools.
    • random: Selecione um grupo aleatoriamente.
    • dynamic_latency: Use o tempo de ida e volta para selecionar o pool mais próximo em default_pools (requer verificações de integridade do pool).

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem um balanceador de carga global.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie um balanceador de carga global no domínio 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"]}}'

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

GLB_ID

O ID do balanceador de carga global. Obrigatório.

--json

O arquivo JSON ou a string JSON utilizada para descrever um balanceador de carga global. Obrigatório.

• Os campos obrigatórios nos dados JSON são name, fallback_pool e default_pools:
  • name: O nome de host DNS a ser associado ao seu balanceador de carga.
  • fallback_pool: O ID do pool a ser utilizado quando todos os outros pools forem detectados como inoperantes.
  • default_pools: Uma lista de IDs de pool ordenados por sua prioridade de failover.
• Os campos opcionais são description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy:
  • description: A descrição do seu balanceador de carga.
  • ttl: Tempo de vida (TTL) da entrada DNS correspondente ao endereço IP retornado por este balanceador de carga.
  • region_pools: Uma correspondência entre os códigos de região e de país e uma lista de IDs de pool (ordenados por sua prioridade de failover) para a região.
  • proxied: Defina se o tráfego deve passar pelas funções de segurança e desempenho no CIS.
  • enabled: Se deseja ativar (opção padrão) este balanceador de carga.
  • session_affinity servidor de backend: garante que as solicitações de um usuário sejam direcionadas de forma consistente para o mesmo servidor de backend durante uma sessão. Os valores válidos são cookie e none.
  • session_affinity_ttl: Tempo, em segundos, até que o cookie de afinidade de sessão deste balanceador de carga expire após sua criação. O valor válido está entre [1800, 604800]. O valor padrão é 82800.
  • steering_policy : Os valores válidos para steering_policy são off, ` `geo, random e ` `dynamic_latency.
    • off: Use default_pools.
    • geo: Use region_pools/pop_pools.
    • random: Selecione um grupo aleatoriamente.
    • dynamic_latency: Use o tempo de ida e volta para selecionar o pool mais próximo em default_pools (requer verificações de integridade do pool).

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem um balanceador de carga global.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize o balanceador de carga global GLB_ID no domínio 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"]}}'

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

GLB_ID

O ID do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Exibir o balanceador de carga global GLB_ID no domínio DNS_DOMAIN_ID.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

GLB_ID

O ID do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o balanceador de carga global GLB_ID no domínio DNS_DOMAIN_ID.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar os balanceadores de carga do domínio DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

Especificar o formato de saída. Somente JSON é suportado.

Exemplos

Liste todos os pools GLB.

ibmcloud cis glb-pools

Opções de comando

--json

O arquivo JSON ou a string JSON utilizada para descrever um pool GLB. Obrigatório.

• Os campos obrigatórios nos dados JSON são name, origins e check_regions:
  • name: Um nome abreviado (tag) para o pool.
  • origins: Uma lista de origens contidas nesse conjunto.
  • check_regions: Uma lista de códigos de regiões geográficas.
• Os campos opcionais são description, minimum_origins, enabled, monitor.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um conjunto de GLB.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Criar um pool GLB.

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

Opções de comando

GLB_POOL_ID

O ID do pool do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Exibir os detalhes do pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool GLB_POOL_ID

Opções de comando

GLB_POOL_ID

O ID do pool do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Opções de comando

GLB_POOL_ID

O ID do pool do balanceador de carga global. Obrigatório.

--json

O arquivo JSON ou a string JSON utilizada para descrever um pool GLB.

• Os campos obrigatórios nos dados JSON são name, origins e check_regions:
  • name: Um nome abreviado (tag) para o pool.
  • origins: Uma lista de origens contidas nesse conjunto.
  • check_regions: Uma lista de códigos de regiões geográficas.
• Os campos opcionais são description, minimum_origins, enabled, monitor.

Dados JSON de amostra:

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

Ative a origem dentro do Conjunto. O valor pode ser ORIGIN_NAME ou ORIGIN_ADDRESS.

--disable-origin

Desative a origem dentro do Conjunto. O valor pode ser ORIGIN_NAME ou ORIGIN_ADDRESS.

--add-origin

Inclua uma origem no Conjunto. ORIGIN_NAME e ORIGIN_ADDRESS são necessários. Por exemplo, --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Remova uma origem do Conjunto. O valor pode ser ORIGIN_NAME ou ORIGIN_ADDRESS.

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um conjunto de GLB.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualizar o pool GLB GLB_POOL_ID.

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

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Liste todos os monitores GLB.

ibmcloud cis glb-monitors

Opções de comando

--json

O arquivo JSON ou a string JSON utilizada para descrever um monitor GLB. Obrigatório.

• Os campos obrigatórios em dados JSON são type.
  • type: O protocolo a ser utilizado para a verificação de integridade. Os valores válidos são HTTP, HTTPS e TCP.
• Os campos opcionais são description, timeout, retries, interval.
  • description: Descrição.
  • timeout: O tempo de espera (em segundos) antes de marcar a verificação de integridade como malsucedida.
  • retries: O número de tentativas a serem realizadas em caso de tempo limite, antes de marcar a origem como inativa.
  • interval: O intervalo entre cada verificação de saúde.
• Para TCP, digite verificação de funcionamento. Os campos adicionais obrigatórios são port.
  • port: A porta do serviço “ TCP ” a ser utilizada para a verificação de integridade.
• Para HTTP/HTTPS, digite verificação de funcionamento. Os campos de opção adicionais são port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: A porta do serviço “ TCP ” a ser utilizada para a verificação de integridade.
  • expected_body: Uma subcadeia de caracteres (sem distinção entre maiúsculas e minúsculas) a ser procurada no corpo da resposta.
  • expected_codes: O código de resposta HTTP esperado ou o intervalo de códigos para a verificação de integridade.
  • method: O método HTTP a ser utilizado para a verificação de integridade.
  • path: O caminho do endpoint a ser verificado.
  • header: Os cabeçalhos de solicitação HTTP a serem enviados na verificação de integridade.
  • follow_redirects: Siga os redirecionamentos, caso sejam retornados pelo servidor de origem.
  • allow_insecure: Não valide o certificado quando o monitor utilizar o endereço HTTPS.
  • probe_zone: Atribua este monitor para emular a zona especificada durante o teste.

Dados JSON de amostra:

Para HTTP/HTTPS:

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

Para TCP:

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

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um monitor de GLB.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

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

Opções de comando

GLB_MON_ID

O ID do monitor do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Exiba os detalhes do monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor GLB_MON_ID

Opções de comando

GLB_MON_ID

O ID do monitor do balanceador de carga global. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o monitor GLB GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Opções de comando

GLB_MON_ID

O ID do monitor do balanceador de carga global. Obrigatório.

--json

O arquivo JSON ou a string JSON utilizada para descrever um monitor GLB. Obrigatório.

• Os campos obrigatórios em dados JSON são type.
  • type: O protocolo a ser utilizado para a verificação de integridade. Os valores válidos são HTTP, HTTPS e TCP.
• Os campos opcionais são description, timeout, retries, interval.
  • description: Descrição.
  • timeout: O tempo de espera (em segundos) antes de marcar a verificação de integridade como malsucedida.
  • retries: O número de tentativas a serem realizadas em caso de tempo limite, antes de marcar a origem como inativa.
  • interval: O intervalo entre cada verificação de saúde.
• Para TCP, digite verificação de funcionamento. Os campos adicionais obrigatórios são port.
  • port: A porta do serviço “ TCP ” a ser utilizada para a verificação de integridade.
• Para HTTP/HTTPS, digite verificação de funcionamento. Os campos de opção adicionais são port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: A porta do serviço “ TCP ” a ser utilizada para a verificação de integridade.
  • expected_body: Uma subcadeia de caracteres (sem distinção entre maiúsculas e minúsculas) a ser procurada no corpo da resposta.
  • expected_codes: O código de resposta HTTP esperado ou o intervalo de códigos para a verificação de integridade.
  • method: O método HTTP a ser utilizado para a verificação de integridade.
  • path: O caminho do endpoint a ser verificado.
  • header: Os cabeçalhos de solicitação HTTP a serem enviados na verificação de integridade.
  • follow_redirects: Siga os redirecionamentos, caso sejam retornados pelo servidor de origem.
  • allow_insecure: Não valide o certificado quando o monitor utilizar o endereço HTTPS.
  • probe_zone: Atribua este monitor para emular a zona especificada durante o teste.

Dados JSON de amostra:

Para HTTP/HTTPS:

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

Para TCP:

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

-s, --json-str

Obsoleto. Os dados JSON usados para descrever um monitor de GLB.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

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

Opções de comando

-s, --since

Data de início de solicitação do período de dados no formato ISO8601. Por exemplo, 2018-11-26.

-u, --until

Data de encerramento de solicitação do período de dados no formato ISO8601. Por exemplo, 2018-11-28.

--origin-name

O nome da origem para filtragem.

--pool-name

O nome do conjunto para filtragem.

--origin-healthy

Se for verdadeiro, filtre os eventos em que o status da origem for “normal”; se for falso, filtre os eventos em que o status da origem for “anormal”. O valor padrão é true, e os valores válidos são true e false.

--pool-healthy

Se for verdadeiro, filtre os eventos em que o status do pool estiver normal; se for falso, filtre os eventos em que o status do pool estiver anormal. O valor padrão é true, e os valores válidos são true e false.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obter eventos de glb.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--fields

Defina o conjunto de campos na resposta.

• Este campo deve ser especificado como uma lista separada por vírgulas, sem espaços em branco, e todos os campos devem estar preenchidos.
• A ordem em que os campos são especificados não importa e a ordem dos campos na resposta não é especificada.
• Espera-se que os campos sejam sensíveis a maiúsculas e minúsculas.

--filter

Filtra para realizar drill down em eventos específicos. Os filtros consistem em três partes: chave, operador e valor. Para obter informações sobre os operadores compatíveis, consulte Uso de campos, funções e expressões.

--sample

A taxa de amostragem dos registros definida pelo cliente: sample: 1 corresponde a 100% dos registros.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

-h, --help

Veja a ajuda sobre este comando.

Exemplos

Crie um registro instantâneo para o domínio DNS_DOMAIN_ID:

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

A seguir, três exemplos de filtros:

• Filtrar quando o país do IP do cliente não for o Canadá:

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

• Filtrar quando o código de status retornado de CIS for 200 ou 201:

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

• Filtra quando o caminho da solicitação contém "/static" e o nome do host da solicitação é " example.com ":

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

-h, --help

Ajuda sobre esse comando.

Exemplo

Obter a tarefa de registros instantâneos para o domínio DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--available-fields

Lista com todos os campos disponíveis.

--ray-id

Logs de consulta para ID de raio específico.

--fields

Defina o conjunto de campos na resposta. Este campo deve ser especificado como uma lista separada por vírgulas, sem espaços, e todos os campos devem estar preenchidos. A ordem em que os campos são especificados não importa e a ordem dos campos na resposta não é especificada. Observe que os campos devem fazer distinção entre maiúsculas e minúsculas.

--start

O início (inclusivo) do período de tempo solicitado. Isso pode ser um registro de data e hora do UNIX (em segundos ou nanossegundos) ou um registro absoluto de data e hora em conformidade com o RFC 3339. Atualmente, não pode corresponder a um momento no passado anterior a 7 dias. O padrão é 65 minutos antes.

--end

O final (exclusivo) do período de tempo solicitado. Esse valor pode ser um timestamp do Unix (em segundos ou nanossegundos) ou um timestamp absoluto em conformidade com a RFC 3339. O end deve ser pelo menos 5 minutos antes de agora e deve ser posterior ao start. A diferença entre start e end não deve ser maior do que 1h. O padrão é 5 minutos antes.

--count

Número de logs a serem recuperados. O valor padrão é -1.

--sample

Porcentagem de amostragem. Quando uma amostra é fornecida, é retornada uma amostra de registros correspondentes. Se sample=0.1 , então 10% dos registros são retornados. A amostragem é aleatória: chamadas repetidas não apenas retornam registros diferentes, mas provavelmente também variam ligeiramente no número de registros retornados. Quando a contagem também é especificada, ela é aplicada ao número de registros retornados, não aos registros amostrados. Portanto, com sample=0.05 e count=7, quando há um total de 100 registros disponíveis, são retornados aproximadamente 5 registros. Quando há 1.000 registros, são retornados 7 registros. Quando há 10.000 registros, são retornados 7 registros. O valor padrão é 1.

--timestamps

Configure o formato em que os registros de data e hora das respostas são retornados. Os valores válidos são unix, unixnano e rfc3339.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--destination

Especifique um destino para o qual os dados são enviados. Para obter mais informações sobre os destinos compatíveis, consulte Gerenciamento de trabalhos do Logpush.

• Sintaxe para o caminho “ Cloud Object Storage ”: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Exemplo: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Para separar os logs em subpastas diárias, use a sequência especial {DATE} no caminho do bucket. Ela é substituída pela data no formato YYYYMMDD, por exemplo, '20190423'. As subpastas são criadas conforme necessário, por exemplo: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Nome do cargo. Obrigatório.

--enable

Habilitar o trabalho. A tarefa é desativada por padrão.

--fields

Defina a lista de campos de log a serem incluídos nos arquivos de log. Vários campos podem ser separados por vírgulas e utilizar o comando [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] para obter a lista completa de campos de log disponíveis, ou use all para incluir todos os campos disponíveis nos arquivos de log. Observe que os campos devem fazer distinção entre maiúsculas e minúsculas.

--timestamps

Configure o formato em que os registros de data e hora das respostas são retornados. Os valores válidos são unix, unixnano e rfc3339.

--dataset

A categoria de registros que você deseja receber. Esse valor não pode ser mudado depois que a tarefa é criada. Os valores válidos são http_requests, range_events, firewall_events, dns_logs. O valor padrão é http_requests.

--frequency

A frequência na qual CIS envia lotes de logs para o seu destino. Ao definir a frequência para “alta”, seus logs são enviados em quantidades maiores, mas em arquivos menores. Ao definir a frequência para “baixa”, os logs são enviados em quantidades menores, mas em arquivos maiores. Os valores válidos são high e low.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Criar um trabalho de logpush para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--destination

Especifique um destino para o qual os dados são enviados. Para obter mais informações sobre os destinos compatíveis, consulte Gerenciamento de trabalhos do Logpush. Sintaxe para o caminho “ Cloud Object Storage ”: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Exemplo: 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Para logs separados em subpastas diárias, use a sequência especial {DATE} no caminho do depósito. Deve ser substituído pela data no formato YYYYMMDD, por exemplo, '20190423'. As subpastas são criadas conforme necessário, por exemplo: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Habilitar o trabalho. A tarefa é desativada por padrão.

--fields

Defina a lista de campos de log a serem incluídos nos arquivos de log. Vários campos podem ser separados por vírgulas e use o comando ibmcloud cis logpush-available-fields DNS_DOMAIN_ID para obter a lista abrangente de campos de log disponíveis ou use all para incluir todos os campos disponíveis em arquivos de log. Observe que os campos devem fazer distinção entre maiúsculas e minúsculas.

--timestamps

Configure o formato em que os registros de data e hora das respostas são retornados. Os valores válidos são unix, unixnano e rfc3339.

--dataset

A categoria de registros que você deseja receber. Esse valor não pode ser mudado depois que a tarefa é criada. Os valores válidos são http_requests, range_events, firewall_events,dns_logs. O valor padrão é http_requests.

--jobid

JOB_ID é o ID da tarefa de envio de logs.

--frequency

A frequência na qual CIS envia lotes de logs para o seu destino. Ao definir a frequência para “alta”, seus logs são enviados em quantidades maiores, mas em arquivos menores. Ao definir a frequência para “baixa”, os logs são enviados em quantidades menores, mas em arquivos maiores. Os valores válidos são high e low.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualizar o trabalho de logpush range_events para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

-output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obter todos os trabalhos de logpush para o domínio DNS_DOMAIN_ID.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--dataset

A categoria de registros que você deseja receber. Esse valor não pode ser mudado depois que a tarefa é criada. Os valores válidos são http_requests, range_events, firewall_events,dns_logs. O valor padrão é http_requests.

--jobid

JOB_ID é o ID da tarefa de envio de logs.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obter detalhes do trabalho http_requests logpush.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--dataset

A categoria de registros que você deseja receber. Esse valor não pode ser mudado depois que a tarefa é criada. Os valores válidos são http_requests, range_events, firewall_events,dns_logs. O valor padrão é http_requests.

--jobid

JOB_ID é o ID da tarefa de envio de logs.

-f, --force

Excluir a tarefa de envio de log sem solicitar confirmação.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o trabalho de logpush http_requests para o domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--dataset

A categoria de registros que você deseja receber. Esse valor não pode ser mudado depois que a tarefa é criada. Os valores válidos são http_requests, range_events, firewall_events,dns_logs. O valor padrão é http_requests.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Obtenha todos os campos disponíveis para logs http_requests.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha uma configuração de retenção de logs para o domínio DNS_DOMAIN_ID.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--flag

Se a retenção de registros deve ser ativada ou desativada. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Ativar a retenção de registros para o domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--dataset

Conjunto de dados solicitado. O valor padrão é firewallEventsAdaptiveGroups.

Use a tabela a seguir para identificar quais conjuntos de dados estão incluídos em seu plano e a faixa de dados históricos que pode ser consultada.

Conjuntos de dados incluídos em seu plano

Conjunto de dados	Avaliação / Padrão / Padrão seguinte	Corporativo/Segurança/GLB
firewallEventsAdaptiveGroups	30 dias	30 dias
firewallEventsAdaptive	30 dias	30 dias

--filter

Filtrar eventos. O valor padrão são as últimas seis horas de dados.

Os operadores a seguir são suportados para todas as opções de filtro:

Operadores suportados para opções de filtro

Operador	Comparação
gt	superior a
lt	menos que
geq	maior ou igual a
leq	menos ou igual a
neq	não é igual
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

Ordem de saída. (O valor padrão é datetime_ASC)

A lista a seguir contém opções de solicitações utilizáveis para o conjunto de dados correspondente e todas elas suportam as ações ASC e DESC. Combine essas opções de filtro e ação com _.

Por exemplo, datetime_ASC ordena os registros por data e hora, em ordem crescente.

• Opções de ordem de 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

O número de eventos a serem retornados. (mínimo: 1, máximo: 10000, padrão: 10000)

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha análises de eventos do firewall para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--dataset

Conjunto de dados solicitado. O valor padrão é httpRequests1dGroups. Use a tabela a seguir para identificar quais conjuntos de dados estão incluídos em seu plano e a faixa de dados históricos que pode ser consultada.

Identifique os conjuntos de dados incluídos em seu plano

Conjunto de dados	Versão de avaliação / Padrão / Padrão seguinte	Corporativo/Segurança/GLB
httpRequests1dGroups	365 dias	365 dias
httpRequests1hGroups	30 dias	90 dias
httpRequests1mGroups	3 dias	7 dias

--filter

Filtrar eventos. O valor padrão são os últimos sete dias de dados. Os operadores a seguir são suportados para todas as opções de filtro:

Operadores suportados para opções de filtro

Operador	Comparação
gt	superior a
lt	menos que
geq	maior ou igual a
leq	menos ou igual a
neq	não é igual
in	in

• Opções de filtro de httpRequests1dGroups e httpRequests1hGroups.

  • date

• httpRequests1mGroups Opções de filtro.

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Ordem de saída. (O valor padrão é datetime_ASC)

A lista a seguir contém opções de solicitações utilizáveis para o conjunto de dados correspondente e todas elas suportam as ações ASC e DESC. Combine essas opções de ordem e ação com _.

Por exemplo, date_ASC ordena os resultados por data, em ordem crescente.

• Opções de ordem comuns para cada conjunto de dados HTTP.
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Opções de ordem de httpRequests1dGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Opções de ordem de httpRequests1hGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Opções de ordem de httpRequests1mGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

O número de eventos a serem retornados. (mínimo: 1, máximo: 10000, padrão: 10000)

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha análises de solicitações HTTP para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--recent

O início do período de tempo solicitado. Os valores válidos são 6h (há 6 horas), 12h, 1d (há 1 dia), 1w (há 1 semana), 1m (há 1 mês), 2m, 3m. O valor padrão é 1w.

-t, --table

Tabela de saída. Os valores válidos são: requests, bandwidth, uniques, threats e status_code. Se esse campo não for definido, ele produzirá todas as tabelas.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha análises da web para o domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

DIMENSION

A dimensão consultada. Os valores válidos são queries-by-response-code, queries-by-type, queries-by-name. Obrigatório.

-s, --since

Desde o horário até agora. Os valores válidos são 6h (há 6 horas), 12h, 1d (há 1 dia), 1w (há 1 semana).

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha análises de DNS para o domínio DNS_DOMAIN_ID.

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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--recent

O início do período de tempo solicitado. Os valores válidos são 6h (há 6 horas), 12h, 1d (há 1 dia), 1w (há 1 semana), 1m (há 1 mês), 2m, 3m. O valor padrão é 1w.

--time-delta

O intervalo de tempo (segundos) de cada registro de análise. Os valores válidos são 60, 3600, 86400, 2592000. O valor padrão é 3600.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Obtenha análises de limite de taxa para o domínio DNS_DOMAIN_ID.

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

Opções de comando

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Habilitar o Mutual TLS.

ibmcloud cis access-enable

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar todos os certificados de origem do domínio DNS_DOMAIN_ID.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--request-type REQUEST_TYPE

Tipo de assinatura que você deseja no certificado. Os valores válidos são origin-rsa e origin-ecc.

--hostnames HOSTNAME

nome do host ou nome curinga que está vinculado ao certificado.

--requested-validity DAYS

O número de dias durante os quais o certificado deve ser válido. O valor padrão é 5475.

--csr CSR

A solicitação de assinatura de certificado (CSR). Se esse campo não estiver definido, o site CIS gera um.

--json value*

O arquivo JSON ou a string JSON utilizada para descrever um certificado de origem.

• Os campos obrigatórios em dados JSON são request_type, hostnames.
  • request_type tipo de assinatura que você deseja no certificado. Os valores válidos são origin-rsa e origin-ecc.
  • hostnames: Uma matriz de nomes de host ou nomes com caracteres curinga vinculados ao certificado.
• Os campos opcionais são requested_validity, csr.
  • requested_validity: O número de dias durante os quais o certificado deve ser válido. Os valores válidos são: 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: A Solicitação de Assinatura de Certificado (CSR). Se esse campo não estiver definido, o site CIS gera um.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem um certificado de origem.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie um certificado assinado pelo servidor de certificação CIS para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

CERT_ID

A ID do certificado de origem. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Veja os detalhes do certificado de origem em CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

CERT_ID

O número de identificação do Certificado de Origem. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir o certificado de origem CERT_ID.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Exibir as informações gerais do domínio DNS_DOMAIN_ID.

ibmcloud cis overview DNS_DOMAIN_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--json

O arquivo JSON ou a string JSON utilizada para descrever uma regra de página. Obrigatório.

• Os campos obrigatórios nos dados JSON são “targets” e “actions”:
  • targets: O padrão de URL de destino a ser avaliado em uma solicitação.
  • actions: Um conjunto de ações a serem executadas caso os alvos desta regra correspondam à solicitação. As ações disponíveis são:
    • 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
    • Depreciado. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Algumas ações estão restritas aos planos 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
• Os campos opcionais são priority e status:
  • priority: Um número que indica a preferência por uma regra de página em detrimento de outra. O valor padrão é 1.
  • status: Status da regra da página. Os valores válidos são active e disabled (padrão).

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de página.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Crie uma regra de página para o domínio 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

PAGE_RULE_ID

O ID da regra da página. Obrigatório.

--json VALUE

O arquivo JSON ou a string JSON utilizada para descrever uma regra de página. Obrigatório.

• Os campos obrigatórios nos dados JSON são targets e actions:
  • targets: O padrão de URL de destino a ser avaliado em uma solicitação.
  • actions: Um conjunto de ações a serem executadas caso os alvos desta regra correspondam à solicitação. As ações disponíveis são:
    • 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
    • Descontinuado. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Algumas ações estão restritas aos planos 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
• Os campos opcionais são priority e status:
  • priority: Um número que indica a preferência por uma regra de página em detrimento de outra. O valor padrão é 1.
  • status: Status da regra da página. Os valores válidos são active e disabled. O valor padrão é disabled.

Dados JSON de amostra:

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

-s, --json-str

Obsoleto. Os dados JSON que descrevem uma regra de página.

-j, --json-file

Obsoleto. Um arquivo contém dados JSON de entrada.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Atualize a regra da 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

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

PAGE_RULE_ID

O ID da regra da página. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

Exemplos

Excluir a regra da página PAGE_RULE_ID.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Listar todas as regras de página no domínio DNS_DOMAIN_ID.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

PAGE_RULE_ID

O ID da regra da página. Obrigatório.

-i, --instance

O ID ou o nome da instância. Se o nome ou a ID da instância não for definido, será usada a instância de contexto especificada por ibmcloud cis instance-set INSTANCE.

--output

O formato de saída. Atualmente, json é o único valor compatível.

Exemplos

Veja os detalhes da regra de página PAGE_RULE_ID.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Opções de comando

DNS_DOMAIN_ID

A ID do domínio DNS. Obrigatório.

--name

O nome do registro DNS para o pedido de intervalo.

--edge-port

Configuração de porta na borda do CIS. O valor padrão é 22.

--origin-direct

Endereços de destino para a origem.

--origin-lb-name

O nome do balanceador de carga associado ao aplicativo “range”.

--origin-lb-port

A porta do balanceador de carga associada ao intervalo da aplicação. O valor padrão é 22.

--protocol

Tipo de protocolo. Os valores válidos são tcp e udp. O suporte ao protocolo UDP está em acesso antecipado; solicite UDP customizado do painel do CIS antes de criar o app UDP de intervalo. O valor padrão é tcp.

--proxy-protocol

Ativar o Protocolo Proxy para a origem. Os valores válidos são on, off, v1, v2, simple. O valor padrão é off. Obsoleto. O valor on é equivalente a v1.

--ip-firewall

Controle se o Firewall IP para esse aplicativo está ativado. Os valores válidos são on e off. O valor padrão é off.

--edge-connectivity

As versões de IP compatíveis para conexões de entrada em um intervalo de endereços IP anycast. Os valores válidos são all, ipv4, ipv6. O valor padrão é all.

--edge-tls

O tipo de finalização de TLS associado ao aplicativo. Os valores válidos são off, flexible, full, strict. O valor padrão é off.

--traffic-type

Determina como os dados percorrem da borda até a origem. Os valores válidos são direct, http, https. O valor padrão é direct.

--json

O arquivo JSON ou a string JSON utilizada para descrever um pedido de intervalo.

• Os campos obrigatórios nos dados JSON são protocol e dns.
  • protocol: Configuração de portas na borda de CIS.
  • dns: O nome e o tipo do registro DNS para o pedido de intervalo.
    • name: O nome do registro DNS para o pedido de intervalo.
    • type: O tipo do registro DNS associado ao aplicativo. O valor válido é CNAME.
• Os campos opcionais são origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls e traffic_type.
  • origin_direct: Uma lista de endereços de destino em relação à origem.
  • origin_dns: Método e parâmetros utilizados para descobrir o endereço do servidor de origem por meio do DNS.
    • name: Nome do registro DNS.
  • origin_port: O porto de destino na origem.
  • proxy_protocol: Ative o Protocolo de Proxy para o servidor de origem. Os valores válidos são on, off, v1, v2, simple. O valor padrão é off. Descontinuado. O valor on é equivalente a v1.
  • ip_firewall firewall IP: Controle se o Firewall IP para esse aplicativo está ativado. Os valores válidos são on e off.
  • edge_ips: A configuração do IP de borda anycast para o nome de host deste aplicativo.
    • type: O tipo de configuração de IP de borda especificado. Os IPs de borda de borda dinamicamente alocados usam IPs de anycast de intervalo de acordo com a conectividade especificada. O valor válido é dynamic.
    • connectivity: As versões de IP compatíveis para conexões de entrada em um intervalo de endereços IP anycast. Valores válidos: all, ipv4, ipv6.
  • tls: o tipo de finalização do TLS associado ao aplicativo. Os valores válidos são off, flexible, full e strict.
  • traffic_type: Determina como os dados são transmitidos da borda até sua origem. Quando definido como “ direct ”, o range encaminha o tráfego diretamente para sua origem, e o tipo do aplicativo é determinado a partir do protocolo. Quando definido como “ http ” ou “ https ”, o intervalo aplica os recursos de “ HTTP ” / “ HTTPS ” do “ CIS ”, uma vez que encaminha o tráfego para sua origem, e o tipo de aplicativo corresponde exatamente a essa propriedade. Os valores válidos são direct, http e https. O valor padrão é direct.

Dados JSON de amostra:

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