Mengelola konfigurasi konektivitas pribadi

Di halaman ini, Anda akan mempelajari cara menggunakan Datastream API untuk membuat, mengambil informasi tentang, dan menghapus konfigurasi konektivitas pribadi.

Konfigurasi konektivitas pribadi berisi informasi yang digunakan Datastream untuk berkomunikasi dengan sumber data melalui jaringan pribadi (secara internal dalam Google Cloud, atau dengan sumber eksternal yang terhubung melalui VPN atau Interconnect). Komunikasi ini terjadi melalui koneksi peering Virtual Private Cloud (VPC).

Ada dua cara untuk menggunakan Datastream API. Anda dapat melakukan panggilan REST API atau menggunakan Google Cloud CLI (CLI).

Untuk melihat informasi tingkat tinggi tentang penggunaan gcloud untuk mengelola konfigurasi konektivitas pribadi Datastream, klik di sini.

Membuat konfigurasi konektivitas pribadi

Sebelum membuat konfigurasi konektivitas pribadi, pastikan Anda:

  • Memiliki jaringan VPC untuk melakukan peering ke jaringan pribadi Datastream. Untuk mengetahui informasi selengkapnya tentang cara membuat jaringan VPC, lihat Menggunakan Peering Jaringan VPC.
  • Memiliki rentang IP yang tersedia di jaringan VPC. Datastream menggunakan rentang IP ini untuk membuat peering VPC dengan VPC yang disediakan, sehingga rentang tidak dapat tumpang-tindih dengan subnet dalam VPC tersebut. Akibatnya, Datastream dapat berkomunikasi dengan sumber.

Ada dua parameter yang terkait dengan pembuatan konfigurasi konektivitas pribadi:

  • vpcName: Tentukan nama dan jalur jaringan VPC.
  • subnet: Berikan rentang IP yang tersedia di jaringan VPC.

Kode berikut menunjukkan permintaan untuk membuat konfigurasi konektivitas pribadi, dan menentukan metode konektivitas sebagai menggunakan peering VPC (vpcPeeringConfig).

REST

POST https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections?privateConnectionId=[private-connectivity configuration-id]
{
  "displayName": "[private-connectivity-configuration-display-name]",
  "vpcPeeringConfig": {
      "vpcName": "[name-and-path-of-VPC-network]",
      "subnet": "[subnet]"
  }
}

Contoh:

POST https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections?privateConnectionId=myPrivateConnection
{
  "displayName": "my private connectivity configuration",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }
}

Setelah konfigurasi konektivitas pribadi dibuat, Anda dapat melihat informasi tentangnya dengan memanggil metode privateConnections/get. Output Anda akan muncul, mirip dengan berikut ini:

{
  "name": "projects/projectId/location/us-central1/privateConnections/myPrivateConnection",
  "createTime": "2019-12-22T16:17:37.159786963Z",
  "updateTime": "2019-12-22T16:17:37.159786963Z",
  "displayName": "my private connectivity configuration",
  "state": "CREATED",
  "vpcPeeringConfig": {
    "vpcName": "projects/my-project/global/networks/my-vpc",
    "subnet": "10.11.12.13/29"
  }  
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk membuat konfigurasi konektivitas pribadi, klik di sini.

Mendapatkan informasi tentang konfigurasi konektivitas pribadi

Kode berikut menunjukkan permintaan untuk mengambil informasi tentang konfigurasi konektivitas pribadi yang telah dibuat.

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id]

Contoh:

GET https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang konfigurasi konektivitas pribadi Anda, klik di sini.

Mencantumkan konfigurasi konektivitas pribadi

Kode berikut menunjukkan permintaan untuk mengambil informasi tentang semua konfigurasi konektivitas pribadi Anda.

REST

GET https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang semua konfigurasi konektivitas pribadi Anda, klik di sini.

Menghapus konfigurasi konektivitas pribadi

Kode berikut menunjukkan permintaan untuk menghapus konfigurasi konektivitas pribadi. Setelah konfigurasi dihapus, profil koneksi apa pun yang menggunakan konfigurasi tersebut tidak akan berfungsi. Selain itu, semua aliran data yang menggunakan profil koneksi ini tidak akan dapat dioperasikan.

Untuk mengatasi masalah ini, tetapkan konfigurasi konektivitas pribadi yang berbeda ke setiap profil koneksi. Untuk informasi selengkapnya, lihat Memperbarui profil koneksi.

REST

DELETE https://datastream.googleapis.com/v1/projects/[project-id]/locations/
[location]/privateConnections/[private-connectivity-configuration-id] {"force": true}

Contoh:

DELETE https://datastream.googleapis.com/v1/projects/myProjectId/locations/
us-central1/privateConnections/myPrivateConnection {"force": true}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk menghapus konfigurasi konektivitas pribadi, klik di sini.

Langkah selanjutnya