Pular para o conteúdo

DigitalOcean

DigitalOcean

DigitalOcean é um provedor de infraestrutura em nuvem que oferece plataformas de computação escaláveis com uma interface amigável. Com a integração DigitalOcean no SquadOS, seus agentes podem provisionar e gerenciar toda a sua infraestrutura cloud — criando droplets, clusters de banco de dados, balanceadores de carga, firewalls, domínios DNS, volumes de armazenamento e redes privadas (VPCs) — diretamente a partir de conversas.

Esta ferramenta utiliza chave de API (API_KEY) ou OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar dos seguintes campos (para conexão via chave de API):

CampoObrigatórioDescrição
api_keySimToken de acesso pessoal gerado no painel do DigitalOcean em API → Tokens.
  1. Acesse cloud.digitalocean.com e faça login na sua conta.
  2. No menu lateral, clique em API.
  3. Na aba Tokens, clique em Generate New Token.
  4. Dê um nome ao token (ex.: squados-agent), escolha o escopo Read & Write e clique em Generate Token.
  5. Copie o token exibido — ele não será mostrado novamente.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por DigitalOcean.
  3. Clique no card para abrir o modal de detalhes e em Conectar.
  4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima (ou autoriza via OAuth 2.0).
  5. 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.)

DIGITAL_OCEAN_CREATE_CUSTOM_IMAGE

Cria uma imagem personalizada no DigitalOcean importando uma imagem de disco de VM Linux a partir de uma URL publicamente acessível. Use esta ação para fazer upload de imagens de SO personalizadas (Ubuntu, Debian, CentOS, Fedora, etc.) que podem ser usadas posteriormente para criar Droplets. A imagem será processada de forma assíncrona e seu status pode ser monitorado pelo ID de imagem retornado.

NomeTipoObrigatórioDescrição
urlstringSimURL publicamente acessível (HTTP/HTTPS) apontando para uma imagem de disco de VM Linux. Formatos suportados: Raw (.img), qcow2, VHDX, VDI, VMDK. Pode ser comprimida com gzip ou bzip2.
namestringSimNome legível para a imagem personalizada (ex.: ‘ubuntu-20.04-webserver’).
tagsarrayNãoLista opcional de tags para organizar e categorizar a imagem.
regionstringSimSlug de região do DigitalOcean onde a imagem será armazenada inicialmente (ex.: ‘nyc1’, ‘nyc3’, ‘sfo2’, ‘sfo3’, ‘lon1’, ‘ams3’).
descriptionstringNãoDescrição detalhada opcional da finalidade, conteúdo ou configuração da imagem.
distributionstringSimNome da distribuição do sistema operacional. Opções válidas: ‘Ubuntu’, ‘Debian’, ‘CentOS’, ‘Fedora’, ‘Arch Linux’ ou ‘Unknown’.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_DATABASE_CLUSTER

Cria um novo cluster de banco de dados gerenciado no DigitalOcean. Provisiona um banco de dados com o engine especificado (PostgreSQL, MySQL, Valkey, MongoDB, Kafka ou OpenSearch), versão, região, tamanho e quantidade de nós. Retorna credenciais de conexão e detalhes do cluster. O cluster estará com status ‘creating’ inicialmente e levará alguns minutos para ficar totalmente operacional.

