Dokumen ini menjelaskan cara mencantumkan topik Pub/Sub. Untuk mencantumkan a topik, Anda dapat menggunakan Cloud de Confiance konsol, gcloud CLI, library klien, atau Pub/Sub API.
Sebelum memulai
- Pelajari tentang topik dan alur kerja pesan publikasi.
- Buat topik.
Peran dan izin yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mencantumkan topik dan mengelolanya, minta administrator untuk memberi Anda peran IAM Pub/Sub Editor(roles/pubsub.editor) di topik atau project Anda.
Untuk mengetahui informasi selengkapnya tentang pemberian 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, perluas bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mencantumkan topik dan mengelolanya:
-
Membuat topik:
pubsub.topics.create -
Menghapus topik:
pubsub.topics.delete -
Melepaskan langganan dari topik:
pubsub.topics.detachSubscription -
Mendapatkan topik:
pubsub.topics.get -
Mencantumkan topik:
pubsub.topics.list -
Memublikasikan ke topik:
pubsub.topics.publish -
Mengupdate topik:
pubsub.topics.update -
Mendapatkan kebijakan IAM untuk topik:
pubsub.topics.getIamPolicy -
Mengonfigurasi 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 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.
Mencantumkan topik
Konsol
Di Cloud de Confiance konsol, buka halaman Pub/Sub Topics.
Halaman Topics 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 Rows per page. Tombol ini hanya muncul di konsol jika Anda memiliki lebih dari 20 topik dalam project.
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 mencantumkan topik, gunakan
gcloud pubsub topics listperintah: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
projects.topics.list
metode:
Permintaan:
Permintaan harus diautentikasi dengan token akses di the
Authorization header. 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:
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: 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 library klien Pub/Sub Go versi utama (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 Pub/Sub Ruby 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.
Langkah berikutnya
Pilih jenis langganan untuk topik Anda.
Buat atau ubah topik dengan gcloud CLI.
Buat atau ubah topik dengan REST API.