Data Transfer Essentials-Ressourcen erstellen

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, also Konfigurationen und Ziele.

Hinweise

Bevor Sie Data Transfer Essentials-Konfigurationen oder -Ziele erstellen, gehen Sie so vor:

  1. Installieren Sie die Google Cloud CLI, falls noch nicht geschehen.

  2. Authentifizieren Sie die gcloud CLI mit Ihrem Konto:

    gcloud auth login

  3. Projekt festlegen

    gcloud config set project PROJECT_ID

    Ersetzen Sie dabei PROJECT_ID durch Ihre Projekt-ID.

  4. Aktivieren Sie die Network Connectivity API in Ihrem Projekt.

  5. Berechtigungen konfigurieren

  6. 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

    Führen Sie den Befehl gcloud network-connectivity multicloud-data-transfer-supported-services list aus.

    gcloud network-connectivity multicloud-data-transfer-supported-services list \
    --location=LOCATION

    Ersetzen Sie LOCATION durch eine Google CloudRegions-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 Stufen 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'}]

    Mit dem Befehl gcloud network-connectivity multicloud-data-transfer-supported-services describe können Sie prüfen, ob ein bestimmter Dienst infrage kommt.

    gcloud network-connectivity multicloud-data-transfer-supported-services describe SERVICE1 \
    --location=LOCATION

    Ersetzen Sie SERVICE1 durch einen gültigen String, der den Dienst repräsentiert. 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-ID
    • LOCATION: eine Google Cloud Regions-ID, z. B. europe-west3

    In der folgenden Beispielausgabe sind die Dienste aufgeführt, die mit Data Transfer Essentials konfiguriert werden können, da sie unterstützte Stufen 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"
        }
      ]
    }
  ]
}

    So prüfen Sie, ob ein bestimmter Dienst infrage kommt:

    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.

  7. 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 anerkannte 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 anhand der Kennung eine Anfrage 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": {}
}

Die Erstellung von Data Transfer Essentials-Konfigurationen kann bis zu 24 Stunden dauern. Details zur Konfiguration ansehen

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. Mit einer Zielressource wird eine Verknüpfung zwischen einer vorhandenen Konfiguration und einem externen IP-Präfix mit einem Endpunkt erstellt. Ein Endpunkt enthält eine CSP-Kennung (Cloud Service Provider) und die zugehörige ASN.

Erstellen Sie jeweils nur 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 innerhalb 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, das als Bereich (z. B. 203.0.113.0/24 oder 2001:db8::/32) oder als Wert (z. B. 203.0.113.6 oder 2001:db8:2:2:2:2:2:2) angegeben wird. 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. Siehe Erkannte ASNs.
    • CSP: Ein String, der den CSP der ASN darstellt, die das Präfix ankündigt.

    Sie können das Flag endpoints mehrmals im selben Befehl angeben. Ein Ziel muss mindestens einen und darf höchstens 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 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 innerhalb einer Region eindeutig sein.
  • DESCRIPTION: eine Beschreibung des Ziels und seines Zwecks.

  • IP_PREFIX: Das IP-Präfix des Ziels, das als Bereich (z. B. 203.0.113.0/24 oder 2001:db8::/32) oder als Wert (z. B. 203.0.113.6 oder 2001:db8:2:2:2:2:2:2) angegeben wird. 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. Siehe 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 höchstens 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 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"
    }
  ]
}

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.

Nächste Schritte