NomeTipoObrigatórioDescrição
namestringSimNome para o cluster de banco de dados.
sizestringSimSlug de tamanho para os nós do banco de dados. Exemplos: db-s-1vcpu-1gb, db-s-2vcpu-4gb, gd-2vcpu-8gb.
tagsarrayNãoTags a atribuir ao cluster.
enginestring (“pg” | “mysql” | “valkey” | “mongodb” | “kafka” | “opensearch”)SimTipo de engine do banco de dados: ‘pg’ (PostgreSQL), ‘mysql’ (MySQL), ‘valkey’ (compatível com Redis), ‘mongodb’ (MongoDB), ‘kafka’ (Apache Kafka), ‘opensearch’ (OpenSearch).
regionstringSimSlug de região onde o cluster será criado. Exemplos: nyc1, nyc3, sfo3, lon1, fra1, ams3, sgp1, tor1, blr1.
versionstringSimVersão do engine do banco de dados. Exemplos: ‘16’ para PostgreSQL, ‘8’ para MySQL/Valkey, ‘8.0’ para MongoDB, ‘3.8’ para Kafka, ‘2’ para OpenSearch.
db_namesarrayNãoNomes dos bancos de dados a criar no cluster.
sql_modestringNãoModo SQL para clusters MySQL.
num_nodesintegerSimNúmero de nós no cluster. Valores típicos: 1 (nó único), 2 (primário + standby), 3 (alta disponibilidade).
user_namesarrayNãoNomes de usuário a criar no cluster.
backup_restoreobjectNãoConfiguração para restaurar um cluster a partir de um backup.
eviction_policystringNãoPolítica de evicção para clusters Redis.
storage_size_gbintegerNãoTamanho de armazenamento adicional em GiB para o cluster.
maintenance_windowobjectNãoConfiguração da janela de manutenção para o cluster.
private_network_uuidstringNãoUUID da rede VPC para redes privadas.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_BLOCK_STORAGE_VOLUME

Cria um novo volume de armazenamento em bloco. Use quando precisar provisionar armazenamento persistente em bloco após confirmar que a região de destino suporta volumes. Exemplo: “Criar um volume ext4 de 100 GiB chamado ‘db-backup’ em nyc1.”

NomeTipoObrigatórioDescrição
namestringSimNome legível para o volume de armazenamento em bloco.
tagsarrayNãoLista de tags a aplicar ao volume.
regionstringSimIdentificador de slug da região onde o volume será criado (ex.: ‘nyc1’).
descriptionstringNãoDescrição textual livre do volume.
snapshot_idstringNãoIdentificador único de um snapshot para criar o volume a partir dele.
size_gigabytesintegerSimTamanho do volume de armazenamento em bloco em GiB (mínimo 1).
filesystem_typestringNãoTipo de sistema de arquivos a inicializar no volume (ex.: ‘ext4’).
filesystem_labelstringNãoRótulo a aplicar ao sistema de arquivos.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_DOMAIN

Cria um novo domínio no sistema de gerenciamento de DNS do DigitalOcean. Isso adiciona o domínio à sua conta e permite gerenciar seus registros DNS. Use esta ação quando precisar adicionar um domínio ao DNS do DigitalOcean para hospedagem e gerenciamento, configurar um novo domínio com um registro A inicial apontando para um endereço IP, ou transferir o gerenciamento de DNS de um domínio existente para o DigitalOcean.

NomeTipoObrigatórioDescrição
namestringSimNome do domínio a adicionar ao gerenciamento de DNS do DigitalOcean (ex.: ‘example.com’). Deve ser um domínio válido com TLD reconhecido, único na conta.
ip_addressstringNãoEndereço IPv4 opcional para criar um registro A inicial apontando o apex do domínio para este IP. Se não fornecido, o domínio será criado sem nenhum registro DNS.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_DOMAIN_RECORD

Cria um novo registro DNS para um domínio. Use após confirmar que o domínio existe e os detalhes do registro.

NomeTipoObrigatórioDescrição
tagstringNãoTag para registros CAA (issue, issuewild, iodef); obrigatório se o tipo for CAA.
ttlintegerNãoTempo de vida do registro em segundos.
datastringSimValor do registro DNS. O formato depende do tipo de registro. Para registros CAA com tags issue/issuewild, use FQDN com ponto final (ex.: ‘letsencrypt.org.’).
namestringNãoNome do host para o registro (ex.: ‘www’). Use ’@’ para o domínio raiz.
portintegerNãoPorta para registros SRV; obrigatório se o tipo for SRV.
typestring (“A” | “AAAA” | “CNAME” | “MX” | “TXT” | “NS” | “SRV” | “CAA”)SimTipo de registro DNS a criar.
flagsintegerNãoFlags para registros CAA; obrigatório se o tipo for CAA.
weightintegerNãoPeso para registros SRV; obrigatório se o tipo for SRV.
priorityintegerNãoPrioridade para registros MX e SRV; obrigatório se o tipo for MX ou SRV.
domain_namestringSimNome do domínio ao qual adicionar o registro, ex.: ‘example.com’.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_DROPLET

