Gestione delle configurazioni di connettività privata

In questa pagina scoprirai come utilizzare l'API Datastream per creare, recuperare informazioni ed eliminare le configurazioni di connettività privata.

Le configurazioni di connettività privata contengono informazioni utilizzate da Datastream per comunicare con un'origine dati su una rete privata (all'interno di Google Cloud o con origini esterne collegate tramite VPN o Interconnect). Questa comunicazione avviene tramite una connessione in peering VPC (Virtual Private Cloud).

Puoi utilizzare l'API Datastream in due modi. Puoi effettuare chiamate all'API REST o utilizzare Google Cloud CLI (interfaccia a riga di comando).

Per informazioni di alto livello sull'utilizzo di gcloud per gestire le configurazioni di connettività privata di 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 da mettere in peering con la rete privata di Datastream. Per ulteriori informazioni sulla creazione di una rete VPC, consulta Utilizzare il peering di rete VPC.
  • Avere un intervallo IP disponibile sulla rete VPC. Datastream utilizza questo intervallo IP per creare il peering VPC con la VPC fornita, pertanto l'intervallo non può sovrapporsi alle subnet all'interno della 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: Fornisci 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à come l'utilizzo del 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"
  }
}

Una volta creata la configurazione di connettività privata, puoi visualizzarne le informazioni chiamando il metodo privateConnections/get. Viene visualizzato l'output, 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.

Visualizzare le informazioni su una configurazione di connettività privata

Il codice seguente mostra una richiesta di recupero delle informazioni su una configurazione di connettività privata 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 le configurazioni di connettività privata

Il codice seguente mostra una richiesta per recuperare 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 seguente codice mostra una richiesta di eliminazione di una configurazione di connettività privata. Dopo l'eliminazione della configurazione, tutti i profili di connessione che la utilizzano non funzioneranno. Inoltre, tutti gli stream che utilizzano questi profili di connessione non saranno operativi.

Per risolvere il problema, assegna una configurazione di connettività privata diversa a ogni profilo di connessione. Per ulteriori informazioni, consulta la sezione 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.

Passaggi successivi