Pular para o conteúdo principal
POST
Criar banco de dados
O body é JSON, não multipart — diferente de POST /v1/apps. Por padrão, o banco de dados é criado vazio; para criá-lo a partir de um snapshot existente, envie snapshot_id.
string
obrigatório
O nome de exibição do banco de dados. Máximo de 50 caracteres.
string
A descrição do banco de dados. Máximo de 128 caracteres.
integer
O motor do banco de dados: 1 (PostgreSQL), 2 (MongoDB), 3 (Redis) ou 4 (MySQL).Obrigatório quando snapshot_id é omitido. Quando snapshot_id está presente, este campo é opcional; o motor vem do resource_type do snapshot. Se informado, precisa coincidir ou a criação falha com SNAPSHOT_TYPE_MISMATCH.
string
A versão major do motor, por exemplo "18" ou "8.4". O padrão é a versão recomendada do motor. Os valores válidos por motor são retornados por Listar versões de banco de dados. Um valor fora dessa lista falha com INVALID_DATABASE_VERSION. Com snapshot_id, o banco de dados nasce na versão major do snapshot; version pode ser igual ou mais nova, e uma mais antiga falha com SNAPSHOT_VERSION_NEWER.
integer
obrigatório
A quantidade de RAM a alocar para o banco de dados, em MB. Mínimo de 1.024 MB (512 MB para Redis, type: 3). O armazenamento provisionado é de 6 GB + 1 GB a cada 512 MB de RAM (arredondado para cima em GB inteiros), ou ram × 3 se esse valor for maior (por exemplo, 1.024 MB → 8 GB; 2.048 MB → 10 GB; 4.096 MB → 14 GB).
string
O ID do workspace a associar ao banco de dados, se aplicável.
string
Cria o banco de dados a partir de um snapshot de banco de dados existente. O motor vem do resource_type do snapshot, e o volume dele é restaurado após o provisionamento. Se a restauração falhar depois que o banco de dados for criado, o novo banco é excluído, em vez de deixar um banco vazio que poderia ser confundido com a cópia restaurada.

Resposta

object
Detalhes do banco de dados criado.

Respostas de erro

string
O código de erro que indica o motivo da falha. Valores possíveis:
  • VALIDATION_ERROR: O body falhou na validação (400), incluindo um type ausente quando snapshot_id é omitido.
  • USER_NOT_FOUND: A requisição não está autenticada (401).
  • PLAN_REQUIRED: O dono não tem um plano ativo, então um novo banco de dados não pode ser criado (403).
  • MAX_DATABASES_REACHED: O limite de bancos de dados do plano foi atingido (403).
  • INVALID_RAM_LIMIT: ram está abaixo do mínimo para este tipo de banco de dados — 1.024 MB, ou 512 MB para Redis (400).
  • USER_LIMITS_NOT_FOUND: Não foi possível carregar os limites do dono (404).
  • MEMORY_LIMIT_EXCEEDED: A RAM solicitada excede a memória restante no plano (400).
  • SNAPSHOT_NOT_FOUND: O snapshot_id não existe ou não pertence a quem fez a chamada (404).
  • SNAPSHOT_TYPE_MISMATCH: O snapshot é de uma aplicação, e não de um banco de dados, ou o type informado não coincide com o motor dele (400).
  • INVALID_DATABASE_VERSION: version não está disponível para este motor (400).
  • SNAPSHOT_VERSION_NEWER: version é mais antiga que a versão major do snapshot (400).
  • SNAPSHOT_TOO_LARGE: O snapshot excede o mesmo limite de tamanho da criação de banco de dados (400).
  • DB_CREATION_FAILED: A plataforma não conseguiu provisionar o banco de dados (500).
  • DATABASE_PERSISTENCE_FAILED: O banco de dados foi criado, mas não pôde ser lido de volta (500).
  • INTERNAL_SERVER_ERROR: Ocorreu uma falha inesperada (500).
string
Uma mensagem descritiva com detalhes adicionais do erro. Presente em VALIDATION_ERROR e INVALID_RAM_LIMIT.
Última modificação em 28 de outubro de 2026