Cria um novo Droplet. Use quando precisar provisionar uma VM com nome, região, tamanho e imagem. O image, region e size devem ser mutuamente compatíveis — a região escolhida deve estar listada nas regiões disponíveis da imagem.

NomeTipoObrigatórioDescrição
ipv6booleanNãoSe o IPv6 está habilitado.
namestringSimNome legível para o Droplet.
sizestringSimSlug de tamanho para o Droplet.
tagsarrayNãoLista de tags a aplicar ao Droplet.
imagestringSimSlug ou ID de imagem a usar para o Droplet.
regionstringSimSlug de região onde o Droplet será criado.
backupsbooleanNãoSe os backups automáticos estão habilitados.
volumesarrayNãoIDs de volumes a anexar ao Droplet.
ssh_keysarrayNãoLista de IDs ou fingerprints de chaves SSH a incorporar.
vpc_uuidstringNãoUUID da VPC a atribuir ao Droplet.
user_datastringNãoScript de user data (cloud-init) para configurar o Droplet.
monitoringbooleanNãoSe o monitoramento está habilitado.
private_networkingbooleanNãoObsoleto: use ‘vpc_uuid’ em vez disso.
with_droplet_agentbooleanNãoSe o agente do Droplet para métricas deve ser instalado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_FIREWALL

Cria um novo firewall cloud com regras de entrada e saída personalizadas. Use esta ação para configurar regras de segurança de rede que controlam o tráfego de e para seus Droplets. Você pode especificar regras usando endereços IP (notação CIDR), IDs de Droplet, tags, UUIDs de Load Balancer ou IDs de cluster Kubernetes. Requer pelo menos uma regra de entrada e uma de saída. Suporta os protocolos tcp, udp e icmp.

NomeTipoObrigatórioDescrição
namestringSimNome do novo firewall.
tagsarrayNãoLista opcional de tags de Droplet para aplicar o firewall aos droplets correspondentes.
vpc_uuidstringNãoUUID de VPC opcional para limitar este firewall a uma VPC.
droplet_idsarrayNãoLista opcional de IDs de Droplet para aplicar o firewall.
inbound_rulesarraySimLista de regras de entrada; deve conter pelo menos uma.
outbound_rulesarraySimLista de regras de saída; deve conter pelo menos uma.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_KUBERNETES_CLUSTER

Cria um novo cluster Kubernetes do DigitalOcean (DOKS) com plano de controle gerenciado. Obrigatório: nome do cluster, slug de região, slug de versão do Kubernetes e pelo menos uma configuração de pool de nós. Opcional: tags, configurações de auto-upgrade, política de manutenção, labels/taints de nós e auto-scaling. O cluster será criado com status ‘provisioning’ e pode levar alguns minutos para ficar ‘running’.

NomeTipoObrigatórioDescrição
namestringSimNome legível para o cluster Kubernetes.
tagsarrayNãoLista de tags a aplicar ao cluster.
regionstringSimSlug de região onde o cluster será criado. Regiões comuns: nyc1, nyc3, sfo3, lon1, fra1, tor1, blr1, sgp1, ams3, syd1.
versionstringSimSlug de versão do Kubernetes a implantar (ex.: ‘1.34.1-do.3’, ‘1.33.6-do.3’). Use /v2/kubernetes/options para obter as versões disponíveis atuais.
node_poolsarraySimLista de pools de nós; pelo menos um é obrigatório.
auto_upgradebooleanNãoSe deve fazer upgrade automático para novas versões de patch.
maintenance_policyobjectNãoPolítica de manutenção agendada para o cluster.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_LOAD_BALANCER

Cria um novo balanceador de carga. Use após especificar região, regras de encaminhamento e alvos.

