Menghapus organisasi Apigee

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Halaman ini menjelaskan cara menghapus sepenuhnya organisasi Apigee dari project Google Cloud, termasuk langkah-langkah lanjutan yang diperlukan untuk merilis resource jaringan yang tidak dibersihkan oleh Apigee sendiri. Pembersihan pasca-penghapusan yang perlu Anda lakukan bergantung pada cara organisasi disediakan:

• Organisasi yang disediakan dengan peering VPC diaktifkan juga memiliki koneksi peering VPC Jaringan Layanan antara VPC Anda dan jaringan tenant Apigee. Koneksi tersebut, serta rentang peering yang dicadangkan dan jaringan VPC yang terkait dengannya, akan tetap ada setelah Anda menghapus organisasi dan harus dibersihkan secara terpisah jika Anda tidak lagi membutuhkannya. Lihat Tindak lanjut: organisasi yang disediakan dengan peering VPC.

• Organisasi yang disediakan dengan peering VPC yang dinonaktifkan menggunakan Private Service Connect, bukan koneksi Service Networking, sehingga tidak ada peering produsen yang perlu dihapus. Anda tetap harus menghapus load balancer Private Service Connect northbound yang Anda buat saat menyediakan organisasi — aturan penerusan, proxy HTTPS target, peta URL, layanan backend, grup endpoint jaringan PSC, sertifikat SSL, dan alamat IP yang dicadangkan — atau aturan penerusan dan alamat IP yang dicadangkan akan terus dikenai biaya. Lihat Tindak lanjut: organisasi yang disediakan tanpa peering VPC.

Sebelum memulai menunjukkan cara menentukan kategori organisasi Anda.

Peringatan: Menghapus organisasi Apigee bersifat destruktif. Semua resource dalam organisasi — termasuk proxy API, lingkungan, grup lingkungan, developer, aplikasi, produk API, keystore, key-value map, dan instance — akan dihapus. Untuk organisasi berbayar, penghapusan adalah penghapusan sementara dengan periode retensi (lihat Periode retensi dan penyediaan ulang); untuk organisasi evaluasi, penghapusan dilakukan secara langsung. Lihat organizations.delete untuk mengetahui perilaku selengkapnya. Penghapusan tidak dapat diurungkan setelah periode retensi berlalu.

Sebelum memulai

Izin IAM yang diperlukan

• Di organisasi Apigee (biasanya APIGEE_PROJECT_ID): apigee.organizations.delete. Izin ini disertakan dalam peran roles/apigee.admin, yang dijelaskan dalam panduan peran Apigee sebagai satu-satunya peran yang dapat membuat, menghapus, atau memperbarui organisasi.

• Selain itu, jika organisasi Anda disediakan dengan peering VPC yang diaktifkan dan Anda berencana untuk membersihkan koneksi Service Networking, rentang peering VPC, atau jaringan VPC seperti yang dijelaskan dalam Tindak lanjut: organisasi yang disediakan dengan peering VPC: pada project yang memiliki jaringan VPC yang di-peering (project jaringan, yang mungkin berbeda dari project Apigee Anda dalam penyiapan VPC Bersama), servicenetworking.services.deleteConnection, compute.globalAddresses.delete, dan compute.networks.delete.

Menghapus resource dependen terlebih dahulu

Sebelum menghapus organisasi, hapus resource yang harus dihapus terlebih dahulu oleh Apigee:

• Hapus semua instance Apigee yang terkait dengan organisasi. Lihat Menghapus instance terkelola.

• Hapus semua lampiran endpoint yang terkait dengan organisasi. Lihat Menghapus lampiran endpoint.

Cadangkan data yang ingin Anda simpan

Cadangkan data atau resource cakupan organisasi yang mungkin Anda perlukan nanti. Setelah periode retensi berlalu, data yang disimpan di organisasi tidak dapat dipulihkan.

Menentukan apakah organisasi Anda menggunakan peering VPC

