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

# Obter certificado TLS do banco de dados

> Obtenha o arquivo TLS de um banco de dados com GET /v2/databases/{database_id}/credentials/certificate: um PEM em base64 com a chave privada e o certificado.

<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:credentials`.

Retorna o arquivo TLS que o banco de dados usa para conexões criptografadas, codificado em base64. Depois de decodificado, é um PEM com a chave privada seguida do certificado, pronto para ser gravado em um arquivo `.pem`. Bancos de dados gerenciados MongoDB, MySQL e PostgreSQL possuem cada um seu próprio certificado; verifique as opções de TLS do seu driver para saber se ele precisa de um.

O banco de dados precisa estar em execução ao chamar este endpoint; se estiver parado, [inicie-o](/pt-br/api-reference/endpoint/databases/start) primeiro. Para rotacionar o certificado em vez de apenas lê-lo, use [Redefinir Credenciais](/pt-br/api-reference/endpoint/databases/credentials/reset) com `reset: "certificate"` e depois busque-o novamente aqui.

## Parâmetros

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

## Resposta

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

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

  <Expandable title="Alternar objeto">
    <ResponseField name="certificate" type="string">
      O PEM (chave privada seguida do certificado), codificado em base64.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success",
      "response": {
          "certificate": "CERTIFICATE_IN_BASE_64_FORMAT"
      }
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `DATABASE_NOT_RUNNING` | 400 | O banco de dados está parado; inicie-o antes de ler o certificado. |
| `READ_FAILED` | 400 | Não foi possível ler o arquivo de certificado no cluster. |
| `DATABASE_NOT_FOUND` | 404 | O banco de dados não existe ou não pertence a quem fez a chamada. |

## Relacionados

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


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