As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectar-se a um cluster do Amazon Neptune
<a name="get-started-connecting"></a>

Depois de criar um cluster Neptune, você deve configurar o acesso à rede para que seus aplicativos possam alcançar o endpoint do cluster. As seções a seguir descrevem as opções de conectividade de rede. Para obter mais informações sobre como consultar seus dados após a conexão, consulte[Acessar dados de grafo](get-started-access-graph.md).

## Opções de conectividade de rede
<a name="get-started-connect-ways"></a>

Um cluster de banco de dados do Amazon Neptune *só* pode ser criado em uma Amazon Virtual Private Cloud (Amazon VPC). Seus endpoints são acessíveis somente dentro dessa VPC, a menos que você habilite e configure endpoints públicos do [Neptune](neptune-public-endpoints.md) para o cluster de banco de dados.

Você pode configurar o acesso à rede ao seu cluster de banco de dados Neptune em sua VPC de várias maneiras:
+ [Conectar-se por uma instância do Amazon EC2 na mesma VPC](get-started-connect-ec2-same-vpc.md).
+ [Conectar-se por uma instância do Amazon EC2 na mesma VPC](get-started-connect-ec2-other-vpc.md).
+ [Conectar-se por uma rede privada](get-started-connect-private-net.md).
+ [Conectar-se por um endpoint público](neptune-public-endpoints.md)

## Verifique sua conexão
<a name="get-started-verify-connection"></a>

Depois de configurar o acesso à rede, você pode verificar se sua conexão funciona chamando o endpoint de status da instância. Uma resposta bem-sucedida confirma que seu cliente pode acessar o cluster Neptune.

------
#### [ AWS CLI ]

Execute este comando: .

```
aws neptunedata get-engine-status \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --region {{us-east-1}}
```

Para obter mais informações, consulte [get-engine-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-engine-status.html) na Referência de comandos. AWS CLI 

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=10, retries={'total_max_attempts': 1})
)

response = client.get_engine_status()

print(response)
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/status \
  --region {{us-east-1}} \
  --service neptune-db
```

**nota**  
Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. {{us-east-1}}Substitua pela região do seu cluster Neptune.

Para obter mais informações sobre como usar **awscurl** com a autenticação do IAM, consulte[Usando `awscurl` com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação IAM ativada](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).

------
#### [ curl ]

Execute este comando: .

```
curl -G https://{{your-neptune-endpoint}}:{{port}}/status
```

**nota**  
Esse comando funciona somente quando a autenticação do IAM não está habilitada no seu cluster. Se a autenticação do IAM estiver ativada, use **awscurl** ou AWS CLI em vez disso.

------

Um cluster íntegro retorna uma resposta JSON que inclui`"status": "healthy"`. Por exemplo:

```
{
    "status": "healthy",
    "startTime": "Thu Aug 24 21:07:13 UTC 2023",
    "dbEngineVersion": "{{1.3.1.0.R1}}",
    "role": "writer",
    "dfeQueryEngine": "viaQueryHint",
    "gremlin": { "version": "tinkerpop-{{3.7.2}}" },
    "sparql": { "version": "sparql-1.1" },
    "opencypher": { "version": "Neptune-9.0.20190305-1.0" },
    "labMode": { ... },
    "features": { ... },
    "settings": { ... }
}
```

Se você não conseguir acessar o endpoint, verifique se sua configuração de rede permite tráfego na porta 8182 (ou na porta configurada) e se as regras do grupo de segurança permitem conexões de entrada do seu cliente. Para obter mais informações, consulte [Proteger o acesso ao Neptune](get-started-security.md). Para obter ajuda na configuração do AWS CLI, SDKs ou`curl`, consulte[Usando ferramentas de linha de comando](get-started-cli-tools.md).