Skip to main content
Todos os métodos desta página ficam em api.apps e recebem o id da aplicação primeiro. Um appId também pode ser o id composto <appId>-<workspaceId> de uma aplicação compartilhada por meio de um workspace.
Para listar suas aplicações, use api.account.me(): seu array applications contém todas as aplicações que a chave pode ver.

Obtendo uma aplicação

Status

status(appId) retorna o estado ao vivo com valores formatados:
Passe { raw: true } para obter números (cpu em %, ram em MB, network.total e network.now como pares de bytes [in, out]):
uptime é um timestamp (quando a aplicação iniciou), não uma duração. Use Date.now() - status.uptime para saber há quanto tempo ela está no ar.

Status de todas as aplicações

statusAll() retorna um resumo por aplicação que a chave pode ver, em uma única requisição. cpu e ram só estão presentes enquanto a aplicação está rodando.

Iniciar, parar e reiniciar

O servidor mantém essas chamadas abertas até o container agir, então elas esperam pelo menos 120 s antes de expirar. Quando a plataforma recusa a ação, a chamada lança um SquareCloudAPIError com status 409, um code e uma mensagem vazia: “Já iniciada” e “já parada” também são erros. Se para você eles significam sucesso, trate-os:

Logs

logs(appId) retorna a saída mais recente do console como uma única string ("" quando não há nenhuma).
Para um stream de logs ao vivo, use Tempo real.

Métricas

metrics(appId) retorna as últimas 24 horas, um ponto a cada 5 minutos, do mais recente para o mais antigo.

Domínios e load balancers

domains() lista os hostnames padrão e personalizados de todas as aplicações. loadBalancers() lista os domínios compartilhados por várias aplicações, com o limite do seu plano.
Para configurar um domínio personalizado, veja Rede.

Excluindo uma aplicação

A exclusão é permanente. Crie um snapshot antes, caso você possa precisar dos arquivos novamente.

Próximos passos

Commit e upload

Crie uma aplicação a partir de um zip ou envie arquivos para uma existente.

Referência da API de aplicações

Os endpoints REST por trás destes métodos.

Aplicações pela CLI

As mesmas ações pelo terminal.