Mengelola resource Data Transfer Essentials

Halaman ini menjelaskan cara mengelola resource yang dibuat menggunakan Data Transfer Essentials.

Mengelola konfigurasi

Anda dapat mencantumkan konfigurasi Data Transfer Essentials di project, memeriksa status konfigurasi, memperbarui konfigurasi, atau menghapusnya.

Mencantumkan konfigurasi dalam project

Untuk mencantumkan semua konfigurasi di lokasi dalam project, gunakan salah satu cara berikut:

gcloud

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

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

Ganti LOCATION dengan region konfigurasi.

API

Gunakan metode multicloudDataTransferConfigs.get.

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

Ganti kode berikut:

  • PROJECT_ID: ID project Anda
  • LOCATION: region konfigurasi

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.

Melihat detail konfigurasi

Untuk melihat detail konfigurasi, gunakan salah satu cara berikut:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
    --location=LOCATION

Ganti kode berikut:

  • CONFIGURATION_NAME: nama konfigurasi
  • LOCATION: region konfigurasi

Contoh output berikut menunjukkan bahwa traffic dari compute-engine siap dipertimbangkan untuk penagihan Data Transfer Essentials. Untuk cloud-sql dan cloud-storage, update tertunda. Nilai effectiveTime menunjukkan waktu saat status diharapkan berlaku. Contoh ini juga menunjukkan total jumlah tujuan dalam konfigurasi dan jumlah tujuan yang aktif.

description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: DELETING
- cloud-storage:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: ADDING
- compute-engine:
  states:
  - state: ACTIVE
…

API

Gunakan metode multicloudDataTransferConfigs.list.

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

Ganti kode berikut:

  • PROJECT_ID: ID project Anda
  • LOCATION: region konfigurasi
  • CONFIGURATION_NAME: nama konfigurasi

Contoh output berikut menunjukkan bahwa traffic dari compute-engine siap dipertimbangkan untuk penagihan Data Transfer Essentials. Untuk cloud-storage dan cloud-sql, update tertunda. Nilai effectiveTime menunjukkan waktu saat status diharapkan berlaku. Contoh ini juga menunjukkan total jumlah tujuan dalam konfigurasi dan jumlah tujuan yang aktif.

{
  "multicloudDataTransferConfig": [
    {
      "name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
      "createTime": "2025-05-14T10:16:22.761275571Z",
      "updateTime": "2025-05-14T10:16:25.872465362Z",
      "etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
      "description": "sample config",
      "destinationsCount": 1,
      "destinationsActiveCount": 1,
      "services": {
        "cloud-sql": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "DELETING"
            }
          ]
        },
        "cloud-storage": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "ADDING"
            }
          ]
        },
        "compute-engine": {
          "states": [
            {
              "state": "ACTIVE"
            }
          ]
        }
      }
    }
  ]
}

Status layanan dapat berupa salah satu dari berikut:

  • ADDING: layanan sedang ditambahkan.
  • DELETING: layanan sedang dihapus.
  • ACTIVE: layanan dikonfigurasi untuk penagihan Data Transfer Essentials.

Memperbarui konfigurasi

Untuk menambahkan atau menghapus layanan dari konfigurasi, gunakan salah satu cara berikut:

gcloud

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

Untuk menentukan layanan, gunakan salah satu opsi berikut:

  • services: menggantikan layanan dalam konfigurasi dengan daftar yang ditentukan
  • update-services: menambahkan layanan yang ditentukan ke konfigurasi
  • remove-services: menghapus layanan yang ditentukan dari konfigurasi
  • clear-services: menghapus semua layanan dari konfigurasi
gcloud network-connectivity multicloud-data-transfer-configs update CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,... |
        --update-services=SERVICE-A,... |
        --remove-services=SERVICE-A,... |
        --clear-services

Ganti kode berikut:

  • CONFIGURATION_NAME: nama konfigurasi yang ingin Anda perbarui.
  • LOCATION: region konfigurasi.
  • DESCRIPTION: deskripsi konfigurasi dan tujuannya.
  • SERVICE-A,...: serangkaian string yang mewakili layanan yang ingin Anda tambahkan atau hapus dari konfigurasi. Untuk mengetahui string yang valid, lihat Layanan dan wilayah yang didukung. Gunakan clear-services untuk menghapus semua layanan dari konfigurasi.

API

Gunakan metode multicloudDataTransferConfigs.update.

PATCH 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 konfigurasi.
  • DESCRIPTION: deskripsi konfigurasi dan tujuannya.
  • SERVICE-A: serangkaian string yang merepresentasikan layanan yang ingin Anda tambahkan atau hapus dari konfigurasi. Untuk mengetahui string yang valid, lihat Layanan dan wilayah yang didukung.

Selain itu, untuk mencegah agar sekumpulan kolom tertentu tidak ditimpa selama operasi update, Anda dapat menggunakan opsi updateMask, yang mengikuti format fieldMask.

Perubahan pada konfigurasi Data Transfer Essentials akan diterapkan dalam waktu sekitar 24 jam.

Menghapus konfigurasi

Anda dapat menghapus konfigurasi hanya setelah menghapus semua tujuan yang terkait dengannya.

Untuk menghapus konfigurasi, gunakan salah satu cara berikut:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
    --location=LOCATION

API

Gunakan metode multicloudDataTransferConfigs.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

Mengelola tujuan

Anda dapat mencantumkan tujuan Data Transfer Essentials di project, memeriksa status tujuan, memperbarui tujuan, atau menghapusnya.

Mencantumkan tujuan dalam project

Untuk mencantumkan semua tujuan dalam project, gunakan salah satu cara berikut:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations list \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

