Pelanggan menggunakan langganan Lite untuk membaca pesan dari topik Lite. Saat membuat langganan Lite, Anda akan melampirkannya 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 Mengekspor pesan Pub/Sub Lite ke Pub/Sub.
Properti langganan Lite
Langganan untuk topik Lite zona memiliki properti yang identik dengan langganan untuk topik Lite regional, 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 zona.
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 reaksi langganan terhadap percobaan ulang pesan ini. Anda dapat menetapkan properti ini ke salah satu dari dua opsi berikut:
Mengirim pesan dengan segera. Dengan mengaktifkan opsi ini, klien pelanggan akan menerima semua pesan setelah mereka 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 cari.
Kirim pesan setelah disimpan. Dengan mengaktifkan opsi ini, pelanggan tidak akan menerima pesan hingga pesan ditulis ke disk. Pesan dijamin dapat dibaca ulang setelah operasi pencarian. Mengaktifkan opsi ini akan meningkatkan latensi menyeluruh dalam menerima pesan dari penayang ke pelanggan.
Panduan untuk menamai 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 pisah-
, 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 dalam 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 dalam project dan lokasi yang sama dengan topik Lite yang terkait dengan langganan Lite.
Untuk membuat topik Lite, lihat Membuat dan mengelola topik Lite.
Untuk 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 Mengekspor pesan Pub/Sub Lite ke Pub/Sub.
Konsol
Buka halaman Langganan Lite.
Klik Create Lite subscription.
Masukkan ID langganan Lite.
Pilih topik Lite yang akan 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project project untuk membuat langganan Lite di
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, } }
Mengganti 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 tempat 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 mengupdate 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project project dengan langganan Lite
LOCATION: nama lokasi tempat langganan Lite
SUBSCRIPTION_ID: ID langganan Lite
Tentukan kolom berikut dalam isi permintaan:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Mengganti 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.
Lihat detail langganan Lite
Anda bisa mendapatkan detail tentang langganan Lite menggunakan Google Cloud Console, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
Klik ID langganan Lite.
Di halaman detail langganan Lite, klik tab Details.
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 tempat 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project project dengan langganan Lite
LOCATION: nama lokasi tempat 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 sebuah project menggunakan Konsol Google Cloud, Google Cloud CLI, atau Pub/Sub Lite API.
Konsol
Buka halaman Langganan Lite.
gcloud
- Untuk mencantumkan langganan Lite dalam sebuah project, gunakan
perintah
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Ganti LOCATION dengan nama lokasi tempat langganan Lite berada.
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 sebuah 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project 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 suatu 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 dilampirkan langganan Lite
LOCATION: nama lokasi tempat 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project project dengan langganan Lite
LOCATION: nama lokasi tempat langganan Lite
TOPIC_ID: ID topik Lite yang dilampirkan langganan Lite
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 Delete.
Pada dialog yang muncul, klik Delete 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 tempat 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 untuk menyimpan langganan Lite
PROJECT_NUMBER: nomor project project dengan langganan Lite
LOCATION: nama lokasi tempat 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.
- Terima pesan dari langganan Lite.