Membuat resource Data Transfer Essentials

Agar traffic diidentifikasi sebagai yang dikonfigurasi untuk penagihan Data Transfer Essentials, Anda harus memilih layanan dan mengaitkannya dengan endpoint yang dipilih. Halaman ini menunjukkan cara membuat resource Data Transfer Essentials yang diperlukan, yaitu konfigurasi dan tujuan.

Sebelum memulai

Sebelum membuat konfigurasi atau tujuan Data Transfer Essentials, lakukan hal berikut:

  1. Jika Anda belum melakukannya, instal Google Cloud CLI.

  2. Autentikasi gcloud CLI dengan akun Anda:

    gcloud auth login

  3. Atur project Anda:

    gcloud config set project PROJECT_ID

    Ganti PROJECT_ID dengan project ID Anda.

  4. Aktifkan Network Connectivity API di project Anda.

  5. Konfigurasikan izin.

  6. Periksa apakah layanan yang ingin Anda pilih untuk Data Transfer Essentials didukung. Anda hanya dapat mengonfigurasi Data Transfer Essentials untuk layanan dan region yang didukung.

    gcloud

    Gunakan perintah gcloud network-connectivity multicloud-data-transfer-supported-services list.

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

    Ganti LOCATION dengan ID region Google Cloud —misalnya, europe-west3.

    Contoh output berikut menunjukkan bahwa layanan memenuhi syarat untuk dikonfigurasi menggunakan Data Transfer Essentials karena menggunakan paket yang didukung.

    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'}]

    Untuk memeriksa kelayakan layanan tertentu, gunakan perintah gcloud network-connectivity multicloud-data-transfer-supported-services describe command.

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

    Ganti SERVICE1 dengan string valid yang mewakili layanan. Lihat Layanan dan region yang didukung.

    API

    Gunakan metode multicloudDataTransferSupportedServices.get.

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda
    • LOCATION: ID region Google Cloud , misalnya, europe-west3

    Contoh output berikut mencantumkan layanan yang memenuhi syarat untuk dikonfigurasi menggunakan Data Transfer Essentials karena menggunakan paket yang didukung.

    {
  "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"
        }
      ]
    }
  ]
}

    Untuk memeriksa kelayakan layanan tertentu, gunakan metode berikut:

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices
{
"service": "SERVICE1"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.
    • LOCATION: ID region Google Cloud , misalnya, europe-west3.
    • SERVICE1: string valid yang mewakili layanan. Lihat Layanan dan region yang didukung.

  7. Periksa apakah nomor sistem otonom (ASN) yang ingin Anda tentukan dikenali. Anda hanya dapat mengonfigurasi traffic ke tujuan yang menggunakan ASN yang dikenali.

Membuat konfigurasi

Buat konfigurasi Data Transfer Essentials yang menyertakan layanan yang ditentukan. Anda hanya dapat membuat satu konfigurasi per region per project.

gcloud

Gunakan perintah gcloud network-connectivity multicloud-data-transfer-configs create.

gcloud network-connectivity multicloud-data-transfer-configs create CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,...

Ganti kode berikut:

  • CONFIGURATION_NAME: nama untuk konfigurasi.
  • LOCATION: region konfigurasi.
  • DESCRIPTION: deskripsi konfigurasi dan tujuannya.
  • SERVICE-A,...: serangkaian string yang mewakili layanan yang ingin Anda konfigurasi Data Transfer Essentials. Untuk string yang valid, lihat Layanan dan region yang didukung.

Contoh perintah berikut membuat konfigurasi bernama config1 di region europe-west3 untuk layanan compute-engine, cloud-storage, dan cloud-sql.

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

Gunakan metode multicloudDataTransferConfigs.create.

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
  "description": "DESCRIPTION",
  "services": {
    "SERVICE-A",
    "SERVICE-B"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project Anda.
  • LOCATION: region konfigurasi.
  • CONFIGURATION_NAME: nama untuk konfigurasi.
  • DESCRIPTION: deskripsi konfigurasi dan tujuannya.
  • SERVICE-A,...: serangkaian string yang mewakili layanan yang ingin Anda konfigurasi Data Transfer Essentials. Untuk string yang valid, lihat Layanan dan region yang didukung.

Jika perlu, gunakan parameter kueri requestID untuk mengidentifikasi permintaan API Anda. Jika Anda mencoba lagi permintaan, server dapat menggunakan ID untuk mengabaikan permintaan yang telah direspons.

Cuplikan JSON berikut membuat konfigurasi bernama config1 di region europe-west3 untuk layanan compute-engine, cloud-storage, dan cloud-sql.

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

Contoh Terraform berikut membuat konfigurasi.

resource "google_network_connectivity_multicloud_data_transfer_config" "default" {
  name        = "config"
  location    = "europe-west1"
  description = "A basic multicloud data transfer config"
  services {
    service_name = "big-query"
  }
  services {
    service_name = "cloud-storage"
  }
}

Konfigurasi Data Transfer Essentials memerlukan waktu hingga 24 jam untuk dibuat. Untuk memeriksa status konfigurasi, lihat detail konfigurasi.

Untuk menambahkan atau menghapus layanan, perbarui konfigurasi.

Sebelum mencoba membuat konfigurasi baru, hapus konfigurasi yang ada.

Membuat tujuan untuk konfigurasi

Buat tujuan untuk konfigurasi Data Transfer Essentials. Resource tujuan membuat hubungan antara konfigurasi yang ada dan awalan IP eksternal dengan endpoint. Endpoint berisi ID penyedia layanan cloud (CSP) dan ASN-nya.

Buat satu tujuan dalam satu waktu.

gcloud

Gunakan perintah gcloud network-connectivity multicloud-data-transfer-configs destinations create.

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

Ganti kode berikut:

  • DESTINATION_NAME: nama untuk tujuan. Nama harus unik dalam suatu region.
  • CONFIGURATION_NAME: nama konfigurasi.
  • LOCATION: region konfigurasi.
  • DESCRIPTION: deskripsi tujuan dan tujuannya.

  • IP_PREFIX: awalan IP tujuan yang ditentukan sebagai rentang (misalnya, 203.0.113.0/24 atau 2001:db8::/32) atau nilai (misalnya, 203.0.113.6 atau 2001:db8:2:2:2:2:2:2). Awalan IP hanya boleh digunakan satu kali dalam konfigurasi, harus dikaitkan dengan setidaknya satu endpoint, dan dapat dikaitkan dengan maksimal 5 endpoint.

  • Tentukan string yang sesuai dengan endpoint yang ingin Anda tambahkan ke tujuan:

    • ASN: ASN yang diharapkan untuk mengumumkan awalan. Lihat ASN yang Dikenali.
    • CSP: string yang mewakili CSP dari ASN yang mengumumkan awalan.

    Anda dapat menentukan flag endpoints beberapa kali dalam perintah yang sama. Tujuan harus memiliki setidaknya satu endpoint dan tidak boleh memiliki lebih dari lima endpoint.

Contoh perintah berikut membuat tujuan bernama destination1 untuk konfigurasi config1 di region europe-west3 untuk awalan IP dan endpoint yang ditentukan.

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

Gunakan metode 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"
    }
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project Anda.
  • LOCATION: region konfigurasi.
  • CONFIGURATION_NAME: nama konfigurasi.
  • DESTINATION_NAME: nama untuk tujuan. Nama harus unik dalam suatu region.
  • DESCRIPTION: deskripsi tujuan dan tujuannya.

  • IP_PREFIX: awalan IP tujuan yang ditentukan sebagai rentang (misalnya, 203.0.113.0/24 atau 2001:db8::/32) atau nilai (misalnya, 203.0.113.6 atau 2001:db8:2:2:2:2:2:2). Awalan IP hanya boleh digunakan satu kali dalam konfigurasi dan hanya untuk satu ASN.

  • Tentukan string yang sesuai dengan endpoint yang ingin Anda tambahkan ke tujuan:

    • ASN: ASN yang diharapkan untuk mengumumkan awalan. Lihat ASN yang Dikenali.
    • CSP: string yang mewakili CSP dari ASN yang mengumumkan awalan.

    Anda dapat menentukan beberapa endpoint dalam panggilan yang sama. Tujuan harus memiliki setidaknya satu endpoint dan tidak boleh memiliki lebih dari lima endpoint.

Contoh perintah berikut membuat tujuan bernama destination1 untuk konfigurasi config1 di region europe-west3 untuk awalan IP dan endpoint yang ditentukan.

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

Contoh Terraform berikut membuat tujuan.

resource "google_network_connectivity_destination" "default" {
  name                            = "destination"
  location                        = "europe-west1"
  multicloud_data_transfer_config = google_network_connectivity_multicloud_data_transfer_config.default.name
  description                     = "A basic destination"
  ip_prefix                       = "10.0.0.0/8"
  endpoints {
    asn = "14618"
    csp = "AWS"
  }
}

Untuk memeriksa status tujuan, lihat detail tujuan.

Untuk menambahkan atau menghapus endpoint, perbarui tujuan.

Atau, hapus tujuan.

Langkah berikutnya