Skip to main content
PUT
Criar ou atualizar um arquivo da aplicação
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
Requer uma chave de API com o escopo files:write. Criar/modificar arquivo grava content em path dentro de uma aplicação em execução, criando o arquivo se ele não existir ou sobrescrevendo-o se existir. Para arquivos binários, envie content codificado em base64 junto com encoding: "base64", o formato recomendado. content também aceita uma string UTF-8 para arquivos de texto, um array simples de bytes ([104, 105]) ou um objeto { type: "Buffer", data: number[] }. Um content vazio ("" ou []) grava um arquivo vazio. Cada gravação aceita até 10 MB, medidos nos bytes decodificados. As gravações têm limite de 10 requisições a cada 5 segundos por usuário. Use-o para edições pequenas e pontuais, como ajustar um valor de configuração ou inserir um arquivo gerado, sem reenviar toda a aplicação; para alterações em massa ou um .zip, use Enviar commit da aplicação. Gravar em squarecloud.app ou squarecloud.config é tratado de forma especial: a plataforma interpreta o conteúdo como a configuração da aplicação (nome de exibição, descrição, memória, autorestart, subdomínio) e valida cada campo; um valor inválido retorna um código de erro específico (por exemplo, INVALID_MEMORY ou INVALID_SUBDOMAIN) em vez de gravar o arquivo. Essas regravações de configuração são limitadas a 1 requisição a cada 15 segundos por usuário. Em aplicações compartilhadas em workspace, quem chama precisa da função maintain ou admin, e membros sem a permissão de arquivos restritos ficam bloqueados de gravar em caminhos excluídos como .env. Assim como outras rotas do gerenciador de arquivos, isso não reinicia a aplicação; chame Reiniciar aplicação para aplicar alterações que exijam um processo novo.

Parâmetros

string
obrigatório
O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
string
obrigatório
O caminho onde o arquivo deve ser criado, com até 256 caracteres. Exemplo: /test.txt
string | number[]
obrigatório
O conteúdo do arquivo a ser criado: base64 quando encoding é base64; caso contrário, uma string UTF-8 ou um array de bytes.
string
Defina como base64 quando content for o arquivo codificado em base64. Recomendado para arquivos binários.

Resposta

string
Indica se a chamada foi bem-sucedida: success se foi, error se não.

Erros comuns

Relacionados