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à.
# Comprendere gli endpoint di Amazon DocumentDB
Puoi usare gli endpoint Amazon DocumentDB (con compatibilità con MongoDB) per connetterti a un cluster o a un'istanza. Amazon DocumentDB ha tre diversi tipi di endpoint, ciascuno con un proprio scopo.
**Topics**
+ [Individuazione degli endpoint di un cluster](db-cluster-endpoints-find.md)
+ [Individuazione dell'endpoint di un'istanza](db-instance-endpoint-find.md)
+ [Connessione agli endpoint](endpoints-connecting.md)
**Endpoint del cluster**
Un endpoint del cluster è un endpoint per un cluster Amazon DocumentDB che si connette all'istanza primaria corrente del cluster. Ogni cluster Amazon DocumentDB ha un singolo endpoint del cluster e un'istanza principale. Nel caso di un failover, l'endpoint del cluster viene rimappato alla nuova istanza primaria.
**Endpoint di lettura**
Un endpoint reader è un endpoint per un cluster Amazon DocumentDB che si connette a una delle repliche disponibili per quel cluster. Ogni cluster Amazon DocumentDB dispone di un endpoint di lettura. Se è presente più di una replica, l'endpoint del lettore indirizza ogni richiesta di connessione a una delle repliche di Amazon DocumentDB.
**Endpoint dell'istanza**
Per endpoint dell'istanza si intende un endpoint che si connette a un'istanza specifica. Ogni istanza in un cluster, a prescindere che sia primaria o di replica, ha un proprio endpoint dell'istanza esclusivo. Si consiglia di non utilizzare gli endpoint dell'istanza nell'applicazione. Questo perché possono variare ruoli in caso di un failover, richiedendo in tal modo modifiche del codice nell'applicazione.
# Individuazione degli endpoint di un cluster
Puoi trovare l'endpoint del cluster e l'endpoint reader di un cluster utilizzando la console Amazon DocumentDB o. AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Per trovare gli endpoint di un cluster utilizzando la console:**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Clusters (Cluster)**.
1. Dall'elenco dei cluster scegli il nome del cluster desiderato.
1. **Nella pagina dei dettagli del cluster, seleziona la scheda Configurazione.** Nella sezione **Configurazioni e stato**, troverai l'endpoint **Cluster e l'endpoint** **Reader**.
![\[Sezione Configurazioni e stato che mostra gli endpoint del cluster e del lettore.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. Per connetterti a questo cluster, seleziona la scheda **Connettività e sicurezza**. Individua la stringa di connessione per la `mongo` shell e la stringa di connessione che può essere utilizzata nel codice dell'applicazione per connettersi al cluster.
![\[Sezione Connect che mostra una stringa per connettersi all'istanza con la shell mongo e una stringa per connettersi al cluster con un'applicazione.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
Per trovare gli endpoint del cluster e del lettore per il tuo cluster utilizzando AWS CLI, esegui il `describe-db-clusters` comando con questi parametri.
**Parametri**
+ **--db-cluster-identifier**—Facoltativo. Specifica il cluster per il quale restituire l'endpoint. Se omesso, restituisce gli endpoint per un massimo di 100 cluster.
+ **--query**—Facoltativo. Specifica i campi da visualizzare. È utile per ridurre la quantità di dati da visualizzare per trovare gli endpoint. Se omesso, vengono restituite tutte le informazioni su un cluster.
+ **--region**—Facoltativo. Il parametro `--region` consente di specificare la regione a cui applicare il comando. Se omesso, viene usata la regione predefinita.
**Example**
L'esempio seguente restituisce l'endpoint `DBClusterIdentifier` (endpoint del cluster) e `ReaderEndpoint` per `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
Dopo aver installato l'endpoint del cluster, puoi connetterti al cluster con `mongo` o `mongodb`. Per ulteriori informazioni, consulta [Connessione agli endpoint](endpoints-connecting.md).
------
# Individuazione dell'endpoint di un'istanza
Puoi trovare l'endpoint per un'istanza utilizzando la console Amazon DocumentDB o il. AWS CLI
------
#### [ Using the Console di gestione AWS ]
**Per trovare l'endpoint dell'istanza con la console**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Clusters (Cluster)**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. **Nella casella di navigazione Clusters, vedrai la colonna Cluster Identifier.** Le tue istanze sono elencate in cluster, in modo simile alla schermata seguente.
![\[Tabella dei cluster che mostra l'elenco dei cluster nella colonna Cluster identifier, con le istanze annidate all'interno dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/choose-clusters.png)
1. Seleziona la casella a sinistra dell'istanza che ti interessa.
1. Scorri la sezione **Details (Dettagli)** per individuare l'endpoint dell'istanza.
![\[Screenshot della console che mostra la pagina dei dettagli con l'endpoint dell'istanza evidenziato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. Per connetterti a questa istanza, scorri fino alla sezione **Connect (Connetti)**. Individua la stringa di connessione per la shell `mongo` e una stringa di connessione che può essere utilizzata nel codice dell'applicazione per connetterti all'istanza.
![\[Schermata della console che mostra la sezione Connect con la shell mongo e le stringhe di connessione dell'applicazione evidenziate.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
Per trovare l'endpoint dell'istanza utilizzando il AWS CLI, esegui il comando seguente con questi argomenti.
**Argomenti**
+ **--db-instance-identifier**—Facoltativo. Specifica l'istanza per la quale restituire l'endpoint. Se omesso, restituisce l'endpoint per un massimo di 100 istanze.
+ **--query**—Facoltativo. Specifica i campi da visualizzare. È utile per ridurre la quantità di dati da visualizzare per trovare gli endpoint. Se omesso, vengono restituite tutte le informazioni su un'istanza. Il campo `Endpoint` ha tre membri, quindi la sua inclusione nella query, come nell'esempio seguente, restituisce tutti e tre i membri. Se sei interessato solo ad alcuni dei membri `Endpoint`, sostituisci `Endpoint` nella query con i membri desiderati, come nel secondo esempio.
+ **--region**—Facoltativo. Il parametro `--region` consente di specificare la regione a cui applicare il comando. Se omesso, viene usata la regione predefinita.
**Example**
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Per Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
Riducendo l'output per eliminare `HostedZoneId` del codice puoi modificare la query specificando `Endpoint.Port` e `Endpoint.Address`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Per Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
Dopo aver installato l'endpoint dell'istanza, puoi connetterti all'istanza con `mongo` o `mongodb`. Per ulteriori informazioni, consulta [Connessione agli endpoint](endpoints-connecting.md).
------
# Connessione agli endpoint
Quando hai l'endpoint del cluster o dell'istanza, puoi connettersi a esso utilizzando la shell `mongo` o una stringa di connessione.
## Connessione tramite la shell mongo
Utilizza la struttura seguente per costruire la stringa necessaria per connetterti al cluster o all'istanza utilizzando la shell `mongo`:
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**Esempi della shell `mongo`**
Connessione a un cluster.
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Connessione a un'istanza:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Connessione tramite una stringa di connessione
Utilizza la struttura seguente per costruire la stringa di connessione necessaria per connetterti al cluster o all'istanza.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Esempi di stringa di connessione**
Connessione a un cluster.
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Connessione a un'istanza:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```