NomeTipoObrigatórioDescrição
tagstringNãoTag para selecionar droplets (mutuamente exclusivo com droplet_ids).
namestringSimNome único para o novo balanceador de carga.
regionstringSimSlug de região onde o balanceador de carga será criado (ex.: ‘nyc1’).
vpc_uuidstringNãoUUID da VPC a atribuir ao balanceador de carga.
algorithmstring (“round_robin” | “least_connections”)NãoAlgoritmo de balanceamento de carga; padrão ‘round_robin’.
droplet_idsarrayNãoLista de IDs de droplet a anexar (mutuamente exclusivo com tag).
health_checkobjectNãoConfiguração opcional de verificação de saúde.
firewall_policystringNãoID de uma política de firewall personalizada a aplicar.
sticky_sessionsobjectNãoConfiguração opcional de persistência de sessão.
forwarding_rulesarraySimLista de regras de encaminhamento mapeando protocolos e portas de entrada para saída.
enable_proxy_protocolbooleanNãoHabilitar protocolo PROXY para conexões de backend.
redirect_http_to_httpsbooleanNãoRedirecionar tráfego HTTP para HTTPS.
enable_backend_keepalivebooleanNãoHabilitar conexões keepalive para droplets de backend.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_SSH_KEY

Registra uma nova chave pública SSH na sua conta do DigitalOcean. A chave registrada pode ser adicionada automaticamente a novos Droplets durante a criação, habilitando acesso SSH seguro. A chave deve ser fornecida no formato OpenSSH (ssh-rsa, ssh-ed25519, etc.) e não deve já existir na conta.

NomeTipoObrigatórioDescrição
namestringSimNome legível para identificar a chave SSH (ex.: ‘laptop-key’, ‘production-server’).
public_keystringSimString completa da chave pública SSH no formato OpenSSH. Deve começar com o tipo de chave (ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, etc.) seguido pelos dados de chave codificados em base64 e um comentário opcional.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_TAG

Cria uma nova tag no DigitalOcean para organizar e agrupar recursos. As tags podem ser aplicadas a droplets, imagens, volumes, snapshots de volume e bancos de dados. Se uma tag com o mesmo nome já existir, a API retorna a tag existente (operação idempotente). Nomes de tag devem ter 1–255 caracteres contendo apenas letras, números, hifens ou sublinhados.

NomeTipoObrigatórioDescrição
namestringSimNome da nova tag. Deve ter 1–255 caracteres e conter apenas caracteres alfanuméricos, hifens (-) ou sublinhados (_).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_CREATE_NEW_VPC

Cria uma nova Rede Privada Virtual (VPC) em uma região especificada do DigitalOcean. VPCs são redes privadas para isolar seus recursos. O tráfego dentro de uma VPC é gratuito e não conta para os limites de banda. A primeira VPC criada em uma região se torna automaticamente a VPC padrão dessa região.

NomeTipoObrigatórioDescrição
namestringSimNome da VPC. Deve ser único na sua conta.
tagsarrayNãoLista de nomes de tags a aplicar à VPC após a criação.
regionstringSimIdentificador de slug da região onde a VPC será criada. Regiões comuns incluem nyc3 (Nova York), sfo3 (San Francisco), lon1 (Londres), fra1 (Frankfurt), sgp1 (Singapura), tor1 (Toronto).
ip_rangestringNãoFaixa de IP em notação CIDR para a VPC. O tamanho da rede deve estar entre /16 e /28. Se não especificado, o DigitalOcean atribui uma faixa padrão automaticamente. Não deve sobrepor faixas de IP de VPC existentes na sua conta.
descriptionstringNãoDescrição textual livre da VPC.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_BLOCK_STORAGE_VOLUME

Exclui permanentemente um volume de armazenamento em bloco pelo seu ID único. Use quando precisar remover um volume existente. O volume não deve estar anexado a nenhum Droplet antes da exclusão. Esta operação não pode ser desfeita. Retorna HTTP 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
volume_idstringSimIdentificador único (UUID) do volume de armazenamento em bloco a excluir. O volume não deve estar anexado a nenhum Droplet.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_DATABASE_CLUSTER

