Dokumen ini menjelaskan cara mencantumkan topik Pub/Sub. Untuk mencantumkan topik, Anda dapat menggunakan konsol Google Cloud, gcloud CLI, library klien, atau Pub/Sub API.
Sebelum memulai
- Pelajari topik dan alur kerja publikasi pesan.
- Buat topik.
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mencantumkan topik dan mengelolanya,
minta administrator untuk memberi Anda
peran IAM Editor Pub/Sub(roles/pubsub.editor
)
di topik atau project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran bawaan ini berisi izin yang diperlukan untuk mencantumkan topik dan mengelolanya. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mencantumkan topik dan mengelolanya:
-
Buat topik:
pubsub.topics.create
-
Menghapus topik:
pubsub.topics.delete
-
Melepaskan langganan dari topik:
pubsub.topics.detachSubscription
-
Mendapatkan topik:
pubsub.topics.get
-
Cantumkan topik:
pubsub.topics.list
-
Memublikasikan ke topik:
pubsub.topics.publish
-
Memperbarui topik:
pubsub.topics.update
-
Dapatkan kebijakan IAM untuk topik:
pubsub.topics.getIamPolicy
-
Konfigurasikan kebijakan IAM untuk topik:
pubsub.topics.setIamPolicy
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Anda dapat mengonfigurasi kontrol akses di level project dan di level 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.
Mencantumkan topik
Konsol
Di konsol Google Cloud, buka halaman Topics Pub/Sub.
Halaman Topik mencantumkan semua topik yang tersedia.
Secara default, konsol menampilkan 50 topik. Anda dapat meningkatkan nilai ini untuk menampilkan maksimum 200 topik menggunakan tombol drop-down Baris per halaman. Tombol ini hanya muncul di konsol jika Anda memiliki lebih dari 20 topik dalam project.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Untuk mencantumkan topik, gunakan perintah
gcloud pubsub topics list
:gcloud pubsub topics list
Secara default, maksimum 100 hasil ditampilkan per kueri.
Anda dapat menentukan nilai alternatif hingga 1.000 menggunakan parameter ukuran halaman.
Misalnya, menggunakan Google Cloud CLI, tentukan --page-size=1000
.
REST
Untuk mencantumkan topik, gunakan metode
projects.topics.list
:
Permintaan:
Permintaan harus diautentikasi dengan token akses di header Authorization
. Untuk mendapatkan token akses untuk Kredensial Default Aplikasi saat ini: gcloud auth application-default print-access-token
.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics Authorization: Bearer ACCESS_TOKEN
Dengan keterangan:
Respons:
{ "topics": [ { "name": "projects/PROJECT_ID/topics/mytopic1", ... }, { "name": "projects/PROJECT_ID/topics/mytopic2", ... } ] }
C++
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C++ di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C++ Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
C#
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan C# di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API C# Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Go Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Java Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Node.js
PHP
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan PHP di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API PHP Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Python Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Ruby di panduan memulai Pub/Sub menggunakan library klien. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi API Ruby Pub/Sub.
Untuk melakukan autentikasi ke Pub/Sub, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Langkah selanjutnya
Pilih jenis langganan untuk topik Anda.
Buat atau ubah topik dengan gcloud CLI.
Buat atau ubah topik dengan REST API.