Damit Traffic als für die Abrechnung von Data Transfer Essentials konfiguriert identifiziert werden kann, müssen Sie Dienste auswählen und sie ausgewählten Endpunkten zuordnen. Auf dieser Seite erfahren Sie, wie Sie die erforderlichen Data Transfer Essentials-Ressourcen erstellen, nämlich Konfigurationen und Ziele.
Hinweis
Bevor Sie Data Transfer Essentials-Konfigurationen oder -Ziele erstellen, führen Sie die folgenden Schritte aus:
Installieren Sie das Google Cloud CLI, falls noch nicht geschehen.
Authentifizieren Sie die gcloud CLI mit Ihrem Konto:
gcloud auth loginLegen Sie Ihr Projekt fest.
gcloud config set project PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch Ihre Projekt-ID.Aktivieren Sie die Network Connectivity API in Ihrem Projekt.
Konfigurieren Sie Berechtigungen.
Prüfen Sie, ob die Dienste, die Sie für Data Transfer Essentials auswählen möchten, unterstützt werden. Sie können Data Transfer Essentials nur für unterstützte Dienste und Regionen konfigurieren.
gcloud
Verwenden Sie den
gcloud network-connectivity multicloud-data-transfer-supported-services listBefehl.gcloud network-connectivity multicloud-data-transfer-supported-services list \ --location=LOCATIONErsetzen Sie
LOCATIONdurch eine Google Cloud Regions-ID, z. B.europe-west3.Die folgende Beispielausgabe zeigt, dass die Dienste für die Konfiguration mit Data Transfer Essentials infrage kommen, da sie unterstützte Tarife verwenden.
NAME SERVICE_CONFIGS cloud-sql [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_PREMIUM_ONLY'}] cloud-storage [{'eligibilityCriteria': 'REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY'}] compute-engine [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_STANDARD_ONLY'}]Verwenden Sie den
gcloud network-connectivity multicloud-data-transfer-supported-services describeBefehl, um die Berechtigung eines bestimmten Dienstes zu prüfen.gcloud network-connectivity multicloud-data-transfer-supported-services describe SERVICE1 \ --location=LOCATIONErsetzen Sie
SERVICE1durch einen gültigen String, der den Dienst darstellt. Weitere Informationen finden Sie unter Unterstützte Dienste und Regionen.API
Verwenden Sie die Methode
multicloudDataTransferSupportedServices.get:GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDLOCATION: eine Google Cloud Regions-ID, z. B.europe-west3
In der folgenden Beispielausgabe sind die Dienste aufgeführt, die für die Konfiguration mit Data Transfer Essentials infrage kommen, da sie unterstützte Tarife verwenden.
{ "multicloudDataTransferSupportedServices": [ { "name": "cloud-sql", "serviceConfigs": [ { "eligibilityCriteria": "NETWORK_SERVICE_TIER_PREMIUM_ONLY" } ] }, { "name": "cloud-storage", "serviceConfigs": [ { "eligibilityCriteria": "REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY" } ] }, { "name": "compute-engine", "serviceConfigs": [ { "eligibilityCriteria": "NETWORK_SERVICE_TIER_STANDARD_ONLY" } ] } ] }Verwenden Sie die folgende Methode, um die Berechtigung eines bestimmten Dienstes zu prüfen:
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices { "service": "SERVICE1" }Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID.LOCATION: eine Google Cloud Regions-ID, z. B.europe-west3.SERVICE1: ein gültiger String, der den Dienst darstellt. Weitere Informationen finden Sie unter Unterstützte Dienste und Regionen.
Prüfen Sie, ob die autonomen Systemnummern (Autonomous System Numbers, ASNs), die Sie angeben möchten, erkannt werden. Sie können Traffic nur für Ziele konfigurieren, die erkannte ASNs verwenden.
Konfiguration erstellen
Erstellen Sie eine Data Transfer Essentials-Konfiguration, die die angegebenen Dienste enthält. Sie können nur eine Konfiguration pro Region und Projekt erstellen.
gcloud
Führen Sie den Befehl gcloud network-connectivity multicloud-data-transfer-configs create aus.
gcloud network-connectivity multicloud-data-transfer-configs create CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--services=SERVICE-A,...
Ersetzen Sie Folgendes:
CONFIGURATION_NAME: ein Name für die Konfiguration.LOCATION: die Region der Konfiguration.DESCRIPTION: eine Beschreibung der Konfiguration und ihres Zwecks.SERVICE-A,...: eine Reihe von Strings, die die Dienste darstellen, für die Sie Data Transfer Essentials konfigurieren möchten. Gültige Strings finden Sie unter Unterstützte Dienste und Regionen.
Mit dem folgenden Beispielbefehl wird eine Konfiguration mit dem Namen config1 in der Region europe-west3 für die Dienste compute-engine, cloud-storage und cloud-sql erstellt.
gcloud network-connectivity multicloud-data-transfer-configs create config1 \
--location=europe-west3 \
--description="configuration for europe-west3" \
--services=compute-engine,cloud-storage,cloud-sql
API
Verwenden Sie die Methode multicloudDataTransferConfigs.create:
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
"description": "DESCRIPTION",
"services": {
"SERVICE-A",
"SERVICE-B"
}
}
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID.LOCATION: die Region der Konfiguration.CONFIGURATION_NAME: ein Name für die Konfiguration.DESCRIPTION: eine Beschreibung der Konfiguration und ihres Zwecks.SERVICE-A,...: eine Reihe von Strings, die die Dienste darstellen, für die Sie Data Transfer Essentials konfigurieren möchten. Gültige Strings finden Sie unter Unterstützte Dienste und Regionen.
Optional können Sie den Abfrageparameter requestID verwenden, um Ihre API-Anfragen zu identifizieren. Wenn Sie Ihre Anfrage wiederholen, kann der Server die ID verwenden, um eine Anfrage zu ignorieren, auf die bereits geantwortet wurde.
Mit dem folgenden JSON-Snippet wird eine Konfiguration mit dem Namen config1 in der Region europe-west3 für die Dienste compute-engine, cloud-storage und cloud-sql erstellt.
POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1
{
"description": "configuration for europe-west3",
"services": {
"compute-engine": {},
"cloud-storage": {},
"cloud-sql": {}
}
Terraform
Im folgenden Terraform-Beispiel wird eine Konfiguration erstellt.
Die Erstellung von Data Transfer Essentials-Konfigurationen kann bis zu 24 Stunden dauern. Wenn Sie den Status der Konfiguration prüfen möchten, rufen Sie die Details der Konfiguration auf.
Wenn Sie Dienste hinzufügen oder entfernen möchten, aktualisieren Sie eine Konfiguration.
Bevor Sie versuchen, eine neue Konfiguration zu erstellen, löschen Sie die vorhandene Konfiguration.
Ziel für die Konfiguration erstellen
Erstellen Sie ein Ziel für die Data Transfer Essentials-Konfiguration. Eine Zielressource erstellt eine Zuordnung zwischen einer vorhandenen Konfiguration und einem externen IP-Präfix mit einem Endpunkt. Ein Endpunkt enthält eine CSP-ID (Cloud-Dienstanbieter) und die zugehörige ASN.
Erstellen Sie jeweils ein Ziel.
gcloud
Führen Sie den Befehl gcloud network-connectivity multicloud-data-transfer-configs destinations create aus.
gcloud network-connectivity multicloud-data-transfer-configs destinations create DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--ip-prefix=IP_PREFIX \
--endpoints=asn=ASN,csp=CSP
Ersetzen Sie Folgendes:
DESTINATION_NAME: ein Name für das Ziel. Der Name muss in einer Region eindeutig sein.CONFIGURATION_NAME: der Name der Konfiguration.LOCATION: die Region der Konfiguration.DESCRIPTION: eine Beschreibung des Ziels und seines Zwecks.IP_PREFIX: das IP-Präfix des Ziels, angegeben als Bereich (z. B.203.0.113.0/24oder2001:db8::/32) oder als Wert (z. B.203.0.113.6oder2001:db8:2:2:2:2:2:2). Ein IP-Präfix darf in einer Konfiguration nur einmal verwendet werden, muss mindestens einem Endpunkt zugeordnet sein und kann bis zu fünf Endpunkten zugeordnet werden.Geben Sie Strings an, die den Endpunkten entsprechen, die Sie dem Ziel hinzufügen möchten:
ASN: die ASN, die das Präfix ankündigen soll. Weitere Informationen finden Sie unter Erkannte ASNs.CSP: ein String, der den CSP der ASN darstellt, die das Präfix ankündigt.
Sie können das Flag
endpointsmehrmals im selben Befehl angeben. Ein Ziel muss mindestens einen und darf maximal fünf Endpunkte haben.
Mit dem folgenden Beispielbefehl wird ein Ziel mit dem Namen destination1 für die Konfiguration config1 in der Region europe-west3 für das angegebene IP-Präfix und den angegebenen Endpunkt erstellt.
gcloud network-connectivity multicloud-data-transfer-configs destinations create destination1 \
--multicloud-data-transfer-config=config1 \
--location=europe-west3 \
--description="destination1 for config1" \
--ip-prefix=203.0.113.0/24 \
--endpoints=asn=16509,csp="aws"
API
Verwenden Sie die Methode multicloudDataTransferConfigs.destinations.create:
POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
"description": "DESCRIPTION",
"ipPrefix": "IP_PREFIX",
"endpoints": [
{
"asn": "ASN",
"csp": "CSP"
}
]
}
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID.LOCATION: die Region der Konfiguration.CONFIGURATION_NAME: der Name der Konfiguration.DESTINATION_NAME: ein Name für das Ziel. Der Name muss in einer Region eindeutig sein.DESCRIPTION: eine Beschreibung des Ziels und seines Zwecks.IP_PREFIX: das IP-Präfix des Ziels, angegeben als Bereich (z. B.203.0.113.0/24oder2001:db8::/32) oder als Wert (z. B.203.0.113.6oder2001:db8:2:2:2:2:2:2). Ein IP-Präfix darf in einer Konfiguration nur einmal und nur für eine ASN verwendet werden.Geben Sie Strings an, die den Endpunkten entsprechen, die Sie dem Ziel hinzufügen möchten:
ASN: die ASN, die das Präfix ankündigen soll. Weitere Informationen finden Sie unter Erkannte ASNs.CSP: ein String, der den CSP der ASN darstellt, die das Präfix ankündigt.
Sie können mehrere Endpunkte im selben Aufruf angeben. Ein Ziel muss mindestens einen und darf maximal fünf Endpunkte haben.
Mit dem folgenden Beispielbefehl wird ein Ziel mit dem Namen destination1 für die Konfiguration config1 in der Region europe-west3 für das angegebene IP-Präfix und den angegebenen Endpunkt erstellt.
POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1/destinations/destination1
{
"description": "destination1 for config1",
"ipPrefix": "203.0.113.0/24",
"endpoints": [
{
"asn": "16509",
"csp": "aws"
}
]
}
Terraform
Im folgenden Terraform-Beispiel wird ein Ziel erstellt.
Wenn Sie den Status des Ziels prüfen möchten, rufen Sie die Details des Ziels auf.
Wenn Sie Endpunkte hinzufügen oder entfernen möchten, aktualisieren Sie das Ziel.
Alternativ können Sie das Ziel löschen.