Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan data residency 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 harus mengikuti beberapa langkah dasar, termasuk:

Membuat organisasi Apigee dengan retensi data
Membuat lingkungan menggunakan Apigee API
Mengaktifkan pipeline data baru
Mengonfigurasi file penggantian

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. Anda juga harus menentukan jenis penagihan. Untuk mengetahui detailnya, lihat Langkah 2: Membuat organisasi.

Lokasi bidang kontrol: Anda harus menentukan lokasi penyimpanan konten inti pelanggan seperti paket proxy. Untuk mengetahui daftarnya, lihat Region bidang kontrol Apigee API yang tersedia.

Lokasi bidang kontrol adalah lokasi endpoint layanan, misalnya us untuk Amerika Serikat.

Tabel berikut mencantumkan wilayah dan wilayah hukum hosting yang tersedia untuk platform kontrol Apigee.

Amerika

Deskripsi wilayah hukum hosting bidang kontrol	Nama wilayah hukum hosting bidang kontrol	Detail
Amerika Serikat	`us (multiple regions in United States)`	Endpoint layanan: `us-apigee.googleapis.com`
Kanada	`ca (multiple regions in Canada)`	Endpoint layanan: `ca-apigee.googleapis.com`

Deskripsi region data konsumen	Nama wilayah data konsumen	Detail
Iowa	`us-central1`	CO₂ Rendah
Oregon	`us-west1`	CO Rendah₂
Los Angeles	`us-west2`
Salt Lake City	`us-west3`
Las Vegas	`us-west4`
South Carolina	`us-east1`
Northern Virginia	`us-east4`
Columbus	`us-east5`
Dallas	`us-south1`
Montréal	`northamerica-northeast1`	CO Rendah₂
Toronto	`northamerica-northeast2`	CO Rendah₂

Eropa

Deskripsi wilayah hukum hosting bidang kontrol	Nama wilayah hukum hosting bidang kontrol	Detail
Uni Eropa	`eu (multiple regions in the European Union)`	Endpoint layanan: `eu-apigee.googleapis.com`
Jerman	`de (multiple regions in Germany)`	Endpoint layanan: `de-apigee.googleapis.com`
Prancis	`fr (single region europe-west9)`	Endpoint layanan: `fr-apigee.googleapis.com`
Swiss	`ch (single region europe-west6)`	Endpoint layanan: `ch-apigee.googleapis.com`

Deskripsi region data konsumen	Nama wilayah data konsumen	Detail
Belgia	`europe-west1`	CO Rendah₂
Frankfurt	`europe-west3`	CO Rendah₂
Belanda	`europe-west4`
Zurich	`europe-west6`	CO Rendah₂
Milan	`europe-west8`
Paris	`europe-west9`	CO₂ Rendah
Turin	`europe-west12`
Warsawa	`europe-central2`
Madrid	`europe-southwest1`	CO₂ Rendah
Finlandia	`europe-north1`	CO Rendah₂

Asia Pasifik

Deskripsi wilayah hukum hosting bidang kontrol	Nama wilayah hukum hosting bidang kontrol	Detail
Australia	`au (multiple regions in Australia)`	Endpoint layanan: `au-apigee.googleapis.com`
India	`in (multiple regions in India)`	Endpoint layanan: `in-apigee.googleapis.com`
Jepang	`jp (multiple regions in Japan)`	Endpoint layanan: `jp-apigee.googleapis.com`

Deskripsi region data konsumen	Nama wilayah data konsumen	Detail
Sydney	`australia-southeast1`
Melbourne	`australia-southeast2`
Mumbai	`asia-south1`
Delhi	`asia-south2`
Tokyo	`asia-northeast1`
Osaka	`asia-northeast2`

Timur Tengah

Deskripsi wilayah hukum hosting bidang kontrol	Nama wilayah hukum hosting bidang kontrol	Detail
Arab Saudi	`sa (single region me-central2)`	Endpoint layanan: `sa-apigee.googleapis.com`
Israel	`il (single region me-west1)`	Endpoint layanan: `il-apigee.googleapis.com`

Deskripsi region data konsumen	Nama wilayah data konsumen	Detail
Dammam	`me-central2`
Tel Aviv	`me-west1`

Region data konsumen: Anda harus menentukan region tempat data konsumen API disimpan. Sub-region ini harus merupakan sub-region dari region bidang kontrol. Untuk mengetahui daftar region data konsumen yang tersedia, lihat Lokasi Apigee.
Jenis penagihan: Anda hanya dapat menggunakan retensi data dengan organisasi langganan berbayar.

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 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 residensi data.

Mengganti perubahan untuk mengaktifkan pipeline data baru

Tambahkan properti konfigurasi berikut ke setiap file penggantian dan terapkan:

contractProvider: Endpoint layanan untuk API pengelolaan Apigee. Contoh: https://us-apigee.googleapis.com.
newDataPipeline.debugSession: Tetapkan ke true untuk menggunakan pipeline data baru.
newDataPipeline.analytics: Tetapkan ke true untuk mengaktifkan analisis agar dapat menggunakan pipeline data baru.

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

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

CONTROL_PLANE_LOCATION.apigee-googleapis.com
ANALYTICS_REGION-pubsub.googleapis.com
URL yang diperlukan oleh Apigee Hybrid, lihat URL Google Cloud untuk mengizinkan Hybrid.

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.