Membuat resource Data Transfer Essentials

Agar traffic diidentifikasi sebagai dikonfigurasi untuk penagihan Data Transfer Essentials, Anda perlu 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 Anda membuat konfigurasi atau tujuan Data Transfer Essentials, lakukan hal berikut:

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

  2. Lakukan autentikasi gcloud CLI dengan akun Anda:

    gcloud auth login

  3. Tetapkan project Anda:

    gcloud config set project PROJECT_ID

    Ganti PROJECT_ID dengan project ID Anda.

  4. Aktifkan Network Connectivity API di project Anda.

  5. Konfigurasi izin.

  6. Periksa apakah layanan yang ingin Anda pilih untuk Data Transfer Essentials didukung. Anda dapat mengonfigurasi Data Transfer Essentials hanya 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 wilayah Google Cloud, misalnya, europe-west3.

    Contoh output berikut menunjukkan bahwa layanan memenuhi syarat untuk dikonfigurasi menggunakan Data Transfer Essentials karena menggunakan tingkat 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.

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

    Ganti SERVICE1 dengan string valid yang merepresentasikan layanan. Lihat Layanan dan wilayah 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 Google Cloud region, misalnya, europe-west3

    Contoh output berikut mencantumkan layanan yang memenuhi syarat untuk dikonfigurasi menggunakan Data Transfer Essentials karena menggunakan tingkat 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 Google Cloud region, misalnya, europe-west3.
    • SERVICE1: string valid yang mewakili layanan. Lihat Layanan dan wilayah yang didukung.

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

Membuat konfigurasi

Buat konfigurasi Data Transfer Essentials yang mencakup layanan tertentu. 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-nya. Untuk mengetahui string yang valid, lihat Layanan dan wilayah 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-nya. Untuk mengetahui string yang valid, lihat Layanan dan wilayah yang didukung.

Secara opsional, 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": {}
}

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.

Buat 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 minimal satu endpoint, dan dapat dikaitkan dengan hingga 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 merepresentasikan CSP ASN yang mengumumkan awalan.

    Anda dapat menentukan tanda endpoints beberapa kali dalam perintah yang sama. Tujuan harus memiliki minimal 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 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"
    }
  ]
}

Untuk memeriksa status tujuan, lihat detail tujuan.

Untuk menambahkan atau menghapus endpoint, perbarui tujuan.

Atau, hapus tujuan.

Langkah berikutnya