Panoramica
In questa sezione imparerai a utilizzare l'API Datastream per creare, recuperare ed eliminare le configurazioni di connettività privata.
Le configurazioni di connettività privata contengono informazioni che Datastream utilizza per comunicare con un'origine dati su una rete privata (internamente in Google Cloud o con origini esterne connesse tramite VPN o Interconnect). Questa comunicazione avviene attraverso una connessione in peering VPC (Virtual Private Cloud).
Esistono due modi per utilizzare l'API Datastream. Puoi effettuare chiamate API REST oppure utilizzare Google Cloud CLI (CLI).
Per visualizzare informazioni generali sull'utilizzo di gcloud per gestire le configurazioni di connettività privata Datastream, fai clic qui.
Creazione di una configurazione di connettività privata
Prima di creare una configurazione di connettività privata, assicurati di:
- Avere una rete VPC per collegarsi alla rete privata di Datastream. Per ulteriori informazioni sulla creazione di una rete VPC, consulta Utilizzo del peering di rete VPC.
- Avere un intervallo IP disponibile sulla rete VPC. Datastream utilizza questo intervallo IP per creare il peering VPC con il VPC fornito, in modo che l'intervallo non si sovrapponga alle subnet all'interno di quel VPC. Di conseguenza, Datastream può comunicare con l'origine.
Esistono due parametri associati alla creazione di una configurazione di connettività privata:
vpcName:Specifica il nome e il percorso della rete VPC.subnet:Specifica un intervallo IP disponibile sulla rete VPC.
Il codice seguente mostra una richiesta di creazione di una configurazione di connettività privata e specifica il metodo di connettività utilizzando il peering VPC (vpcPeeringConfig).
REST
POST https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections?privateConnectionId=[private-connectivity configuration-id]
{
"displayName": "[private-connectivity-configuration-display-name]",
"vpcPeeringConfig": {
"vpcName": "[name-and-path-of-VPC-network]",
"subnet": "[subnet]"
}
}
Ad esempio:
POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
"displayName": "my private connectivity configuration",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
Dopo aver creato la configurazione di connettività privata, puoi visualizzare le relative informazioni chiamando il metodo privateConnections/get. L'output sarà simile al seguente:
{
"name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
"createTime": "2019-12-22T16:17:37.159786963Z",
"updateTime": "2019-12-22T16:17:37.159786963Z",
"displayName": "my private connectivity configuration",
"state": "CREATED",
"vpcPeeringConfig": {
"vpcName": "projects/my-project/global/networks/my-vpc",
"subnet": "10.11.12.13/29"
}
}
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per creare una configurazione di connettività privata, fai clic qui.
Ricevere informazioni su una configurazione di connettività privata
Il codice seguente mostra una richiesta per recuperare informazioni su una configurazione di connettività privata che è stata creata.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections/[private-connectivity-configuration-id]
Ad esempio:
GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni sulla configurazione della connettività privata, fai clic qui.
Elenca configurazioni di connettività privata
Il codice seguente mostra una richiesta di recupero delle informazioni su tutte le configurazioni di connettività privata.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni su tutte le configurazioni di connettività privata, fai clic qui.
Eliminazione di una configurazione di connettività privata
Il codice seguente mostra una richiesta di eliminazione di una configurazione di connettività privata. Una volta eliminata la configurazione, tutti i profili di connessione che la utilizzano non funzioneranno più. Inoltre, tutti i flussi che utilizzano questi profili di connessione non saranno utilizzabili.
Per risolvere il problema, assegna una configurazione di connettività privata diversa a ogni profilo di connessione. Per ulteriori informazioni, vedi Aggiornare un profilo di connessione.
REST
DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}
Ad esempio:
DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per eliminare la configurazione di connettività privata, fai clic qui.