Menggunakan retensi data dengan Apigee Hybrid

Topik ini menjelaskan cara mengonfigurasi penginstalan Apigee Hybrid baru untuk kepatuhan kedudukan data.

Tentang residensi data

Mulai versi campuran 1.12, Anda dapat menggunakan retensi data dengan penginstalan campuran Apigee baru. Anda tidak dapat mengonversi penginstalan yang ada untuk menggunakan retensi data.

Residensi data memenuhi persyaratan kepatuhan dan peraturan dengan memungkinkan Anda menentukan lokasi geografis (region) tempat data Apigee disimpan. Dengan residensi data, memilih lokasi platform kontrol akan memastikan bahwa semua konten pelanggan disimpan dalam region yang ditentukan. Lihat juga Pengantar residensi data.

Langkah-langkah dasar untuk konfigurasi residensi data

Untuk mengonfigurasi Apigee Hybrid untuk retensi data, Anda perlu mengikuti beberapa langkah dasar, termasuk:

Membuat organisasi Apigee dengan retensi data

Saat membuat organisasi Apigee, Anda memiliki opsi untuk mengaktifkan organisasi dengan kemampuan retensi data. Untuk membuat organisasi dengan residensi data, Anda harus menentukan dua atribut lokasi utama: lokasi platform kontrol dan region data konsumen. Untuk mengetahui detailnya, lihat Langkah 2: Membuat organisasi.

Membuat lingkungan menggunakan Apigee API

Jika membuat lingkungan baru menggunakan Apigee API, Anda harus menentukan lokasi platform kontrol. Lihat Membuat lingkungan. Jika Anda menggunakan UI untuk membuat lingkungan, tidak ada langkah khusus yang diperlukan.

Mengaktifkan pipeline data baru

Jika retensi data diaktifkan untuk organisasi hybrid 1.13.1 baru, Anda harus mengaktifkan fitur pipeline data baru. Fitur ini memungkinkan data analisis dan debug dikirim ke bidang kontrol Apigee. Untuk mengaktifkan pipeline data, ikuti petunjuk di Analytics dan debug pengumpulan data dengan retensi data.

Perhatikan bahwa Anda

Mengonfigurasi file penggantian

Jika menggunakan organisasi hybrid v1.13.1 baru yang mengaktifkan retensi data, Anda harus menambahkan properti konfigurasi ini ke setiap file penggantian dan menerapkannya:

Contoh:

instanceID: "my_hybrid_example"
namespace: apigee

gcp:
  projectID: hybrid-example
  region: us-central1

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

contractProvider: https://us-apigee.googleapis.com
newDataPipeline:
  debugSession: true
  analytics: true

Lihat Langkah 6: Membuat penggantian

Saat memanggil Apigee API

Saat melakukan panggilan curl ke Apigee API untuk melakukan tugas dalam penginstalan campuran, Anda harus memanggil API dari dalam lokasi platform kontrol:

curl -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups"

Contoh:

curl -H "Authorization: Bearer $TOKEN" \
  "https://us-apigee.googleapis.com/v1/organizations/my-hybrid-org/envgroups"

Daftar URL yang diizinkan

Anda harus mengaktifkan rute proxy non-forward untuk retensi data Apigee Hybrid. Rute ini dapat berupa NAT dengan daftar yang diizinkan untuk:

  • iamcredentials.googleapis.com
  • oauth2.googleapis.com

Jika menggunakan proxy penerusan dengan retensi data, Anda harus mengizinkan:

Mengaktifkan pengumpulan data analisis dan debug dengan residensi data

Untuk mengaktifkan pengumpulan data analisis dan debug, ikuti petunjuk di Pengumpulan data analisis dan debug dengan retensi data.