Gestione delle configurazioni di connettività privata

Panoramica

In questa sezione imparerai a utilizzare l'API Datastream per creare, recuperare informazioni 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 Virtual Private Cloud (VPC).

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 generali 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 per il peering alla rete privata di Datastream. Per ulteriori informazioni sulla creazione di una rete VPC, consulta Utilizzare il peering di rete VPC.
  • Disporre di 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 possa sovrapporsi alle subnet all'interno di quel VPC. Di conseguenza, Datastream può comunicare con l'origine.

Alla creazione di una configurazione di connettività privata sono associati due parametri:

  • 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 per creare una configurazione di connettività privata e specifica il metodo di connettività come 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.

Ottieni 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 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 tue 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, i profili di connessione che la utilizzano non funzioneranno più. Inoltre, gli stream 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, 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 maggiori informazioni sull'utilizzo di gcloud per eliminare la configurazione della connettività privata, fai clic qui.

Passaggi successivi