# Localizando as informações de conexão para uma instância de Amazon RDS banco de dados
<a name="CHAP_CommonTasks.Connect.EndpointAndPort"></a>

As informações de conexão de uma instância de banco de dados incluem seu endpoint, porta e um usuário de banco de dados válido, como o usuário mestre. Por exemplo, para uma instância de banco de dados MySQL, suponha que o valor do endpoint seja `mydb.123456789012.us-east-1.rds.amazonaws.com`. Nesse caso, o valor da porta é `3306`, e o usuário do banco de dados é `admin`. Com essas informações, você especifica os seguintes valores em uma string de conexão:
+ Para o host, nome de host ou nome DNS, especifique `mydb.123456789012.us-east-1.rds.amazonaws.com`.
+ Para a porta, especifique `3306`.
+ Para usuário, especifique `admin`.

O endpoint é exclusivo para cada instância de banco de dados e os valores da porta e do usuário podem variar. A seguinte lista mostra a porta mais comum para cada mecanismo de banco de dados:
+ Db2: 50000
+ MariaDB – 3306
+ Microsoft SQL Server – 1433
+ MySQL – 3306
+ Oracle – 1521
+ PostgreSQL – 5432

Para se conectar a uma instância de banco de dados, use qualquer cliente para um mecanismo de banco de dados. Por exemplo, você pode usar o utilitário mysql para se conectar a uma instância de banco de dados MariaDB ou MySQL. Você pode usar o Microsoft SQL Server Management Studio para se conectar a uma instância de banco de dados SQL Server. Você pode usar o Oracle SQL Developer para se conectar a uma instância de banco de dados Oracle. Da mesma forma, você pode usar uma instância local do utilitário de linha de comando psql para se conectar a uma instância de banco de dados do PostgreSQL.

Para encontrar as informações de conexão de uma instância de banco de dados, use o Console de gerenciamento da AWS Você também pode usar o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) da AWS Command Line Interface (AWS CLI) ou a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) da API do RDS. 

## Console
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.Console"></a>

**Para encontrar as informações de conexão de uma instância de banco de dados no Console de gerenciamento da AWS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, escolha **Bancos de dados** para exibir uma lista de suas instâncias de banco de dados.

1. Escolha o nome da instância de banco de dados para mostrar os detalhes.

1. Na guia **Connectivity & security (Conectividade e segurança)**, copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados.   
![\[O endpoint e a porta de uma instância de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/endpoint-port.png)

1. Se você precisar encontrar o nome de usuário mestre, escolha a guia **Configuração** e visualize o valor do nome de **usuário mestre** .

## AWS CLI
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.CLI"></a>

Para encontrar as informações de conexão de uma instância de banco de dados usando o AWS CLI, chame o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) . Na chamada, consulte o ID da instância de banco de dados, o endpoint, a porta e o nome de usuário mestre.

Para Linux, macOS ou Unix:

```
aws rds describe-db-instances \
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Para Windows:

```
aws rds describe-db-instances ^
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Sua saída deve ser similar à seguinte.

```
[
    [
        "mydb",
        "mydb.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ],
    [
        "myoracledb",
        "myoracledb.123456789012.us-east-1.rds.amazonaws.com",
        1521,
        "dbadmin"
    ],
    [
        "mypostgresqldb",
        "mypostgresqldb.123456789012.us-east-1.rds.amazonaws.com",
        5432,
        "postgresadmin"
    ]
]
```

## API do RDS
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.API"></a>

Para localizar as informações de conexão de uma instância de banco de dados usando a Amazon RDS API, chame a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) . Na saída, encontre os valores para o endereço do endpoint, a porta do endpoint e o nome do usuário mestre.