Cloudflare
Visão geral
Seção intitulada “Visão geral”O Cloudflare é uma rede global de segurança e desempenho que protege e acelera tudo que você conecta à Internet. Com a integração Cloudflare no SquadOS, seus agentes podem gerenciar registros DNS, zonas, listas WAF, regras de firewall, túneis, pools de balanceamento de carga e configurações de bot programaticamente, sem precisar acessar o painel web.
- Site oficial: https://www.cloudflare.com/
- Documentação na Composio: docs.composio.dev/toolkits/cloudflare
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza chave de API (API_KEY) para conectar.
Você vai precisar dos seguintes campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
api_key | Sim | Token de API do Cloudflare com as permissões necessárias para as operações desejadas. |
Como obter a credencial
Seção intitulada “Como obter a credencial”- Acesse dash.cloudflare.com/profile/api-tokens — é a página de API Tokens do seu perfil.
- Clique em Create Token.
- Escolha um dos templates disponíveis ou clique em Create Custom Token para montar as permissões manualmente.
- Dê um nome descritivo ao token (ex.:
SquadOS). - Em Permissions, selecione os grupos e níveis de acesso que o token precisará (ex.: Zone → DNS → Edit para gerenciar registros DNS).
- Em Zone Resources, escolha as zonas às quais o token terá acesso (específicas ou todas).
- Opcionalmente, restrinja o token por IP de origem ou defina uma data de expiração (TTL).
- Clique em Continue to summary e, em seguida, em Create Token.
- Copie e guarde o token exibido — ele só é mostrado uma vez.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Cloudflare. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde informa o token de API obtido acima.
- Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)
Ações disponíveis
Seção intitulada “Ações disponíveis”Criar registro DNS
Seção intitulada “Criar registro DNS”CLOUDFLARE_CREATE_DNS_RECORD
Cria um novo registro DNS em uma zona específica. Requer privilégios de escrita e aplica as alterações imediatamente na zona. Use após obter o ID da zona via CLOUDFLARE_LIST_ZONES para adicionar entradas DNS programaticamente.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ttl | integer | Não | Tempo de vida em segundos; mínimo 1. Use 1 para TTL automático. |
data | object | Não | Objeto de dados adicionais para tipos de registro como SRV, LOC ou CAA. |
name | string | Sim | Nome do registro DNS (ex.: example.com ou www.example.com). |
tags | array | Não | Lista de tags a associar ao registro. |
type | string | Sim | Tipo do registro DNS (A, AAAA, CNAME, MX, TXT, SRV, LOC, CAA). |
comment | string | Não | Comentário legível para o registro DNS. |
content | string | Sim | Conteúdo do registro DNS (ex.: IP para registros A). |
proxied | boolean | Não | Se o registro receberá os benefícios de desempenho e segurança do Cloudflare. |
priority | integer | Não | Prioridade para registros MX, SRV e URI; obrigatório para esses tipos. |
zone_identifier | string | Sim | Identificador da zona (UUID) onde o registro DNS será criado. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar lista WAF
Seção intitulada “Criar lista WAF”CLOUDFLARE_CREATE_LIST
Cria uma nova lista customizada vazia para uso em regras e filtros WAF. As listas podem conter endereços IP, hostnames, ASNs ou redirecionamentos. Após a criação, use ações separadas para adicionar itens à lista. Disponibilidade por plano: Free (1 lista), Pro/Business (10 listas), Enterprise (1000 listas).
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
kind | string | Sim | Tipo da lista: ip, redirect, hostname ou asn. |
name | string | Sim | Nome descritivo da lista (máx. 50 caracteres). Usado em expressões de filtro e regra. |
account_id | string | Sim | Identificador da conta Cloudflare (máx. 32 caracteres). |
description | string | Não | Descrição opcional da lista (máx. 500 caracteres). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar zona
Seção intitulada “Criar zona”CLOUDFLARE_CREATE_ZONE
Cria uma nova zona DNS (domínio) no Cloudflare. Uma zona representa um domínio e seus registros DNS. Use ao adicionar um novo domínio para gerenciar pelo Cloudflare. Requer o ID da conta (obtível via CLOUDFLARE_LIST_ACCOUNTS). A zona ficará em status pending até que os nameservers sejam atualizados no registrador do domínio.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Sim | Nome do domínio para a nova zona. |
type | string | Não | Modo de configuração da zona: full (DNS hospedado pelo Cloudflare), partial (configuração CNAME) ou secondary (DNS secundário). |
account | object | Não | Container para o ID da conta. Se não fornecido, a zona será criada na conta padrão das credenciais de API. Deve ser estruturado como {'id': '<account_id>'} onde id é obtido via CLOUDFLARE_LIST_ACCOUNTS. |
jump_start | boolean | Não | Importar automaticamente registros DNS existentes do domínio. Ignorado para zonas parciais. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir registro DNS
Seção intitulada “Excluir registro DNS”CLOUDFLARE_DELETE_DNS_RECORD
Exclui um registro DNS em uma zona específica. A exclusão é imediata e irreversível. Use somente após confirmar os IDs da zona e do registro. Requer privilégios de escrita na zona.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
identifier | string | Sim | Identificador do registro DNS a excluir (ex.: 372e67954025e0ba6aaa6d586b9e0b59). |
zone_identifier | string | Sim | Identificador da zona DNS (ex.: 023e105f4ecef8ad9ca31a8372d0c353). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir lista WAF
Seção intitulada “Excluir lista WAF”CLOUDFLARE_DELETE_LIST
Exclui uma lista WAF. Use após verificar que nenhum filtro referencia a lista. Requer os identificadores da conta e da lista.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
list_id | string | Sim | Identificador único da lista WAF a excluir. |
account_id | string | Sim | Identificador da conta Cloudflare. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir zona
Seção intitulada “Excluir zona”CLOUDFLARE_DELETE_ZONE
Exclui uma zona. Use após confirmar o identificador da zona para remover permanentemente uma zona DNS e todos os seus registros da conta Cloudflare.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
zone_identifier | string | Sim | Identificador da zona a excluir (string hexadecimal de 32 caracteres). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter configurações de gerenciamento de bots
Seção intitulada “Obter configurações de gerenciamento de bots”CLOUDFLARE_GET_BOT_MANAGEMENT_SETTINGS
Recupera a configuração de Gerenciamento de Bots de uma zona (Bot Fight Mode / Super Bot Fight Mode / Enterprise Bot Management). Use após identificar o zone_id correto (ex.: via CLOUDFLARE_LIST_ZONES). Esta é a forma canônica de auditar configurações relacionadas a bots; regras de firewall são controles adjacentes, mas não equivalentes às configurações de Bot Management.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
zone_id | string | Sim | Identificador da zona (UUID) para recuperar as configurações de Bot Management. Obtido via ação Listar Zonas. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar listas WAF
Seção intitulada “Listar listas WAF”CLOUDFLARE_GET_LISTS
Busca todas as listas WAF (sem os itens) de uma conta. Os resultados são paginados; itere usando os parâmetros page e per_page até atingir result_info.total_pages para recuperar todas as listas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
account_id | string | Sim | Identificador da conta Cloudflare (32 caracteres hexadecimais). Deve corresponder à conta proprietária da zona alvo para evitar mistura de dados entre contas. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar membros da conta
Seção intitulada “Listar membros da conta”CLOUDFLARE_LIST_ACCOUNT_MEMBERS
Lista todos os membros de uma conta Cloudflare com seus papéis, permissões e status. Retorna informações detalhadas sobre cada membro, incluindo dados do usuário (nome, e-mail, status de 2FA), papéis atribuídos com permissões granulares, status de adesão (aceito/pendente/rejeitado) e políticas de acesso. Suporta filtragem por status, ordenação por vários campos e paginação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Número da página para paginação (deve ser >= 1). Padrão: 1. |
order | string | Não | Campo para ordenar os resultados: user.first_name, user.last_name, user.email ou status. |
status | string | Não | Filtrar membros por status: accepted (membros ativos), pending (convidados ainda não aceitos) ou rejected (convites recusados). Omitir para retornar todos. |
per_page | integer | Não | Número de resultados por página (entre 5 e 50). Padrão da API: 20. |
direction | string | Não | Direção da ordenação: asc (crescente) ou desc (decrescente). |
account_id | string | Sim | Identificador único (string hexadecimal de 32 caracteres) da conta Cloudflare cujos membros se deseja listar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar contas
Seção intitulada “Listar contas”CLOUDFLARE_LIST_ACCOUNTS
Lista todas as contas Cloudflare às quais você tem acesso de proprietário ou verificado. Retorna uma lista paginada de contas com seus detalhes, incluindo ID, nome, tipo, configurações e data de criação. Um resultado vazio ou parcial pode indicar escopo insuficiente do token de API, não ausência de contas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Filtrar contas por nome. Pode retornar múltiplos resultados para nomes semelhantes; sempre verifique o account_id correto na resposta. |
page | integer | Não | Número da página a recuperar, começando em 1. |
per_page | integer | Não | Número de resultados por página (entre 5 e 50). |
direction | string | Não | Direção da ordenação dos resultados: asc ou desc. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar registros DNS
Seção intitulada “Listar registros DNS”CLOUDFLARE_LIST_DNS_RECORDS
Lista e pesquisa registros DNS em uma zona Cloudflare. Use quando precisar encontrar IDs de registros DNS existentes para operações de atualização ou exclusão, especialmente após um erro “registro já existe” durante a criação.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Filtrar pelo nome exato do registro DNS (FQDN). |
page | integer | Não | Número da página para paginação, começando em 1. |
type | string | Não | Filtrar pelo tipo do registro DNS (A, AAAA, CAA, CERT, CNAME, DNSKEY, DS, HTTPS, LOC, MX, NAPTR, NS, PTR, SMIMEA, SRV, SSHFP, SVCB, TLSA, TXT, URI). |
match | string | Não | Lógica de correspondência dos filtros: all (AND) ou any (OR). Padrão: all. |
content | string | Não | Filtrar pelo conteúdo/valor exato do registro DNS. |
proxied | boolean | Não | Filtrar por status de proxy: true para registros com proxy, false para registros somente DNS. |
zone_id | string | Sim | Identificador da zona (UUID) da qual listar os registros DNS. |
per_page | integer | Não | Número de registros por página (1–5.000.000). Padrão: 100. |
name_contains | string | Não | Filtrar por nomes de registros DNS que contenham esta substring. |
comment_contains | string | Não | Filtrar por comentários que contenham esta substring. |
content_contains | string | Não | Filtrar por conteúdo do registro DNS que contenha esta substring. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar regras de firewall
Seção intitulada “Listar regras de firewall”CLOUDFLARE_LIST_FIREWALL_RULES
Lista as regras de firewall de uma zona DNS específica. Use após confirmar o ID da zona para recuperar e auditar as regras de firewall atuais. Não expõe rotas do Workers nem outras construções de roteamento.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Número da página para resultados paginados, começando em 1. Verifique result_info.total_pages na resposta para determinar quando todas as páginas foram recuperadas. |
match | string | Não | Critério de correspondência quando múltiplos filtros são fornecidos: all ou any. |
order | string | Não | Campo para ordenar os resultados (ex.: priority, created_on). |
zone_id | string | Sim | UUID da zona para listar as regras de firewall. |
per_page | integer | Não | Número de itens por página (1–1000). |
direction | string | Não | Direção da ordenação: asc ou desc. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar monitores
Seção intitulada “Listar monitores”CLOUDFLARE_LIST_MONITORS
Lista todos os monitores de balanceamento de carga em uma conta Cloudflare. Use após criar ou atualizar monitores para recuperar uma lista paginada. A resposta inclui result_info.total_pages para determinar quando todas as páginas foram obtidas.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Número da página para resultados paginados (baseado em 1). |
order | string | Não | Campo para ordenar (ex.: created_on, description). |
per_page | integer | Não | Número de monitores por página (máx. 100). |
direction | string | Não | Direção da ordenação: asc ou desc. |
account_id | string | Sim | Identificador da conta Cloudflare. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar pools
Seção intitulada “Listar pools”CLOUDFLARE_LIST_POOLS
Lista todos os pools de balanceamento de carga em uma conta Cloudflare. Use após confirmar o ID da conta para descobrir os IDs dos pools. Pagine usando page e per_page; verifique result_info.total_pages na resposta para determinar se existem páginas adicionais.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
page | integer | Não | Número da página para paginação (baseado em 1). |
monitor | string | Não | Filtrar pools por ID do monitor. Retorna apenas pools que usam este monitor de verificação de saúde específico. |
per_page | integer | Não | Número de pools a retornar por página (1–50). Padrão: todos os pools. |
account_id | string | Sim | Identificador da conta Cloudflare (UUID). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar túneis
Seção intitulada “Listar túneis”CLOUDFLARE_LIST_TUNNELS
Lista os túneis Cloudflare Tunnel (cloudflared) em uma conta para descobrir IDs, nomes e status dos túneis. Use quando precisar encontrar um tunnel_id antes de realizar operações de túnel como roteamento, configuração DNS ou depuração.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Filtrar túneis por nome. |
page | integer | Não | Número da página para paginação, começando em 1. |
per_page | integer | Não | Número de túneis por página. |
account_id | string | Sim | Identificador da conta Cloudflare. |
is_deleted | boolean | Não | Filtrar por status de exclusão. true para incluir túneis excluídos, false para excluí-los. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar zonas
Seção intitulada “Listar zonas”CLOUDFLARE_LIST_ZONES
Lista, pesquisa, ordena e filtra zonas na conta autenticada. Use page/per_page para paginar; verifique result_info.total_pages na resposta para iterar todas as páginas. Não retorna registros DNS — extraia o zone_id dos resultados antes de passá-lo para ferramentas com escopo de zona (DNS, firewall, etc.). Somente zonas delegadas aos nameservers do Cloudflare aparecem.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Nome de domínio. Operadores de filtro opcionais podem ser fornecidos para estender e refinar a busca. |
page | integer | Não | Número da página dos resultados paginados. |
match | string | Não | Se deve corresponder a todos os critérios de busca (all) ou a pelo menos um (any). |
order | string | Não | Campo para ordenar as zonas: name, status, account.id, account.name ou plan.id. |
status | string | Não | Status da zona: initializing, pending, active ou moved. |
account | object | Não | Filtrar zonas por ID e/ou nome de conta. |
per_page | integer | Não | Número de zonas por página. |
direction | string | Não | Direção da ordenação: asc ou desc. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar registro DNS
Seção intitulada “Atualizar registro DNS”CLOUDFLARE_UPDATE_DNS_RECORD
Atualiza um registro DNS existente em uma zona específica. Use após confirmar os identificadores da zona e do registro; somente os campos fornecidos são modificados. Atualizações em registros usados por túneis ativos têm efeito imediato e podem interromper o tráfego em produção.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
ttl | integer | Não | Tempo de vida em segundos; use 1 para TTL automático. |
data | object | Não | Dados adicionais específicos do registro para registros LOC, SRV e CAA. |
name | string | Não | Nome do registro DNS (ex.: example.com). |
type | string | Não | Tipo do registro DNS (A, AAAA, CNAME, CERT, DNSKEY, DS, LOC, MX, NS, PTR, SPF, SRV, SSHFP, TLSA, TXT, URI). |
content | string | Não | Conteúdo do registro DNS (ex.: endereço IP para registros A). |
proxied | boolean | Não | Se o registro receberá os benefícios do Cloudflare. |
priority | integer | Não | Prioridade para registros MX, SRV e URI; obrigatório para esses tipos. |
identifier | string | Sim | Identificador do registro DNS (UUID) a atualizar. |
zone_identifier | string | Sim | Identificador da zona (UUID) do registro DNS a atualizar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar lista WAF
Seção intitulada “Atualizar lista WAF”CLOUDFLARE_UPDATE_LIST
Atualiza a descrição de uma lista WAF (não é possível atualizar os itens). Use após confirmar os metadados da lista.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
list_id | string | Sim | Identificador único da lista WAF. |
account_id | string | Sim | Identificador da conta Cloudflare. |
description | string | Sim | Nova descrição para a lista WAF. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar configuração do túnel
Seção intitulada “Atualizar configuração do túnel”CLOUDFLARE_UPDATE_TUNNEL_CONFIGURATION
Atualiza a configuração de um Cloudflare Tunnel gerenciado remotamente (regras de ingresso e roteamento). Use quando precisar configurar programaticamente mapeamentos hostname-para-origem para um túnel. ATENÇÃO: esta operação SUBSTITUI a configuração inteira — uma configuração incorreta pode quebrar o roteamento e tornar serviços inacessíveis. Boas práticas: busque a configuração atual primeiro (ao fazer patch) para preservar as regras existentes. Pelo menos uma regra de ingresso é obrigatória, e a última regra geralmente deve ser um catch-all (hostname='*' ou omitido) com service='http_status:404'.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
config | object | Sim | Objeto de configuração completo do túnel incluindo regras de ingresso. SUBSTITUI a configuração inteira — busque a configuração atual primeiro se precisar fazer patch em vez de substituição. |
tunnel_id | string | Sim | UUID do túnel a configurar. |
account_id | string | Sim | Identificador da conta Cloudflare onde o túnel reside. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar zona
Seção intitulada “Atualizar zona”CLOUDFLARE_UPDATE_ZONE
Atualiza propriedades de uma zona existente; as alterações se aplicam imediatamente à zona em produção. Confirme o ID da zona e a mudança pretendida antes de chamar. Apenas um campo pode ser modificado por chamada.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | string | Não | Tipo da zona: full, partial ou secondary. Apenas um de paused, type ou vanity_name_servers pode ser atualizado por chamada. |
paused | boolean | Não | Se a zona deve ser pausada (true para pausar, false para retomar). Apenas um de paused, type ou vanity_name_servers pode ser atualizado por chamada. |
zone_id | string | Sim | Identificador da zona (UUID). |
vanity_name_servers | array | Não | Nameservers customizados para modo vanity. Apenas um de paused, type ou vanity_name_servers pode ser atualizado por chamada. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |