View a markdown version of this page

API Amazon DocumentDB e interfaccia (endpoint VPC) (AWS PrivateLink) - Amazon DocumentDB

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

API Amazon DocumentDB e interfaccia (endpoint VPC) (AWS PrivateLink)

Nota

I cluster elastici Amazon DocumentDB non supportano AWS PrivateLink Endpoint VPC.

Puoi stabilire una connessione privata tra i tuoi endpoint VPC e l'API Amazon DocumentDB creando un endpoint VPC di interfaccia. Gli endpoint di interfaccia sono alimentati da AWS PrivateLink.

Sebbene i cluster basati su istanze Amazon DocumentDB non richiedano una connessione endpoint VPC di interfaccia, AWS PrivateLink ti consente di accedere privatamente alle operazioni dell'API Amazon DocumentDB senza un gateway Internet, un dispositivo NAT, una connessione VPN o Direct Connect connessione. Le istanze Amazon DocumentDB nel tuo VPC non necessitano di indirizzi IP pubblici per comunicare con gli endpoint API di Amazon DocumentDB per avviare, modificare o terminare istanze di database e cluster di database. Le tue istanze Amazon DocumentDB inoltre non necessitano di indirizzi IP pubblici per utilizzare nessuna delle operazioni API di Amazon DocumentDB disponibili. Il traffico tra il tuo VPC e Amazon DocumentDB non esce dalla rete Amazon.

Ogni endpoint di interfaccia è rappresentato da una o più interfacce di rete elastiche nelle sottoreti. Per ulteriori informazioni, consulta Interfacce di rete elastiche nella Guida per l’utente di Amazon EC2.

Per ulteriori informazioni sugli endpoint VPC, consulta Accedi a un Servizio AWS utilizzando un endpoint VPC di interfaccia nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente. Per ulteriori informazioni sulle operazioni di Amazon DocumentDB, consulta Riferimento alle API di Amazon DocumentDB.

Considerazioni sugli endpoint VPC dell'

Prima di configurare un endpoint VPC di interfaccia per gli endpoint API di Amazon DocumentDB, assicurati di rivedere il prerequisiti per gli endpoint di interfaccia nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente.

Tutte le operazioni API di Amazon DocumentDB relative alla gestione delle risorse Amazon DocumentDB sono disponibili dal tuo VPC utilizzando AWS PrivateLink.

Le policy degli endpoint VPC sono supportate per gli endpoint API di Amazon DocumentDB. Per impostazione predefinita, l'accesso completo alle operazioni API di Amazon DocumentDB è consentito tramite l'endpoint. Per ulteriori informazioni, consulta Controlla l'accesso agli endpoint VPC utilizzando le policy degli endpoint nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente.

Disponibilità nelle regioni

L'API Amazon DocumentDB attualmente supporta gli endpoint VPC nei seguenti Regioni AWS:

  • Stati Uniti orientali (Ohio)

  • Stati Uniti orientali (Virginia settentrionale)

  • Stati Uniti occidentali (Oregon)

  • Africa (Città del Capo)

  • Asia Pacific (Hong Kong)

  • Asia Pacifico (Mumbai)

  • Asia Pacifico (Hyderabad)

  • Asia Pacifico (Osaka)

  • Asia Pacifico (Seoul)

  • Asia Pacifico (Singapore)

  • Asia Pacifico (Sydney)

  • Asia Pacifico (Tokyo)

  • Canada (Centrale)

  • Cina (Pechino)

  • Cina (Ningxia)

  • Europa (Francoforte)

  • Europa (Irlanda)

  • Europa (Londra)

  • Europa (Parigi)

  • Europa (Spagna)

  • Europa (Milano)

  • Medio Oriente (Emirati Arabi Uniti)

  • Sud America (San Paolo)

  • AWS GovCloud (US-East)

  • AWS GovCloud (US-West)

Creazione di un endpoint VPC di interfaccia per l'API Amazon DocumentDB

Puoi creare un endpoint VPC per l'API Amazon DocumentDB utilizzando la console Amazon VPC o AWS Command Line Interface (AWS CLI). Per ulteriori informazioni, vedere Accedere a Servizio AWS utilizzando un endpoint VPC di interfaccia nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente.

Crea un endpoint VPC per l'API Amazon DocumentDB utilizzando il nome del servizio com.amazonaws.region.rds.

Escludendo Regioni AWS in Cina, se abiliti il DNS privato per l'endpoint, puoi effettuare richieste API ad Amazon DocumentDB con l'endpoint VPC utilizzando il nome DNS predefinito per Regioni AWS, ad esempio rds.us-east-1.amazonaws.com. Per la Cina (Pechino) e la Cina (Ningxia) Regioni AWS, puoi effettuare richieste API con l'endpoint VPC utilizzando rispettivamente rds-api.cn-north-1.amazonaws.com .cn e rds-api.cn-northwest-1.amazonaws.com .cn.

Per ulteriori informazioni, consulta Accedere a Servizio AWS utilizzando un endpoint VPC di interfaccia nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente.

Creazione di una policy per gli endpoint VPC per l'API Amazon DocumentDB

Puoi allegare una policy sugli endpoint al tuo endpoint VPC che controlli l'accesso all'API Amazon DocumentDB. La policy specifica le informazioni riportate di seguito:

  • Il principale che può eseguire operazioni.

  • Le azioni che possono essere eseguite.

  • Le risorse sui cui si possono eseguire azioni.

Per ulteriori informazioni, consulta Controlla l'accesso agli endpoint VPC utilizzando le policy degli endpoint nel Cloud privato virtuale Amazon (AWS PrivateLink) Guida per l'utente.

Esempio: policy sugli endpoint VPC per le azioni API di Amazon DocumentDB

Di seguito è riportato un esempio di policy sugli endpoint per l'API Amazon DocumentDB. Se collegata a un endpoint, questa policy consente l'accesso alle azioni API Amazon DocumentDB elencate per tutti i principali su tutte le risorse.

{ "Version": "2012-10-17", "Statement": [ { "Principal": "*", "Effect": "Allow", "Action": [ "rds:CreateDBInstance", "rds:ModifyDBInstance", "rds:CreateDBSnapshot" ], "Resource": "*" } ] }

Esempio: policy sugli endpoint VPC che nega tutti gli accessi a un determinato utente Account AWS

La seguente politica sugli endpoint VPC nega Account AWS 123456789012 tutti gli accessi alle risorse utilizzando l'endpoint. La policy consente tutte le azioni effettuate da altri Account AWS.

{ "Version": "2012-10-17", "Statement": [ { "Action": "*", "Effect": "Allow", "Resource": "*", "Principal": "*" }, { "Action": "*", "Effect": "Deny", "Resource": "*", "Principal": { "AWS": [ "123456789012" ] } } ] }