> ## 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.

# Editar banco de dados

> Renomeie um banco de dados ou altere sua memória com PATCH /v2/databases/{database_id}, sem reiniciá-lo nem mudar as credenciais e a URL de conexão.

<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>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `databases:write`.

Atualiza o nome de exibição e/ou a memória alocada de um banco de dados sem recriar o container ou rotacionar suas credenciais; a URL de conexão e a porta permanecem as mesmas. Pelo menos um entre `name` ou `ram` precisa estar presente no corpo da requisição.

A alteração de `ram` é aplicada ao vivo no cluster do banco de dados; ela falha se o novo valor não for válido para o plano ou motor. Isso não reinicia o banco de dados. Para verificar se uma mudança de memória foi refletida, veja [Consultar Informações do Banco de Dados](/pt-br/api-reference/endpoint/databases/info) ou [Obter Status do Banco de Dados](/pt-br/api-reference/endpoint/databases/status). Limite de taxa de 1 atualização a cada 5 segundos por usuário.

## Parâmetros

<ParamField path="database_id" type="string" placeholder="ID do banco de dados" required>
  O ID do banco de dados.
</ParamField>

<ParamField body="name" type="string" placeholder="nome do banco de dados">
  O nome do banco de dados. De 1 a 32 caracteres, letras, números, underscores (`_`), hífens (`-`) e espaços, e deve incluir ao menos uma letra, número ou underscore.
</ParamField>

<ParamField body="ram" type="int" placeholder="RAM(em MB)">
  Quantidade de RAM a ser alocada, em megabytes. Mínimos: Redis 512 MB, MongoDB e PostgreSQL 1024 MB.
</ParamField>

## Resposta

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

<ResponseExample>
  ```json theme={"system"}
  {
    "status":"success"
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `NO_UPDATE_DATA` | 400 | Nem `name` nem `ram` foram fornecidos no corpo da requisição. |
| `INVALID_NAME` | 400 | O novo nome falha na validação de 1 a 32 caracteres. |
| `INVALID_MEMORY` | 400 | O novo valor de `ram` não é válido para o motor ou plano deste banco de dados. |
| `DATABASE_NOT_FOUND` | 404 | O banco de dados não existe ou não pertence a quem fez a chamada. |
| `INTERNAL_SERVER_ERROR` | 500 | Não foi possível aplicar a atualização de memória. |

## Relacionados

* CLI: [`squarecloud db update`](/pt-br/cli-reference/databases#squarecloud-db-update)
* SDKs: [`api.databases.update()`](/pt-br/sdks/js/databases) (JavaScript), [`client.databases.update()`](/pt-br/sdks/py/databases) (Python), [`c.Databases.Update()`](/pt-br/sdks/go/databases) (Go)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.