Exclui um cluster de banco de dados pelo UUID. Use quando confirmar que o cluster não é mais necessário. Retorna HTTP 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
database_cluster_uuidstringSimUUID do cluster de banco de dados a destruir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_DOMAIN

Exclui um domínio do DNS do DigitalOcean. Esta ação é permanente e não pode ser desfeita. Nota: se o domínio estiver associado a um certificado Let’s Encrypt, exclua o certificado primeiro e reconfigure quaisquer recursos que o utilizem. Retorna 204 No Content em caso de exclusão bem-sucedida.

NomeTipoObrigatórioDescrição
namestringSimNome de domínio totalmente qualificado a excluir, ex.: ‘example.com’.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_DOMAIN_RECORD

Exclui um registro DNS pelo seu ID de registro para um domínio. Use quando precisar remover um registro DNS existente e tiver o nome do domínio e o ID do registro. Retorna HTTP 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
namestringSimNome do domínio (ex.: ‘example.com’).
record_idintegerSimIdentificador único do registro DNS a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_EXISTING_DROPLET

Exclui um Droplet pelo ID. A exclusão é irreversível — todos os dados são perdidos permanentemente. Confirme o droplet_id com o usuário e verifique se existe um backup ou snapshot antes de prosseguir.

NomeTipoObrigatórioDescrição
droplet_idintegerSimIdentificador único do Droplet a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_FIREWALL

Exclui um firewall pelo ID. Use quando confirmar que o firewall não é mais necessário.

NomeTipoObrigatórioDescrição
firewall_idstringSimIdentificador único do firewall a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_IMAGE

Exclui uma imagem personalizada criada pelo usuário ou snapshot da sua conta do DigitalOcean pelo seu ID numérico. Esta ação remove permanentemente a imagem e não pode ser desfeita. Apenas imagens personalizadas e snapshots de sua propriedade podem ser excluídos — tentar excluir imagens de distribuição ou aplicações de marketplace falhará com erro 403 Forbidden.

NomeTipoObrigatórioDescrição
image_idintegerSimID numérico único da imagem personalizada ou snapshot a excluir. Nota: apenas imagens personalizadas criadas pelo usuário e snapshots podem ser excluídos.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_LOAD_BALANCER

Exclui uma instância de balanceador de carga pelo ID. Use quando precisar remover permanentemente um balanceador de carga existente após confirmar seu ID. Retorna 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
load_balancer_idstringSimIdentificador único do balanceador de carga a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_SSH_KEY

Exclui uma chave SSH pública. Use quando precisar remover uma chave SSH da sua conta pelo seu ID ou fingerprint após confirmar sua propriedade. Retorna 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
key_id_or_fingerprintstringSimIdentificador da chave SSH (ID numérico ou fingerprint).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_TAG

Exclui uma tag da sua conta do DigitalOcean. Quando uma tag é excluída, ela é automaticamente removida de todos os recursos que possuíam essa tag. Esta operação é idempotente — excluir uma tag inexistente também retornará sucesso (204 No Content).

NomeTipoObrigatórioDescrição
namestringSimNome da tag a excluir; todos os recursos com esta tag serão destagueados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_DELETE_VPC

Exclui uma VPC (Rede Privada Virtual) pelo seu identificador único. Use quando precisar remover permanentemente uma VPC da sua conta do DigitalOcean. A exclusão é irreversível. Restrições importantes: não é possível excluir uma VPC que seja a VPC padrão da sua região, nem uma VPC que possua recursos membros (droplets, bancos de dados, balanceadores de carga, etc.) — todos os recursos devem ser desvinculados ou migrados primeiro.

NomeTipoObrigatórioDescrição
vpc_idstringSimIdentificador único da VPC a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_DATABASES

Lista todos os clusters de banco de dados gerenciados na sua conta. Suporta paginação e filtragem por tag. Uma única requisição retorna apenas uma página; itere usando page e per_page para recuperar todos os clusters.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1).
per_pageintegerNãoNúmero de itens a retornar por página. Deve estar entre 1 e 200.
tag_namestringNãoFiltrar para retornar apenas clusters de banco de dados com este nome de tag.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_DOMAINS

