Membuat langganan pull (original) (raw)

Dokumen ini menjelaskan cara membuat langganan pull. Anda dapat menggunakan konsol Google Cloud , Google Cloud CLI, library klien, atau Pub/Sub API untuk membuat langganan pull.

Untuk mendapatkan izin yang diperlukan guna membuat langganan pull, minta administrator untuk memberi Anda peran IAMPub/Sub Editor (roles/pubsub.editor) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat langganan pull. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Jika membuat langganan di satu project untuk topik di project lain, Anda harus memiliki izin pubsub.subscriptions.create di project tempat Anda membuat langganan, dan izin pubsub.topics.attachSubscription di topik.

Subscription pull mendukung semuaproperti langganan umum. Langganan tarik juga mendukung properti Pengiriman tepat satu kali, yang dijelaskan di bagian berikutnya.

Pengiriman tepat satu kali. Jika disetel, Pub/Sub memenuhi jaminan pengiriman tepat satu kali. Jika tidak ditentukan, langganan mendukung pengiriman minimal satu kali untuk setiap pesan.

Contoh berikut menunjukkan cara membuat langganan dengan pengiriman pull, menggunakan setelan default yang disediakan.

Konsol

Untuk membuat langganan pull, selesaikan langkah-langkah berikut.

  1. Di konsol Google Cloud , buka halaman Subscriptions.
    Buka Langganan
  2. Klik Buat langganan.
  3. Untuk kolom Subscription ID, masukkan nama.
    Untuk mengetahui informasi tentang cara memberi nama langganan, lihatPanduan untuk memberi nama topik atau langganan.
  4. Pilih atau buat topik dari menu drop-down. Langganan menerima pesan dari topik.
  5. Pertahankan Jenis pengiriman sebagai Pull.
  6. Pertahankan semua nilai default lainnya.
  7. Klik Create.

Anda juga dapat membuat langganan dari bagian Topik. Pintasan ini berguna untuk mengaitkan topik dengan langganan.

  1. Di konsol Google Cloud , buka halaman Topics.
    Buka Topik
  2. Klikdi samping topik yang akan digunakan untuk membuat langganan.
  3. Dari menu konteks, pilih Buat langganan.
  4. Masukkan ID Langganan.
    Untuk mengetahui informasi tentang cara memberi nama langganan, lihatPanduan untuk memberi nama topik atau langganan.
  5. Pertahankan Jenis pengiriman sebagai Pull.
  6. Pertahankan semua nilai default lainnya.
  7. Klik Create.

gcloud

  1. Di konsol Google Cloud , aktifkan Cloud Shell.
    Aktifkan Cloud Shell
    Di bagian bawah konsol Google Cloud , sesiCloud Shell akan dimulai dan menampilkan perintah 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.
  2. Untuk membuat langganan pull, jalankan perintah gcloud pubsub subscriptions create.
    gcloud pubsub subscriptions create SUBSCRIPTION_ID --topic=TOPIC_ID
    Ganti kode berikut:
    • SUBSCRIPTION_ID: Nama atau ID langganan tarik baru Anda.
    • TOPIC_ID: Nama atau ID topik Anda.

REST

Untuk membuat langganan pull, gunakan metode projects.subscriptions.create:

Permintaan:

Permintaan harus diautentikasi dengan token akses di headerAuthorization. Untuk mendapatkan token akses untuk Kredensial Default Aplikasi saat ini: gcloud auth application-default print-access-token.

PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID Authorization: Bearer ACCESS_TOKEN

Isi permintaan:

{ "topic": "projects/PROJECT_ID/topics/TOPIC_ID" }

Dengan:

Respons:

{ "name": "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_ID/topics/TOPIC_ID", "pushConfig": {}, "ackDeadlineSeconds": 10, "messageRetentionDuration": "604800s", "expirationPolicy": { "ttl": "2678400s" } }

C++

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C++ diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C++ Pub/Sub.

C#

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Pub/Sub.

Go

Contoh berikut menggunakan versi utama library klien Go Pub/Sub (v2). Jika Anda masih menggunakan library v1, lihatpanduan migrasi ke v2. Untuk melihat daftar contoh kode v1, lihat contoh kode yang tidak digunakan lagi.

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Pub/Sub.

Java

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java diPanduan 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 diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Pub/Sub.

Node.ts

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Node.js Pub/Sub.

PHP

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Pub/Sub.

Python

Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi Pub/Sub Python API.

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 diPanduan memulai: Menggunakan Library Klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Pub/Sub.