Pelanggan menggunakan langganan Lite untuk membaca pesan dari topik Lite. Saat membuat langganan Lite, Anda melampirkan langganan tersebut ke topik Lite. Anda dapat melampirkan banyak langganan Lite ke satu topik Lite.
Ada dua jenis langganan:
- Langganan standar. Buat langganan standar jika Anda memiliki klien yang perlu membaca pesan dari topik topik Lite.
- Ekspor langganan. Buat langganan ekspor saat Anda perlu mengekspor pesan Lite ke Pub/Sub. Untuk mengetahui informasi selengkapnya, lihat artikel Mengekspor pesan Pub/Sub Lite ke Pub/Sub.
Properti langganan Lite
Langganan untuk topik Lite di level zona memiliki properti yang identik dengan langganan untuk topik Lite di level region, kecuali untuk hal berikut:
Jenis lokasi, zona, atau region, yang digunakan dalam nama resource. Contoh lokasi region adalah
us-central1
; contoh lokasi zona adalahus-central1-a
.Keandalan. Lihat Replikasi data dalam topik Lite untuk mempelajari lebih lanjut perbedaan keandalan antara topik regional dan zonal.
Persyaratan pengiriman untuk pesan
Kegagalan sementara dalam menulis pesan ke penyimpanan menyebabkan penayang mencoba mengirim pesan lagi. Percobaan ulang ini bersifat transparan bagi pengguna akhir. Langganan Lite memiliki properti persyaratan pengiriman yang mengubah cara langganan bereaksi terhadap percobaan ulang pesan ini. Anda dapat menetapkan properti ini ke salah satu dari dua opsi berikut:
Kirim pesan langsung. Dengan opsi ini diaktifkan, klien subscriber akan menerima semua pesan setelah pesan tersebut tiba di server. Proses ini tidak bergantung pada status pesan yang ditulis ke disk. Offset tidak digunakan kembali, tetapi pesan dengan offset yang tidak ditulis ke penyimpanan mungkin tidak dapat dibaca kembali setelah operasi penelusuran.
Kirim pesan setelah disimpan. Dengan opsi ini diaktifkan, pelanggan tidak akan menerima pesan hingga pesan tersebut ditulis ke disk. Pesan dijamin dapat dibaca kembali setelah operasi pencarian. Mengaktifkan opsi ini akan meningkatkan latensi menyeluruh untuk menerima pesan dari penayang ke pelanggan.
Panduan untuk memberi nama langganan
Nama resource Pub/Sub Lite secara unik mengidentifikasi resource Pub/Sub Lite, seperti topik, langganan, atau reservasi. Nama resource harus sesuai dengan format berikut:
projects/project-identifier/collection/ID
project-identifier
: Harus berupa project ID atau nomor project, yang tersedia dari konsol Google Cloud. Misalnya,my-cool-project
adalah project ID.123456789123
adalah nomor project.collection
: Harus salah satu daritopics
,subscriptions
, ataureservations
.ID
: Harus mematuhi panduan berikut:- Tidak diawali dengan string
goog
- Diawali dengan huruf
- Berisi antara 3 hingga 255 karakter
- Hanya berisi karakter berikut: Huruf
[A-Za-z]
, angka[0-9]
, tanda hubung-
, garis bawah_
, titik.
, tanda gelombang~
, tanda tambah+
, dan tanda persen%
Anda dapat menggunakan karakter khusus dalam daftar sebelumnya dalam nama resource tanpa encoding URL. Namun, Anda harus memastikan bahwa karakter khusus lainnya dienkode atau didekode dengan benar saat Anda menggunakannya di URL. Misalnya,
mi-tópico
adalah ID yang tidak valid. Namun,mi-t%C3%B3pico
valid. Format ini penting saat Anda melakukan panggilan REST.- Tidak diawali dengan string
Membuat langganan Lite
Langganan Lite harus berada di project dan lokasi yang sama dengan topik Lite tempat langganan Lite dilampirkan.
Untuk membuat topik Lite, lihat Membuat dan mengelola topik Lite.
Untuk mengetahui daftar lokasi yang tersedia, lihat Lokasi Pub/Sub Lite.
Anda dapat membuat langganan Lite dengan konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Untuk informasi tentang cara membuat langganan ekspor, lihat artikel Mengekspor pesan Pub/Sub Lite ke Pub/Sub.
Konsol
Buka halaman Langganan Lite.
Klik Buat langganan Lite.
Masukkan ID langganan Lite.
Pilih topik Lite untuk menerima pesan.
Pilih Kirim pesan segera atau Kirim pesan setelah disimpan.
Pilih jenis Offset awal.
Pilih Jenis pengiriman.
Klik Create.
gcloud
Untuk membuat langganan Lite, gunakan perintah
gcloud pubsub lite-subscriptions create
:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --delivery-requirement=DELIVERY_REQUIREMENT
Ganti kode berikut:
SUBSCRIPTION_ID: ID langganan Lite
LOCATION: nama lokasi yang didukung Pub/Sub Lite
TOPIC_ID: ID topik Lite yang akan dilampirkan ke langganan Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
ataudeliver-immediately
Jika permintaan berhasil, command line akan menampilkan konfirmasi:
Created [SUBSCRIPTION_ID].
Protokol
Untuk membuat langganan Lite, kirim permintaan POST
seperti berikut:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project dari project tempat membuat langganan Lite
LOCATION: nama lokasi yang didukung Pub/Sub Lite
SUBSCRIPTION_ID: ID langganan Lite
Tentukan kolom berikut dalam isi permintaan:
{ "topic": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Ganti DELIVERY_REQUIREMENT dengan deliver-after-stored
atau
deliver-immediately
.
Jika permintaan berhasil, responsnya adalah langganan Lite dalam format JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Setelah membuat langganan Lite ke topik Lite, Anda dapat menerima pesan dari langganan Lite.
Memperbarui langganan Lite
Anda dapat memperbarui langganan Lite dengan konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
Klik ID langganan Lite.
Di halaman Detail langganan Lite, klik Edit.
gcloud
Untuk memperbarui langganan Lite, gunakan perintah
gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT
Ganti kode berikut:
SUBSCRIPTION_ID: ID langganan Lite
LOCATION: nama lokasi langganan Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
ataudeliver-immediately
Jika permintaan berhasil, command line akan menampilkan langganan Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokol
Untuk memperbarui langganan Lite, kirim permintaan PATCH
seperti berikut:
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID?updateMask=deliveryConfig.deliveryRequirement Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project dari project dengan langganan Lite
LOCATION: nama lokasi langganan Lite
SUBSCRIPTION_ID: ID langganan Lite
Tentukan kolom berikut dalam isi permintaan:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Ganti DELIVERY_REQUIREMENT dengan deliver-after-stored
atau
deliver-immediately
.
Jika permintaan berhasil, responsnya adalah langganan Lite dalam format JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Melihat detail langganan Lite
Anda bisa mendapatkan detail tentang langganan Lite menggunakan konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
Klik ID langganan Lite.
Di halaman detail langganan Lite, klik tab Detail.
gcloud
Untuk mendapatkan detail tentang langganan Lite, gunakan perintah
gcloud pubsub lite-subscriptions describe
:
gcloud pubsub lite-subscriptions describe SUBSCRIPTION_ID \ --location=LOCATION
Ganti kode berikut:
SUBSCRIPTION_ID: ID langganan Lite
LOCATION: nama lokasi langganan Lite
Jika permintaan berhasil, command line akan menampilkan topik Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokol
Untuk mendapatkan detail tentang langganan Lite, kirim permintaan GET
seperti
berikut:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project project dengan langganan Lite
LOCATION: nama lokasi langganan Lite
SUBSCRIPTION_ID: ID langganan Lite
Jika permintaan berhasil, responsnya adalah topik Lite dalam format JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Mencantumkan langganan Lite
Anda dapat mencantumkan langganan Lite dalam project atau langganan Lite ke topik Lite.
Mencantumkan langganan Lite dalam project
Anda dapat mencantumkan langganan Lite dalam project menggunakan konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
gcloud
- Untuk mencantumkan langganan Lite dalam project, gunakan perintah
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Ganti LOCATION dengan nama lokasi langganan Lite.
Jika permintaan berhasil, command line akan menampilkan langganan Lite:
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokol
- Untuk mencantumkan langganan Lite dalam project, kirim permintaan
GET
seperti berikut:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project dari project dengan langganan Lite
Jika permintaan berhasil, responsnya adalah topik Lite dalam format JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Mencantumkan langganan Lite ke topik Lite
Anda dapat mencantumkan langganan Lite ke topik Lite menggunakan konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Lite Topics.
Pilih ID topik Lite.
Di halaman detail Topik Lite, bagian Langganan Lite menyertakan daftar langganan Lite ke topik Lite.
gcloud
- Untuk mencantumkan langganan Lite ke topik, gunakan perintah
gcloud pubsub lite-topics list-subscriptions
:
gcloud pubsub lite-topics list-subscriptions TOPIC_ID \ --location=LOCATION
Ganti kode berikut:
TOPIC_ID: ID topik Lite yang menjadi tempat langganan Lite disertakan
LOCATION: nama lokasi langganan Lite
Jika permintaan berhasil, command line akan menampilkan langganan Lite:
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokol
- Untuk mencantumkan langganan Lite ke topik Lite, kirim permintaan
GET
seperti berikut:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/lite-topics/TOPIC_ID/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project dari project dengan langganan Lite
LOCATION: nama lokasi langganan Lite
TOPIC_ID: ID topik Lite yang menjadi tempat langganan Lite disertakan
Jika permintaan berhasil, responsnya adalah daftar langganan Lite dalam format JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Menghapus langganan Lite
Anda dapat menghapus langganan Lite dengan Konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
Klik ID langganan Lite.
Di halaman Detail langganan Lite, klik Hapus.
Pada dialog yang muncul, klik Hapus untuk mengonfirmasi bahwa Anda ingin menghapus langganan Lite.
gcloud
Untuk menghapus langganan Lite, gunakan perintah
gcloud pubsub lite-subscriptions delete
:
Jalankan perintah
delete
:gcloud pubsub lite-subscriptions delete SUBSCRIPTION_ID \ --location=LOCATION
Ganti kode berikut:
SUBSCRIPTION_ID: ID langganan Lite
LOCATION: nama lokasi langganan Lite
Untuk mengonfirmasi, ketik
Y
.
Jika permintaan berhasil, command line akan menampilkan konfirmasi:
Deleted subscription [SUBSCRIPTION_ID].
Protokol
- Untuk menghapus topik Lite, kirim permintaan
DELETE
seperti berikut:
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Ganti kode berikut:
REGION: region tempat langganan Lite disimpan
PROJECT_NUMBER: nomor project dari project dengan langganan Lite
LOCATION: nama lokasi langganan Lite
SUBSCRIPTION_ID: ID langganan Lite
Jika permintaan berhasil, responsnya adalah objek JSON kosong.
Go
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Go di Library Klien Pub/Sub Lite.
Java
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Java di Library Klien Pub/Sub Lite.
Python
Sebelum menjalankan contoh ini, ikuti petunjuk penyiapan Python di Library Klien Pub/Sub Lite.
Langkah Berikutnya
- Membuat dan mengelola topik Lite.
- Publikasikan pesan ke topik Lite.
- Menerima pesan dari langganan Lite.