Lista todos os domínios DNS configurados na sua conta do DigitalOcean. Retorna nomes de domínio, valores de TTL e arquivos de zona DNS completos. Suporta paginação para grandes listas de domínios. Use esta ação para descobrir domínios disponíveis, verificar configurações de domínio, ou como pré-requisito para operações específicas de domínio. Sem parâmetros, retorna os primeiros 20 domínios (tamanho de página padrão).

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1).
per_pageintegerNãoNúmero de domínios a retornar por página (1–200). Padrão é 20 se omitido.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_DROPLETS

Lista todos os Droplets (máquinas virtuais) na sua conta do DigitalOcean com suporte a paginação. Retorna informações detalhadas incluindo: ID, nome, especificações (memória, vCPUs, disco), status, rede (endereços IP), região, imagem, tamanho, tags e VPC. Suporta filtragem por tag. O tamanho de página padrão é 20; contas com mais droplets requerem paginação explícita (incrementar page, até per_page=200) para evitar resultados incompletos.

NomeTipoObrigatórioDescrição
pageintegerNãoPágina de resultados a retornar. Deve ser maior ou igual a 1. Padrão é 1.
per_pageintegerNãoNúmero de itens por página. Deve estar entre 1 e 200. Padrão é 20.
tag_namestringNãoFiltrar droplets pelo nome da tag.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_FIREWALLS

Lista todos os firewalls cloud configurados na sua conta do DigitalOcean. Retorna detalhes abrangentes do firewall incluindo regras de entrada/saída, droplets associados, tags e status. Suporta paginação para contas com muitos firewalls. Use para auditar a segurança de rede, descobrir configurações de firewall existentes ou recuperar IDs de firewall para operações subsequentes.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1).
per_pageintegerNãoNúmero de firewalls a retornar por página (1–200).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_IMAGES

Lista todas as imagens disponíveis na sua conta. Use após obter um token de API válido para recuperar imagens opcionalmente filtradas por tipo, visibilidade privada ou tag_name.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a retornar. Padrão: 1. Mínimo: 1.
typestring (“distribution” | “application” | “private”)NãoFiltrar imagens por tipo. Valores válidos: ‘distribution’, ‘application’, ‘private’.
privatebooleanNãoSe verdadeiro, retorna apenas imagens privadas. Padrão falso.
per_pageintegerNãoNúmero de resultados por página. Padrão: 20. Intervalo: 1–200.
tag_namestringNãoRetornar apenas imagens tagueadas com esta tag.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_KUBERNETES_CLUSTERS

Lista todos os clusters Kubernetes da sua conta. Use quando precisar enumerar cada cluster e lidar com paginação.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página dos resultados paginados (a partir de 1).
per_pageintegerNãoNúmero de clusters por página. Deve estar entre 1 e 200.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_LOAD_BALANCERS

Lista todos os balanceadores de carga na sua conta do DigitalOcean com suporte a paginação. Retorna detalhes incluindo IDs, nomes, endereços IP, regras de encaminhamento, verificações de saúde, sessões sticky, Droplets atribuídos e informações de região.

NomeTipoObrigatórioDescrição
pageintegerNãoPágina de resultados a retornar. Deve ser maior ou igual a 1. Padrão é 1.
per_pageintegerNãoNúmero de itens por página. Deve estar entre 1 e 200. Padrão é 20.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_SNAPSHOTS

Lista todos os snapshots disponíveis na sua conta do DigitalOcean. Use quando precisar buscar e opcionalmente filtrar snapshots por tipo de recurso (droplet ou volume) e lidar com paginação para fluxos de inventário ou backup.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1).
per_pageintegerNãoNúmero de snapshots a retornar por página (1–200).
resource_typestring (“droplet” | “volume”)NãoFiltrar snapshots por tipo de recurso; ‘droplet’ ou ‘volume’.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_SSH_KEYS

