Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connessione a un cluster Amazon Neptune
<a name="get-started-connecting"></a>

Dopo aver creato un cluster Neptune, è necessario configurare l'accesso alla rete in modo che le applicazioni possano raggiungere l'endpoint del cluster. Le seguenti sezioni descrivono le opzioni di connettività di rete. Per ulteriori informazioni sull'interrogazione dei dati dopo la connessione, consulta[Accesso ai dati grafici](get-started-access-graph.md).

## Opzioni di connettività di rete
<a name="get-started-connect-ways"></a>

Un cluster di database Amazon Neptune può essere creato *solo* in un Amazon Virtual Private Cloud (Amazon VPC). I suoi endpoint sono accessibili solo all'interno di quel VPC a meno che non abiliti e configuri gli endpoint [pubblici Neptune](neptune-public-endpoints.md) per il cluster DB.

Puoi configurare l'accesso di rete al tuo cluster Neptune DB nel suo VPC in diversi modi:
+ [Connessione da un'istanza Amazon EC2 nello stesso VPC](get-started-connect-ec2-same-vpc.md)
+ [Connessione da un'istanza Amazon EC2 in un altro VPC](get-started-connect-ec2-other-vpc.md)
+ [Connessione da una rete privata](get-started-connect-private-net.md)
+ [Connessione da un endpoint pubblico](neptune-public-endpoints.md)

## Verifica la tua connessione
<a name="get-started-verify-connection"></a>

Dopo aver configurato l'accesso alla rete, puoi verificare che la connessione funzioni chiamando l'endpoint di stato dell'istanza. Una risposta corretta conferma che il client è in grado di raggiungere il cluster Neptune.

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

Esegui il comando seguente:

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

Per ulteriori informazioni, vedere [get-engine-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-engine-status.html) nel Command Reference. 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**  
Questo esempio presuppone che le AWS credenziali siano configurate nell'ambiente in uso. Sostituisci {{us-east-1}} con la regione del tuo cluster Neptune.

Per ulteriori informazioni sull'utilizzo **awscurl** con l'autenticazione IAM, consulta. [Utilizzo di `awscurl` con credenziali temporanee per connettersi in modo sicuro a un cluster DB con autenticazione IAM abilitata](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

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

Esegui il comando seguente:

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

**Nota**  
Questo comando funziona solo quando l'autenticazione IAM non è abilitata sul cluster. Se l'autenticazione IAM è abilitata, usa **awscurl** o AWS CLI invece.

------

Un cluster integro restituisce una risposta JSON che include`"status": "healthy"`. Esempio:

```
{
    "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 non riesci a raggiungere l'endpoint, verifica che la configurazione di rete consenta il traffico sulla porta 8182 (o sulla porta configurata) e che le regole del gruppo di sicurezza consentano le connessioni in entrata dal client. Per ulteriori informazioni, consulta [Garantire l'accesso a Neptune](get-started-security.md). Per assistenza nella configurazione degli SDK AWS CLI o, consulta. `curl` [Utilizzo di strumenti da riga di comando](get-started-cli-tools.md)