Skip to main content
Todos os métodos desta página ficam em client.apps e recebem o id da aplicação primeiro. Um app_id também pode ser o id composto <appId>-<workspaceId> de uma aplicação compartilhada por meio de um workspace.
Com o AsyncSquareCloud, todas as chamadas abaixo são iguais, com await na frente. Para listar suas aplicações, use client.account.me(): sua lista applications contém todas as aplicações que a chave pode ver.

Obtendo uma aplicação

Campos opcionais podem estar ausentes do dict: leia-os com app.get("domain").

Status

status(app_id) 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 time.time() * 1000 - status["uptime"] para saber há quanto tempo ela está no ar, em ms.

Status de todas as aplicações

status_all() 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(app_id) 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(app_id) 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. load_balancers() 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.