Pembersihan lanjutan yang perlu Anda lakukan setelah menghapus organisasi bergantung pada apakah organisasi disediakan dengan peering VPC yang diaktifkan. Baca konfigurasi organisasi dengan API organizations.get sebelum Anda menghapusnya:

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Panggilan REST Apigee ini dan semua panggilan REST Apigee lainnya di halaman ini menargetkan endpoint apigee.googleapis.com global. Jika organisasi Anda berada di region residensi data, ganti endpoint regional yang sesuai di setiap sampel.

Catatan penggunaan penting untuk residensi data: Untuk mendukung residensi data, saat menyediakan atau menggunakan Apigee, Anda harus menggunakan endpoint regional. Untuk mengetahui informasi selengkapnya, lihat Menggunakan endpoint regional untuk residensi data.

Cari kolom disableVpcPeering dalam respons:

• Jika respons berisi "disableVpcPeering": true, organisasi disediakan tanpa peering VPC. Setelah Anda menghapus organisasi, ikuti Tindak lanjut: organisasi yang disediakan tanpa peering VPC.

• Jika kolom ini adalah false atau tidak ada, organisasi telah disediakan dengan peering VPC. Catat dua nilai tambahan berikut dari respons yang sama; Anda akan membutuhkannya selama pembersihan:

  • Kolom authorizedNetwork, yang mengidentifikasi jaringan VPC yang di-peering dengan Apigee. Jenis fungsi ini muncul dalam salah satu dari dua bentuk:
    • Jalur resource lengkap projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, yang mengenkode project jaringan dan nama jaringan. Formulir ini digunakan saat jaringan berada di project yang berbeda dari organisasi Apigee Anda — paling umum dalam penyiapan VPC Bersama, di mana jaringan berada di project host.
    • Hanya nama jaringan (misalnya, apigee-network). Jika hanya ada nama, jaringan berada di project Google Cloud yang sama dengan organisasi Apigee Anda — perlakukan project tersebut (APIGEE_PROJECT_ID) sebagai NETWORK_PROJECT_ID untuk langkah-langkah pembersihan.
    Perhatikan bahwa authorizedNetwork hanya ditetapkan pada organisasi yang di-peering VPC.
  • Nama alamat global yang awalnya Anda cadangkan untuk rentang peering VPC (misalnya, apigee-range). Anda mencadangkan alamat ini saat pertama kali menyediakan organisasi.

  Setelah Anda menghapus organisasi, ikuti Tindak lanjut: organisasi yang disediakan dengan peering VPC.

Menghapus organisasi Apigee

Panggil API organizations.delete untuk menghapus organisasi. Panggilan ini menampilkan operasi yang berjalan lama dan, untuk organisasi evaluasi, melakukan penghapusan langsung; untuk organisasi berbayar (Langganan atau Bayar sesuai penggunaan), panggilan ini melakukan penghapusan sementara yang tunduk pada periode retensi.

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION"

Untuk menggunakan periode retensi minimum (24 jam) bagi organisasi berbayar, tambahkan parameter kueri retention:

curl -X DELETE \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION?retention=MINIMUM"

Respons berisi operasi yang berjalan lama. Anda dapat melakukan polling dengan organizations.operations.get.

Tindak lanjut: organisasi yang disediakan tanpa peering VPC

Jika kolom disableVpcPeering organisasi adalah true, menghapus organisasi tidak akan merilis resource Service Networking, karena organisasi yang disediakan tanpa peering VPC tidak pernah memiliki koneksi Service Networking, dan tidak ada peering produsen yang perlu dihapus.

Anda tetap harus menghapus load balancer Private Service Connect northbound yang Anda buat di project Anda sendiri saat menyediakan organisasi. Resource ini tidak dimiliki oleh Apigee, dan organizations.delete tidak merilis satu pun dari resource tersebut. Hapus dalam urutan dependensi terbalik:

1. Aturan penerusan
2. Proxy HTTPS target
3. Peta URL
4. Layanan backend
5. Grup endpoint jaringan PSC
6. Sertifikat SSL
7. Alamat IP yang dicadangkan

Perhatian: Membiarkan aturan penerusan dan alamat IP yang dicadangkan tetap ada akan terus dikenai biaya, dan alamat yang dicadangkan akan terus menggunakan kuota IP global untuk project Anda. Grup endpoint jaringan PSC dibiarkan mengarah ke lampiran layanan yang dihapus dan harus dibersihkan secara eksplisit.

