Skip to main content
Os exemplos usam o cliente api de Criando o cliente. appId é o id de uma das suas aplicações: api.account.me() lista todas.

Entradas aceitas

apps.create() e apps.commit() aceitam: Em edge runtimes e no navegador, passe um Blob, File ou Uint8Array: um caminho só funciona onde node:fs existe. Os uploads são limitados a 100 MB. Um arquivo maior falha localmente com FILE_TOO_LARGE (status 0) antes que qualquer coisa seja enviada. Os uploads são transmitidos em stream e não têm timeout: passe um signal para cancelar um.

Criando uma aplicação

apps.create(file) faz o deploy de um .zip que contém um arquivo de configuração squarecloud.app na raiz.

Fazendo commit em uma aplicação

apps.commit(appId, file, { path, filename, signal }) envia um arquivo para uma aplicação existente:
  • Um .zip é descompactado em path (a raiz da aplicação por padrão).
  • Qualquer outro arquivo vai para path/<filename>.
O nome do arquivo é filename, senão o próprio nome do arquivo (caminho ou File), senão commit.zip.
Um commit não reinicia a aplicação. Chame apps.restart() para aplicá-lo.

Cancelando um upload

Um upload abortado rejeita com o reason do signal.

Erros

Um caminho local que não pode ser aberto lança o erro do sistema de arquivos, não um SquareCloudAPIError. Veja Erros para a lista completa.

Próximos passos

Gerenciando arquivos

Liste, leia, escreva, mova e exclua arquivos da aplicação.

Referência da API de upload

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

Upload pela CLI

As mesmas ações pelo terminal.