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

# Redefinir certificados do banco de dados

> Redefine os certificados de um banco de dados específico pelo seu ID.

**id** `string` *required*

O ID do banco de dados cujos certificados serão redefinidos.

### Resposta

**response** `object`

Os novos detalhes do certificado do banco de dados.

**Mostrar objeto**

**pem** `string`

O novo certificado PEM.

**crt** `string`

O novo certificado CRT.

**key** `string`

A nova chave privada do certificado.

**ca** `string`

O certificado da CA (PEM) que assina o certificado do servidor do banco de dados. Ausente em bancos de dados mais antigos.

**p12** `string`

A nova identidade do cliente em PKCS#12, codificada em base64, com senha vazia. Ausente em bancos de dados mais antigos.

**restart\_required** `boolean`

`true` quando pelo menos uma aplicação de uma stack conectada precisa reiniciar para ler os novos certificados.

**apps\_to\_restart** `string[]`

Os IDs dessas aplicações. Vazio quando `restart_required` é `false`.

```json Response theme={null}
{
  "response": {
    "pem": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----",
    "crt": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----",
    "key": "-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----",
    "ca": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----",
    "p12": "MIIJqQIBAzCCCW8GCSqGSIb3DQEHAaCCCWAEgglc...",
    "restart_required": false,
    "apps_to_restart": []
  }
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: O header `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: A chave de API é usada a partir de um IP fora da sua lista de IPs permitidos, ou não tem o escopo que a rota exige (`403`).
* `ACCESS_DENIED`: O recurso pertence a outra conta, ou você não tem a permissão de workspace para ele (`403`).
* `DATABASE_NOT_FOUND_OR_FORBIDDEN`: O banco de dados informado não existe ou o usuário não tem acesso.
* `FAILED_TO_RESET_CERTIFICATES`: Falha ao redefinir os certificados.

**message** `string`

Uma mensagem descritiva com detalhes adicionais sobre o erro.

```json Error Response (403) theme={null}
{
  "code": "ACCESS_DENIED"
}
```

```json Error Response (404) theme={null}
{
  "code": "DATABASE_NOT_FOUND_OR_FORBIDDEN"
}
```

```json Error Response (500) theme={null}
{
  "code": "FAILED_TO_RESET_CERTIFICATES"
}
```


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