Lista todas as chaves SSH associadas à sua conta do DigitalOcean. Retorna detalhes incluindo ID, nome, conteúdo da chave pública e fingerprint. Suporta paginação para contas com muitas chaves SSH. Use quando precisar visualizar chaves SSH disponíveis ou recuperar um ID de chave SSH para uso com outras operações como criação de droplets.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1). Use com per_page para navegar por resultados paginados.
per_pageintegerNãoNúmero de chaves SSH a retornar por página (1–200). Use 200 para recuperar o máximo de resultados por requisição.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_TAGS

Lista todas as tags da sua conta. Use quando precisar recuperar as tags disponíveis e informações de paginação. Uma única requisição retorna apenas uma página; itere usando page e per_page para recuperar todas as tags.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (a partir de 1).
per_pageintegerNãoNúmero de itens retornados por página. Deve estar entre 1 e 200.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_VOLUMES

Lista todos os volumes de armazenamento em bloco disponíveis na sua conta. Use quando precisar recuperar volumes e opcionalmente filtrar por nome e região.

NomeTipoObrigatórioDescrição
namestringNãoFiltrar para retornar apenas volumes com este nome exato.
pageintegerNãoNúmero da página a recuperar (a partir de 1).
regionstringNãoFiltrar para retornar apenas volumes nesta região (slug de região).
per_pageintegerNãoNúmero de itens retornados por página. Deve estar entre 1 e 200.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_ALL_VPCS

Lista todas as VPCs da sua conta. Use quando precisar de um inventário dos seus recursos de VPC. Uma única requisição retorna apenas uma página; itere por todas as páginas usando page e per_page (máx. 200) para recuperar o conjunto completo.

NomeTipoObrigatórioDescrição
pageintegerNãoNúmero da página a recuperar (padrão: 1).
per_pageintegerNãoNúmero de VPCs a retornar por página (padrão: 20, máx.: 200).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_APPS

Lista todos os apps da Plataforma App do DigitalOcean na sua conta. Use quando precisar descobrir IDs de app por nome, recuperar metadados de app ou enumerar todos os apps com suporte a paginação.

NomeTipoObrigatórioDescrição
pageintegerNãoQual página de resultados paginados retornar. Deve ser maior ou igual a 1. Padrão é 1.
per_pageintegerNãoNúmero de itens retornados por página. Deve estar entre 1 e 200. Padrão é 20.
with_projectsbooleanNãoSe o project_id dos apps listados deve ser buscado e incluído na resposta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_DATABASE_OPTIONS

Lista todas as opções de configuração disponíveis para clusters de banco de dados gerenciados do DigitalOcean, incluindo engines suportados (PostgreSQL, MySQL, MongoDB, Valkey, Kafka, OpenSearch), versões, regiões e tamanhos/layouts de cluster. Use para descobrir valores de parâmetros válidos ao criar um novo cluster de banco de dados.

NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_LIST_DOMAIN_RECORDS

Lista todos os registros DNS para um domínio. Use quando precisar inspecionar ou filtrar a configuração de DNS de um domínio.

NomeTipoObrigatórioDescrição
pageintegerNãoPágina de resultados a retornar (maior ou igual a 1).
typestring (“A” | “AAAA” | “CNAME” | “MX” | “NS” | “TXT” | “SRV” | “LOC” | “CAA”)NãoFiltrar registros por tipo de registro DNS.
per_pageintegerNãoNúmero de resultados por página (1–200).
domain_namestringSimNome do domínio cujos registros serão listados (ex.: ‘example.com’).
record_namestringNãoFiltrar registros pelo nome do registro (ex.: ‘www’, ’@’ para o domínio raiz).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_DOMAIN

Recupera detalhes completos sobre um domínio específico incluindo seu TTL e configuração do arquivo de zona DNS. Use quando precisar verificar configurações de domínio, confirmar a configuração DNS ou obter o conteúdo completo do arquivo de zona para um domínio na sua conta do DigitalOcean.

