> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar banco de dados

> Criar uma instância de banco de dados hospedada na Square Cloud.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

### Parâmetros

<ParamField body="name" type="string" placeholder="nome do banco de dados" required>
  O nome do banco de dados. Deve conter apenas \[a-z] \[A-Z] \[0-9].
</ParamField>

<ParamField body="memory" type="int" placeholder="RAM(em MB)" required>
  A RAM alocada para ele. Mínimo para Redis é 512 e para Mongo é 1024.
</ParamField>

<ParamField body="type" type="string" placeholder="banco(mongo,redis)" required>
  O tipo de banco de dados: postgres, mysql, mongo, redis.
</ParamField>

<ParamField body="version" type="string" placeholder="Número da versão" required>
  A versão do banco de dados.\
  Postgres 17.6, MySQL 9.5, Mongo 8.0.11, Redis 7.4.5.
</ParamField>

### Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="id" type="string">
      O ID do banco de dados.
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome que você escolheu para o banco de dados
    </ResponseField>

    <ResponseField name="memory" type="int">
      A memória alocada para o banco de dados
    </ResponseField>

    <ResponseField name="cpu" type="int">
      O número de vCPUs alocados para o banco de dados
    </ResponseField>

    <ResponseField name="type" type="string">
      O tipo do banco de dados.
    </ResponseField>

    <ResponseField name="password" type="string">
      A senha do banco de dados.
    </ResponseField>

    <ResponseField name="certificate" type="string">
      O certificado necessário para conectar-se a ele. Você pode salvá-lo em um arquivo `.pem`.
    </ResponseField>

    <ResponseField name="connection_url" type="string">
      A URL para conectar-se ao banco de dados.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status":"success",
    "response": {
      "id": "a14b8d5e1cb7405a851eb4c075506121",
      "name": "test",
      "memory": 1024,
      "cpu": 2,
      "type": "mongo",
      "password": "PASSWORD",
      "certificate": "CERTIFICATE_IN_BASE_64_FORMAT",
      "connection_url": "mongodb://default:PASSWORD@square-cloud-db-ID.squareweb.app:PORT"
      }
  }
  ```
</ResponseExample>