Überblick
In diesem Abschnitt erfahren Sie, wie Sie mit der Datastream API Konfigurationen für private Verbindungen erstellen, löschen oder Informationen dazu abrufen.
Konfigurationen für private Verbindungen enthalten Informationen, die Datastream für die Kommunikation mit einer Datenquelle über ein privates Netzwerk (intern in Google Cloud oder mit externen Quellen, die über VPN oder Interconnect verbunden sind) verwendet. Diese Kommunikation erfolgt über eine VPC-Peering-Verbindung (Virtual Private Cloud).
Sie können die Datastream API auf zwei Arten verwenden. Sie können REST API-Aufrufe ausführen oder die Google Cloud CLI (CLI) verwenden.
Allgemeine Informationen zur Verwendung von gcloud für die Verwaltung von Datastream-Konfigurationen für private Verbindungen finden Sie hier.
Private Verbindungskonfiguration erstellen
Bevor Sie eine Konfiguration für private Verbindungen erstellen, dass Sie Folgendes haben:
- Ein VPC-Netzwerk für das Peering mit dem privaten Netzwerk von Datastream. Weitere Informationen zum Erstellen eines VPC-Netzwerks finden Sie unter VPC-Netzwerk-Peering verwenden.
- Einen verfügbaren IP-Bereich im VPC-Netzwerk. Datastream verwendet diesen IP-Bereich, um VPC-Peering mit der bereitgestellten VPC zu erstellen. Der Bereich darf sich also nicht mit Subnetzen innerhalb dieser VPC überschneiden. Dadurch kann Datastream mit der Quelle kommunizieren.
Beim Erstellen einer Konfiguration für private Verbindungen gibt es zwei Parameter:
vpcName:Geben Sie den Namen und den Pfad des VPC-Netzwerks an.subnet:Weisen Sie einen verfügbaren IP-Bereich im VPC-Netzwerk zu.
Der folgende Code zeigt eine Anfrage zum Erstellen einer Konfiguration für private Verbindungen. Er gibt die Verbindungsmethode als VPC-Peering (vpcPeeringConfig) an.
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]"
}
}
Beispiel:
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"
}
}
Nachdem die Konfiguration für private Verbindungen erstellt wurde, können Sie Informationen dazu aufrufen. Rufen Sie dazu die Methode privateConnections/get auf. Ihre Ausgabe sieht in etwa so aus:
{
"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
Weitere Informationen zur Verwendung von gcloud zum Erstellen einer Konfiguration für private Verbindungen finden Sie hier.
Informationen zu einer Konfiguration für private Verbindungen abrufen
Der folgende Code zeigt eine Anfrage zum Abrufen von Informationen zu einer erstellten Konfiguration für private Verbindungen.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections/[private-connectivity-configuration-id]
Beispiel:
GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection
gcloud
Weitere Informationen zur Verwendung von gcloud zum Abrufen von Informationen zu Ihrer Konfiguration für private Verbindungen finden Sie hier.
Konfigurationen für private Verbindungen auflisten
Der folgende Code zeigt eine Anfrage zum Abrufen von Informationen zu allen Ihren Konfigurationen für private Verbindungen.
REST
GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/ [location]/privateConnections
gcloud
Weitere Informationen zur Verwendung von gcloud zum Abrufen von Informationen zu allen Ihren Konfigurationen für private Verbindungen finden Sie hier.
Private Verbindungskonfiguration löschen
Der folgende Code zeigt eine Anfrage zum Löschen einer Konfiguration für private Verbindungen. Nachdem die Konfiguration gelöscht wurde, funktionieren Verbindungsprofile, die die Konfiguration verwenden, nicht mehr. Darüber hinaus können Streams, die diese Verbindungsprofile verwenden, nicht ausgeführt werden.
Um dieses Problem zu beheben, weisen Sie jedem Verbindungsprofil eine andere Konfiguration für private Verbindungen zu. Weitere Informationen finden Sie unter Verbindungsprofil aktualisieren.
REST
DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}
Beispiel:
DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}
gcloud
Weitere Informationen zur Verwendung von gcloud zum Löschen der Konfiguration für private Verbindungen finden Sie hier.