NomeTipoObrigatórioDescrição
namestringSimO nome de domínio totalmente qualificado (ex.: ‘example.com’).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_DOMAIN_RECORD

Recupera um registro DNS específico para um domínio pelo seu ID de registro. Use quando tiver o nome do domínio e o ID do registro para buscar os detalhes do registro.

NomeTipoObrigatórioDescrição
namestringSimNome do domínio (ex.: ‘example.com’).
record_idintegerSimIdentificador único do registro DNS.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_EXISTING_DROPLET

Recupera informações detalhadas sobre um Droplet específico do DigitalOcean pelo seu ID numérico único. Retorna detalhes abrangentes incluindo: status atual, especificações (memória, CPU, disco), configuração de rede (endereços IPv4/IPv6), informações de imagem, região, VPC, configurações de backup, volumes anexados e tags.

NomeTipoObrigatórioDescrição
droplet_idintegerSimIdentificador numérico único do Droplet sobre o qual você deseja recuperar informações. Você pode obter IDs de droplet a partir da ação Listar todos os Droplets.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_EXISTING_IMAGE

Recupera informações sobre uma imagem pelo ID ou slug. Use quando precisar de metadados detalhados para uma imagem conhecida.

NomeTipoObrigatórioDescrição
image_idstringSimID numérico único ou slug da imagem a recuperar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_TAG

Recupera uma tag individual pelo nome. Use quando precisar inspecionar os recursos agrupados sob uma tag específica.

NomeTipoObrigatórioDescrição
namestringSimNome da tag a recuperar (diferencia maiúsculas de minúsculas).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_RETRIEVE_VPC

Recupera detalhes sobre uma VPC específica pelo seu ID. Use quando precisar inspecionar as propriedades da VPC para configuração ou auditoria.

NomeTipoObrigatórioDescrição
vpc_uuidstringSimIdentificador único da VPC.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_TAG_RESOURCE

Tagueia recursos pelo nome. Use quando precisar atribuir uma tag existente a um ou mais recursos. Retorna 204 No Content em caso de sucesso.

NomeTipoObrigatórioDescrição
tag_namestringSimNome da tag à qual os recursos serão atribuídos.
resourcesarraySimLista de recursos a atribuir a tag (cada um com id e type).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_UNTAG_RESOURCE

Remove a tag de recursos pelo nome da tag. Use quando precisar remover uma tag existente de múltiplos recursos em uma única operação.

NomeTipoObrigatórioDescrição
tag_namestringSimNome da tag a remover dos recursos especificados.
resourcesarraySimLista de objetos de recurso para remover a tag, cada um com id, type e região opcional.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_UPDATE_DOMAIN_RECORD

Atualiza um registro DNS existente para um domínio. Use quando precisar modificar qualquer atributo válido de um registro após confirmar seu ID de registro.

NomeTipoObrigatórioDescrição
tagstringNãoTag para registros CAA.
ttlintegerNãoTempo de vida do registro em segundos.
datastringNãoValor do registro DNS (ex.: endereço IP para registro A/AAAA).
namestringNãoNome do host para o registro (ex.: ‘www’, ’@’).
portintegerNãoPorta para registros SRV.
typestringNãoTipo de registro DNS (ex.: ‘A’, ‘CNAME’, ‘TXT’, ‘MX’, ‘SRV’, ‘CAA’).
flagsintegerNãoFlags para registros CAA.
weightintegerNãoPeso para registros SRV.
priorityintegerNãoPrioridade para registros MX.
record_idintegerSimIdentificador único do registro DNS.
domain_namestringSimNome do domínio (ex.: ‘example.com’).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

DIGITAL_OCEAN_UPDATE_VPC

Atualiza informações sobre uma VPC. Use quando precisar modificar o nome, a descrição ou o status padrão de uma VPC existente.

NomeTipoObrigatórioDescrição
namestringNãoNovo nome para a VPC.
vpc_idstringSimIdentificador único da VPC a atualizar.
defaultbooleanNãoSe esta VPC deve ser definida como padrão para sua região.
descriptionstringNãoDescrição textual livre para a VPC.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.