Setelah pembersihan northbound selesai, lanjutkan ke Periode retensi dan penyediaan ulang.

Tindak lanjut: organisasi yang disediakan dengan peering VPC

Penting: Topik ini hanya berlaku untuk organisasi yang dibuat dengan peering VPC yang diaktifkan. Lihat juga Opsi jaringan Apigee.

Menghapus organisasi Apigee tidak akan melepaskan koneksi peering VPC Jaringan Layanan yang Anda buat saat organisasi disediakan. Koneksi tetap berada di jaringan VPC Anda, bersama dengan rentang peering yang dicadangkan dan jaringan VPC apa pun yang Anda dedikasikan untuk peering. Jika Anda tidak lagi memerlukan resource ini, selesaikan pembersihan dengan mengikuti prosedur kanonis Mengonfigurasi akses layanan pribadi dan Service Networking. Bagian selanjutnya hanya memberikan nilai dan peringatan khusus untuk penghapusan Apigee.

Mengumpulkan nilai yang Anda butuhkan

Langkah-langkah pembersihan berikut menggunakan kembali beberapa nilai yang sama untuk dimasukkan ke dalam prosedur dalam panduan Jaringan Layanan dan VPC yang ditautkan. Tentukan setiap nilai satu kali, lalu tetapkan sebagai variabel shell agar Anda dapat menyalin perintah yang ditautkan secara verbatim:

• NETWORK_PROJECT_ID — project yang memiliki jaringan VPC yang di-peering. Project ini tidak selalu sama dengan project layanan Apigee Anda: dalam penyiapan VPC Bersama, jaringan berada di project host. Dapatkan dari nilai authorizedNetwork yang Anda catat di Menentukan apakah organisasi Anda menggunakan peering VPC:

  • Jika authorizedNetwork adalah jalur resource lengkap projects/NETWORK_PROJECT_ID/global/networks/NETWORK_NAME, ambil NETWORK_PROJECT_ID dari jalur tersebut.
  • Jika authorizedNetwork hanya nama jaringan (misalnya, apigee-network), jaringan berada dalam project yang sama dengan organisasi Apigee; gunakan project Apigee Anda (APIGEE_PROJECT_ID).

• NETWORK_NAME — nama jaringan VPC (misalnya, apigee-network). Ambil dari jalur lengkap di authorizedNetwork, atau gunakan nilai kosong jika authorizedNetwork hanya berupa nama.

• APIGEE_RANGE_NAME — nama alamat global yang dialokasikan untuk rentang peering VPC (misalnya, apigee-range) saat organisasi disediakan. Anda dapat melihat rentang yang dicadangkan yang dilampirkan ke peering dalam daftar reservedPeeringRanges yang ditampilkan oleh gcloud services vpc-peerings list.

• NETWORK_PROJECT_NUMBER — nomor project numerik untuk NETWORK_PROJECT_ID. REST API Service Networking memerlukan nomor project (bukan project ID) di kolom consumerNetwork:

  gcloud projects describe NETWORK_PROJECT_ID \
    --format="value(projectNumber)"

Setiap kali prosedur tertaut meminta jaringan, project jaringan, atau jaringan konsumen, ganti nilai ini.

Peringatan yang berlaku untuk penghapusan Apigee

Koneksi Service Networking dan rentang peering yang dicadangkan dapat dibagikan ke layanan Google Cloud lainnya. Setiap layanan Google Cloud di jaringan yang menggunakan Akses Layanan Pribadi — Cloud SQL, Memorystore, AlloyDB, Filestore, dan Apigee — berbagi satu koneksi Jaringan Layanan per VPC dan dapat berbagi rentang yang dialokasikan di dalamnya. Menghapus koneksi akan menghapus peering produsen untuk semua layanan ini, dan merilis rentang akan mengambil kembali ruang IP yang mungkin masih digunakan.

Sebelum merilis salah satu resource, gunakan Berapa banyak alokasi saya yang digunakan? dalam panduan Mengonfigurasi akses layanan pribadi untuk memverifikasi siapa yang menggunakannya. Jika Anda tidak dapat mengonfirmasi bahwa hanya Apigee yang menggunakan resource tersebut, biarkan resource tersebut tetap ada.

Menyelesaikan pembersihan

Ikuti prosedur yang ditautkan, dengan mengganti variabel dari Mengumpulkan nilai yang Anda perlukan:

• Hapus koneksi Service Networking. Ikuti Menghapus koneksi pribadi. Karena Anda telah menghapus organisasi Apigee di bagian Menghapus organisasi Apigee, prasyarat panduan untuk menghapus instance layanan terpenuhi untuk organisasi evaluasi, yang akan segera dihapus. Untuk organisasi berbayar, penghapusan adalah penghapusan sementara, dan penghapusan koneksi hanya berhasil setelah periode retensi berlalu — lihat Periode retensi dan penyediaan ulang, atau hapus organisasi dengan ?retention=MINIMUM untuk mempersingkat periode menjadi 24 jam. Saat prosedur meminta jaringan dan project jaringan, gunakan NETWORK_NAME dan NETWORK_PROJECT_ID; saat panggilan REST services.connections.deleteConnection yang mendasarinya meminta consumerNetwork, gunakan projects/NETWORK_PROJECT_NUMBER/global/networks/NETWORK_NAME.

• (Opsional) Merilis rentang peering yang dicadangkan. Ikuti Menghapus rentang alamat IP yang dialokasikan, menggunakan APIGEE_RANGE_NAME dan NETWORK_PROJECT_ID. Rentang yang dicadangkan adalah resource milik pelanggan yang tetap ada setelah organisasi Apigee dan koneksi Service Networking dihapus; membiarkannya tetap ada tidak akan mengganggu layanan Google Cloud apa pun.

• (Opsional) Hapus jaringan VPC. Jika Anda merutekan traffic northbound melalui grup instance terkelola atau load balancer internal di jaringan ini, hapus resource tersebut terlebih dahulu, atau penghapusan jaringan akan gagal dengan error resource dependen: aturan penerusan, proxy target, peta URL, layanan backend, grup instance terkelola, template instance, health check, aturan firewall, dan alamat yang dicadangkan. Kemudian, ikuti Menghapus jaringan dalam panduan jaringan VPC, menggunakan NETWORK_NAME dan NETWORK_PROJECT_ID.

Catatan: Jika penghapusan koneksi gagal dengan error "resource produsen layanan masih digunakan", berarti produsen Akses Layanan Pribadi lain di jaringan ini masih menahan koneksi, atau organisasi Apigee Anda masih dalam periode retensi dan resource sisi produsennya belum sepenuhnya dirilis. Dalam kasus pertama, gunakan Berapa banyak alokasi saya yang digunakan? untuk mengidentifikasi produsen, dan jangan memaksakan penghapusan. Dalam kasus kedua, tunggu hingga periode retensi berlalu (atau hapus organisasi dengan ?retention=MINIMUM untuk mempersingkat periode menjadi 24 jam) sebelum mencoba lagi.

Periode retensi dan penyediaan ulang

Seperti yang didokumentasikan dalam referensi organizations.delete:

• Apigee akan segera menghapus organisasi evaluasi.
• Apigee menghapus sementara organisasi berbayar (Langganan atau Bayar sesuai penggunaan) dengan periode retensi default 7 hari. Selama periode retensi, Anda dapat memulihkan organisasi dengan mengajukan tiket dukungan ke Apigee. Meneruskan ?retention=MINIMUM pada permintaan penghapusan akan mempersingkat periode menjadi 24 jam.
• Anda tidak dapat membuat ulang organisasi Apigee di project Google Cloud yang sama selama periode retensi.

Langkah berikutnya

Referensi Apigee:

• Pengantar penyediaan Apigee
• Opsi jaringan Apigee (peering VPC vs. Private Service Connect)
• Memahami rentang peering
• Menggunakan jaringan VPC bersama

Referensi Service Networking dan Akses Layanan Pribadi:

• Ringkasan akses layanan pribadi
• Mengonfigurasi akses layanan pribadi
• Mulai menggunakan Service Networking
• Referensi API Service Networking: services.connections
• Network Analyzer: Ringkasan pemakaian alamat IP akses layanan pribadi