Saat membuat langganan, Anda melampirkan langganan ke topik, dan pelanggan dapat menerima pesan dari langganan. Untuk menghentikan pelanggan menerima pesan, Anda dapat melepaskan langganan dari topik.
Sebelum memulai
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang diperlukan guna melepaskan langganan, minta administrator untuk memberi Anda peran IAM Pub/Sub Editor (roles/pubsub.editor) pada topik.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditentukan ini berisi izin
pubsub.topics.detachSubscription
,
yang diperlukan untuk
melepaskan langganan.
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Anda dapat mengonfigurasi kontrol akses di tingkat project dan di tingkat resource individual. Anda dapat membuat langganan di satu project dan melampirkannya ke topik yang berada di project lain. Pastikan Anda memiliki izin yang diperlukan untuk setiap project.
Melepaskan langganan dari topik
Anda dapat melepaskan langganan dari topik menggunakan Cloud de Confiance konsol, Google Cloud CLI, library klien, atau Pub/Sub API.
Konsol
Untuk melepaskan langganan, ikuti langkah-langkah berikut:
Di Cloud de Confiance konsol, buka halaman Topics.
Pilih topik yang langganannya ingin Anda lepaskan.
Di tab Subscriptions, pilih langganan yang akan dilepaskan.
Di halaman Subscription details, klik Detach.
Di dialog yang muncul, klik Detach lagi.
gcloud
-
Di konsol, aktifkan Cloud Shell. Cloud de Confiance
Di bagian bawah konsol Cloud de Confiance , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.
-
Untuk melepaskan langganan, gunakan perintah
gcloud pubsub topics detach-subscription:gcloud pubsub topics detach-subscription SUBSCRIPTION_ID
Jika permintaan berhasil, command line akan menampilkan konfirmasi:
Detached subscription [SUBSCRIPTION_ID].
REST
Untuk melepaskan langganan, gunakan projects.subscriptions.detachmetode.
Permintaan:
Permintaan harus diautentikasi dengan token akses di header Authorization. Untuk mendapatkan token akses untuk
Kredensial Default Aplikasi saat ini, gunakan perintah
gcloud auth application-default print-access-token.
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:detach Authorization: Bearer ACCESS_TOKEN
Dengan:
- PROJECT_ID adalah project ID Anda.
- SUBSCRIPTION_ID adalah subscription ID Anda.
Respons:
Jika permintaan berhasil, responsnya adalah objek JSON kosong.
C++
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C++ di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi C++ API Pub/Sub.
C#
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi C# API Pub/Sub.
Go
Contoh berikut menggunakan versi utama library klien Go Pub/Sub (v2). Jika Anda masih menggunakan library v1, lihat panduan migrasi ke v2. Untuk melihat daftar contoh kode v1, lihat contoh kode yang tidak digunakan lagi.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Go API Pub/Sub.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Java API Pub/Sub.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Node.js API Pub/Sub.
Node.ts
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Node.js API Pub/Sub.
PHP
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi PHP API Pub/Sub.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Python API Pub/Sub.
Ruby
Contoh berikut menggunakan library klien Ruby Pub/Sub v3. Jika Anda masih menggunakan library v2, lihat panduan migrasi ke v3. Untuk melihat daftar contoh kode Ruby v2, lihat contoh kode yang tidak digunakan lagi.
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di Panduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Ruby API Pub/Sub.
Layanan Pub/Sub mungkin memerlukan waktu beberapa menit untuk menyelesaikan pelepasan langganan dari topik.
Setelah layanan Pub/Sub melepaskan langganan dari topik, layanan Pub/Sub akan menghapus pesan apa pun yang disimpan untuk langganan tersebut. Anda tidak dapat mengambil pesan ini dari langganan atau melampirkan kembali langganan ke topik. Untuk mengosongkan kuota project, hapus langganan. Cloud de Confiance
Jika langganan dan topik berada di project yang berbeda, layanan Pub/Sub akan menambahkan entri ke log audit kedua project. Cloud de Confiance
Langkah berikutnya
- Membuat atau mengubah langganan dengan
gcloudperintah. - Membuat atau mengubah langganan dengan REST API.