Pular para o conteúdo principal
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, { range }) retorna pontos de uso, do mais recente para o mais antigo. O padrão, range: "24h", cobre as últimas 24 horas, um ponto a cada 5 minutos (a cada 10 minutos para aplicações abaixo de 512 MB). range: "7d" retorna um ponto por hora nos últimos 7 dias, nos planos Pro e Enterprise para aplicações de 512 MB ou mais. Os outros planos e as aplicações menores recebem a resposta de 24 horas sem erro, então confira os pontos que você recebeu em vez do range que pediu. Um range desconhecido resulta em 400 INVALID_PARAMETERS.

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.