Ganti kode berikut:

  • CONFIGURATION_NAME: nama konfigurasi yang tujuannya ingin Anda cantumkan
  • LOCATION: region konfigurasi

API

Gunakan metode multicloudDataTransferConfigs.destinations.list.

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

Ganti kode berikut:

  • PROJECT_ID: ID project Anda
  • LOCATION: region konfigurasi
  • CONFIGURATION_NAME: nama konfigurasi yang tujuannya ingin Anda cantumkan

Melihat detail tujuan

Untuk melihat detail tujuan, gunakan salah satu cara berikut:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

Ganti kode berikut:

  • DESTINATION_NAME: nama tujuan
  • CONFIGURATION_NAME: nama konfigurasi yang tujuannya ingin Anda lihat
  • LOCATION: region konfigurasi

Contoh berikut menunjukkan bahwa endpoint yang ditentukan untuk destination1 valid dan tujuan ditambahkan pada waktu yang ditunjukkan oleh effectiveTime.

createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
  csp: aws
  state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
  states:
  - effectiveTime: '2025-05-29T07:00:00Z'
    state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…

API

Gunakan metode multicloudDataTransferConfigs.destinations.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

Ganti kode berikut:

  • PROJECT_ID: ID project Anda
  • LOCATION: region konfigurasi
  • CONFIGURATION_NAME: nama konfigurasi
  • DESTINATION_NAME: nama tujuan

Contoh output berikut menunjukkan bahwa endpoint yang ditentukan untuk destination1 valid dan tujuan sedang ditambahkan pada waktu yang ditunjukkan oleh effectiveTime.

{
  "destination": [
    {
      "name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
      "createTime": "2025-05-14T10:18:16.941520739Z",
      "updateTime": "2025-05-14T10:18:20.028116272Z",
      "etag": "tag1",
      "description": "sample destination",
      "ipPrefix": "203.0.113.0/24",
      "endpoints": [
        {
          "asn": 16509,
          "csp": "aws",
          "state": "VALID"
        }
      ],
      "stateTimeline": {
        "states": [
          {
            "state": "ADDING",
            "effectiveTime": "2025-05-29T07:00:00Z"
          }
        ]
      }
    }
  ]
}

Untuk tujuan, statusnya dapat berupa salah satu dari berikut:

  • ADDING: tujuan sedang ditambahkan.
  • DELETING: tujuan sedang dihapus.
  • SUSPENDING: tujuan ditangguhkan berdasarkan audit.
  • ACTIVE: tujuan dipertimbangkan untuk penagihan Data Transfer Essentials.
  • SUSPENDED: tujuan dihapus atau melanggar persyaratan penggunaan dan tidak akan dipertimbangkan untuk penagihan Data Transfer Essentials.

Untuk endpoint, statusnya dapat berupa salah satu dari berikut:

  • VALID: kombinasi nilai ASN dan CSP valid.
  • INVALID: kombinasi nilai ASN dan CSP tidak valid.

Jika status untuk satu endpoint adalah VALID, maka tujuan dianggap memenuhi syarat untuk penagihan Data Transfer Essentials.

Jika status semua endpoint adalah INVALID, maka tujuan dianggap tidak memenuhi syarat untuk penagihan Dasar-Dasar Transfer Data. Dalam hal ini, status tujuan ditetapkan ke SUSPENDING atau SUSPENDED, bergantung pada apakah status saat ini adalah ADDING atau ACTIVE. Traffic ke tujuan tersebut diperlakukan sebagai traffic internet reguler.

Memperbarui tujuan

Tujuan harus memiliki minimal satu endpoint dan tidak boleh memiliki lebih dari lima endpoint.

Untuk menambahkan atau menghapus endpoint dari tujuan, gunakan salah satu cara berikut:

gcloud

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

Untuk menentukan endpoint, gunakan salah satu opsi berikut. Anda dapat menentukan tanda add-endpoints atau remove-endpoints beberapa kali dalam perintah yang sama.

  • endpoints: menggantikan endpoint di tujuan dengan daftar yang ditentukan
  • add-endpoints: menambahkan endpoint yang ditentukan ke tujuan
  • remove-endpoints: menghapus endpoint yang ditentukan dari tujuan
gcloud network-connectivity multicloud-data-transfer-configs destinations update DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP |
        --add-endpoints=asn=ASN,csp=CSP |
        --remove-endpoints=asn=ASN,csp=CSP

Ganti kode berikut:

  • DESTINATION_NAME: nama tujuan.
  • CONFIGURATION_NAME: nama konfigurasi yang ingin Anda perbarui.
  • LOCATION: region konfigurasi.
  • DESCRIPTION: deskripsi tujuan dan tujuannya.
  • IP_PREFIX: awalan IP tujuan yang ditentukan sebagai rentang atau nilai.

  • Untuk setiap endpoint, tentukan hal berikut:

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

API

Gunakan metode multicloudDataTransferConfigs.destinations.update.

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ip_prefix": "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 tujuan.
  • 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 atau hapus endpoint yang tidak ingin Anda pertahankan di tujuan:

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

Selain itu, untuk mencegah agar sekumpulan kolom tertentu tidak ditimpa selama operasi update, Anda dapat menggunakan opsi updateMask, yang mengikuti format fieldMask.

Pembaruan pada tujuan Data Transfer Essentials dan konfigurasi terkait akan diterapkan dalam waktu sekitar 24 jam.

Menghapus tujuan

Untuk menghapus tujuan, gunakan salah satu cara berikut:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

API

Gunakan metode multicloudDataTransferConfigs.destinations.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME