Mengelola kontak untuk notifikasi

Banyak penawaran Google Cloud, seperti Penagihan Cloud, mengirimkan notifikasi untuk membagikan informasi penting kepada pengguna Google Cloud. Secara default, notifikasi ini dikirim ke anggota dengan peran Pengelolaan Akses dan Identitas (IAM) tertentu. Dengan Kontak Penting, Anda dapat menyesuaikan siapa yang menerima notifikasi dengan memberikan daftar kontak Anda sendiri.

Sebelum memulai

Enable the Essential Contacts API.

Enable the API

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola kontak, minta administrator untuk memberi Anda peran IAM berikut pada project, folder, atau organisasi tempat kontak ditetapkan :

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola kontak. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kontak:

  • Untuk melihat kontak:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • Untuk mengedit, menghapus, dan membuat kontak:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontacts.contacts.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Kategori notifikasi

Anda dapat menetapkan kontak ke beberapa kategori notifikasi. Jika Anda tidak menambahkan kontak ke kategori, notifikasi dalam kategori tersebut akan dikirim ke kontak penggantian, yang dipilih berdasarkan peran IAM anggota Anda. Sebaiknya tambahkan kontak kustom, dan jangan mengandalkan kontak penggantian, untuk membantu memastikan bahwa orang yang tepat menerima notifikasi untuk project, folder, atau organisasi Anda.

Anda dapat menambahkan individu dan grup sebagai kontak. Untuk mengurangi dampak perubahan personel, sebaiknya tambahkan grup sebagai kontak, lalu kelola keanggotaan grup tersebut untuk menentukan siapa yang menerima notifikasi. Praktik ini membantu memastikan bahwa notifikasi selalu dikirim ke karyawan yang aktif.

Tinjau tabel berikut untuk mempelajari kategori notifikasi, kontak penggantian, dan kontak yang direkomendasikan. Jika Anda tidak menetapkan kontak ke kategori tertentu, notifikasi akan dikirim ke kontak penggantian.

Kategori Deskripsi Contoh Kontak pengganti Kontak yang direkomendasikan
Semua Semua notifikasi dari setiap kategori lainnya T/A T/A Orang atau sistem otomatis yang bertanggung jawab untuk merutekan atau mencatat notifikasi yang berpotensi berjumlah besar
Penagihan Notifikasi penagihan dan pembayaran Pembaruan harga, error, dan kredit Billing Account Administrator (roles/billing.admin) Staf departemen keuangan dan orang yang mengelola hubungan keuangan Anda dengan Google, termasuk orang yang mengelola anggaran, perencanaan, dan akun yang terkait dengan penggunaan Google Cloud
Hukum Notifikasi kepatuhan hukum Tindakan penegakan, kepatuhan terhadap peraturan, dan pemberitahuan dari pemerintah Billing Account Administrator (roles/billing.admin) Penasihat hukum, pengelola kepatuhan, spesialis hubungan pemerintah, dan profesional terkait lainnya
Update produk Perubahan pada produk Google Versi baru, pembaruan persyaratan produk, penghentian layanan Project Owner (roles/owner) Product manager, architect, dan engineer yang dapat memperoleh manfaat dari informasi yang tepat waktu tentang perubahan pada produk dan layanan Google
Keamanan Notifikasi masalah keamanan/privasi Kerentanan, insiden data, dan serangan Administrator Organisasi (roles/resourcemanager.organizationAdmin) Keamanan IT, keamanan operasi, dan orang lain yang tugasnya adalah melindungi data perusahaan dan pelanggan Anda serta memastikan kelangsungan bisnis
Penangguhan Notifikasi terkait penangguhan akun dan project seketika Kepatuhan evaluasi Apigee, pelanggaran hak cipta, dan penambangan koin Project Owner (roles/owner) Orang yang langsung bertanggung jawab untuk menjaga infrastruktur IT dan aplikasi bisnis Anda tetap aktif dan berjalan
Teknis Peristiwa teknis dan masalah operasional lainnya Mencatat error konfigurasi, update pencegahan kebocoran data, dan status Actions on Google Project Owner (roles/owner) Profesional IT, engineer keandalan, admin, daftar on-call, dan orang lain yang perlu mengetahui peristiwa dan masalah teknis saat ini dan mendatang untuk mengelola aset IT Anda dengan lebih baik dan menghindari gangguan

Bahasa yang didukung

Di Kontak Penting, setiap kontak memiliki setelan bahasa pilihan. Kreator notifikasi dapat mereferensikan setelan ini saat mengirim notifikasi.

Saat Anda menambahkan kontak di konsol Google Cloud, konsol Google Cloud akan otomatis mengonfigurasi bahasa pilihan kontak berdasarkan setelan bahasa pilihan pembuat kontak. Saat menambahkan kontak menggunakan API, Anda mengonfigurasi bahasa pilihan kontak secara manual menggunakan kode bahasa. Kode bahasa ini dapat merujuk ke salah satu bahasa yang didukung Kontak Penting.

Praktik terbaik untuk menetapkan kontak

Anda dapat menetapkan kontak di tingkat project, folder, atau organisasi.

Kontak diwariskan melalui hierarki resource Google Cloud. Akibatnya, jika Anda menambahkan kontak di tingkat organisasi, mereka akan menerima notifikasi untuk organisasi dan untuk semua folder dan project dalam organisasi. Demikian pula, jika Anda menambahkan kontak di tingkat folder, mereka akan menerima notifikasi untuk folder tersebut serta untuk semua folder dan project dalam folder tersebut.

Tempat Anda memutuskan untuk menetapkan kontak bergantung pada struktur organisasi Anda. Namun, sebaiknya tetapkan kontak pada tingkat berikut, berdasarkan kategori notifikasinya:

Level yang direkomendasikan Kategori notifikasi
Tingkat organisasi
  • Penagihan
  • Hukum
  • Keamanan1
Level folder/project
  • Semua
  • Update produk
  • Keamanan1
  • Penangguhan
  • Teknis2

1 Tingkat saat Anda menetapkan kontak keamanan bergantung pada praktik keamanan spesifik organisasi Anda. Misalnya, jika setiap pemilik project bertanggung jawab atas keamanan project mereka sendiri, Anda akan menetapkan kontak keamanan di tingkat project. Namun, jika grup seluruh organisasi mengelola keamanan untuk semua project, Anda akan menetapkan kontak keamanan di tingkat organisasi.

2 Kontak kategori teknis menerima notifikasi email dalam jumlah besar. Tetapkan kontak ini di tingkat folder atau project agar dapat memproses alur notifikasi yang masuk.

Membatasi domain yang diizinkan untuk kontak

Untuk membatasi domain alamat email yang dapat dimiliki kontak baru, tetapkan batasan kebijakan organisasi constraints/essentialcontacts.allowedContactDomains. Kontak yang sudah ada tidak terpengaruh oleh batasan ini.

Untuk mempelajari cara menetapkan batasan kebijakan organisasi, lihat Batasan kebijakan organisasi.

Mencantumkan kontak

Untuk mencantumkan semua kontak di project, folder, atau organisasi Anda, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi apa yang saat ini Anda kelola kontaknya.

  3. Untuk mencantumkan kontak menurut kategori, pilih Kategori. Untuk mencantumkan kontak secara alfabet, pilih Kontak.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Dengan Google Cloud CLI, Anda dapat mencantumkan kontak yang ditentukan di resource, atau mencantumkan semua kontak dan kontak yang diwarisi untuk resource.

    Mencantumkan kontak yang ditentukan di resource

    Untuk melihat kontak yang telah ditentukan di project, folder, atau organisasi tertentu, gunakan perintah gcloud essential-contacts list:

    gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"

    Ganti nilai berikut:

    • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    Atau, jika Anda tidak menentukan jenis atau ID resource, gcloud CLI akan mencantumkan kontak untuk project saat ini.

    Responsnya mirip dengan hal berikut ini:

    ---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---

    Mencantumkan kontak dan kontak yang diwarisi

    Resource turunan (folder dan project) mewarisi kontak dari ancestor-nya (organisasi dan folder lainnya). Jika Anda ingin mencantumkan semua kontak dan kontak yang diwarisi untuk resource, gunakan perintah gcloud essential-contacts compute:

    gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \
  --RESOURCE_TYPE="RESOURCE_ID"

    Ganti nilai berikut:

    Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

    • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma untuk kategori notifikasi yang ingin Anda hitung kontaknya. Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.
    • RESOURCE_TYPE: Jenis resource yang ingin Anda hitung kontaknya. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan mencantumkan kontak untuk project saat ini.

    Respons mencantumkan semua kontak dan kontak yang diwarisi untuk resource:

    ---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---
email: my-organization-contact@example.com
languageTag: en-US
name: organizations/my-organization/contacts/1
notificationCategorySubscriptions:
- ALL
---

REST

Dengan Essential Contacts REST API, Anda dapat mencantumkan kontak yang ditentukan pada resource, atau mencantumkan semua kontak dan kontak yang diwarisi untuk resource.

Mencantumkan kontak yang ditentukan di resource

Untuk melihat kontak yang telah ditentukan di project, folder, atau organisasi tertentu, gunakan metode contacts.list Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • PAGE_SIZE: Opsional. Jumlah kontak yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimumnya adalah 100. Jika jumlah kontak lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
  • NEXT_PAGE_TOKEN: Opsional. Token penomoran halaman yang ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak akan dimulai dari tempat respons sebelumnya berakhir.

Permintaan: 

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Jalankan perintah berikut: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan berikut ini: 

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-contact-1@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-contact-2@example.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

Mencantumkan kontak dan kontak yang diwarisi

Resource turunan (folder dan project) mewarisi kontak dari ancestor-nya (organisasi dan folder lainnya). Jika Anda ingin mencantumkan semua kontak dan kontak yang diwarisi untuk resource, gunakan metode contacts.compute Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda hitung kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • NOTIFICATION_CATEGORY: Kategori notifikasi yang ingin Anda komputasi kontaknya. Anda dapat mengulangi kolom ini untuk mencantumkan kontak untuk beberapa kategori notifikasi. NOTIFICATION_CATEGORY dapat berupa salah satu nilai berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, dan NOTIFICATION_CATEGORY_UNSPECIFIED. Memilih nilai ALL akan mencantumkan kontak untuk semua kategori.
  • PAGE_SIZE: Opsional. Jumlah kontak yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimumnya adalah 100. Jika jumlah kontak lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
  • NEXT_PAGE_TOKEN: Opsional. Token penomoran halaman yang ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak akan dimulai dari tempat respons sebelumnya berakhir.

Permintaan: 

GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Jalankan perintah berikut: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Respons mencantumkan semua kontak dan kontak yang diwarisi untuk resource:

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-project-contact-1@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@example.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

Mengelola setiap kontak penting

Anda dapat menambahkan kontak, menghapusnya, atau menetapkan kategori notifikasi untuk kontak tersebut di halaman Kontak penting di konsol Google Cloud, atau dengan menggunakan REST API.

Menambahkan kontak

Untuk menambahkan kontak, lakukan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi apa yang saat ini Anda kelola kontaknya.

  3. Klik Tambahkan kontak.

  4. Di kolom Email dan Confirm email, masukkan alamat email kontak.

  5. Dari menu drop-down Notification categories, pilih kategori notifikasi yang Anda inginkan untuk komunikasi yang diterima kontak. Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Mengidentifikasi kontak di halaman ini.

  6. Klik Simpan.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Untuk menambahkan kontak baru, gunakan perintah gcloud essential-contacts create:

    gcloud essential-contacts create --email="EMAIL" \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE" \
    --RESOURCE_TYPE="RESOURCE_ID"

    Ganti nilai berikut:

    • EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.
    • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma untuk kategori notifikasi yang Anda inginkan untuk komunikasi yang diterima kontak. Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, technical-incidents, dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.

      Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

    • LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa dari salah satu bahasa yang didukung.
    • RESOURCE_TYPE: Jenis resource yang ingin Anda buat kontaknya. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. Project ID berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan membuat kontak dalam project saat ini.

    Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk menambahkan kontak baru, gunakan metode contacts.create Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda buat kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.

  • NOTIFICATION_CATEGORY_1 dan NOTIFICATION_CATEGORY_2: Kategori notifikasi yang Anda inginkan untuk komunikasi yang diterima kontak. Nilai ini dapat berupa salah satu dari berikut ini: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

  • LANGUAGE: Kode bahasa untuk bahasa notifikasi yang dipilih kontak Anda. Anda dapat menyertakan kode bahasa dari bahasa yang didukung.

Permintaan: 

POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts

Isi permintaan: 

{
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan berikut ini: 

{
  "name": "projects/my-project/contacts/3",
  "email": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

Mengubah kontak

Untuk mengubah kategori yang ditetapkan untuk kontak, lakukan tindakan berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi apa yang saat ini Anda kelola kontaknya.

  3. Di samping Lihat menurut, pilih Kontak.

  4. Klik di samping kontak yang kategorinya ingin Anda ubah.

  5. Pilih kategori notifikasi yang Anda inginkan dari menu drop-down Notification categories, lalu klik Save.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Untuk memperbarui kontak yang ada, gunakan perintah gcloud essential-contacts update:

    gcloud essential-contacts update CONTACT_ID \
    --notification-categories="NOTIFICATION_CATEGORIES" \
    --language="LANGUAGE"
    --RESOURCE_TYPE="RESOURCE_ID"

    Ganti nilai berikut:

    • CONTACT_ID: ID numerik kontak yang ingin Anda perbarui. Untuk melihat ID semua kontak di project, folder, atau organisasi, buat daftar kontak. ID numerik adalah semuanya setelah contacts dalam nama kontak.
    • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma untuk kategori notifikasi baru yang ingin Anda terima komunikasinya oleh kontak. Daftar ini akan menggantikan daftar kategori notifikasi yang ada.

      Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, technical-incidents , dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.

      Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

    • LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa dari salah satu bahasa yang didukung.
    • RESOURCE_TYPE: Jenis resource tempat kontak ditentukan. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID project, organisasi, atau folder Google Cloud tempat kontak ditentukan. Project ID berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan memperbarui kontak dengan ID yang ditentukan dalam project saat ini. Jika tidak ada kontak dengan ID yang ditentukan, gcloud CLI akan menampilkan error.

    Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk mengubah langganan notifikasi atau bahasa pilihan kontak yang ada, gunakan metode contacts.patch Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • CONTACT_ID: ID numerik kontak yang ingin Anda perbarui. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, cantumkan kontak Anda. ID numerik adalah semuanya setelah contacts dalam nama kontak.
  • UPDATE_MASK: Opsional. Masker yang menjelaskan kolom kontak mana yang telah Anda ubah. Format untuk mask adalah daftar nama kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma, misalnya: notificationCategorySubscriptions,languageTag.
  • EMAIL: Alamat email kontak Anda. Kolom ini harus cocok dengan alamat email yang terkait dengan CONTACT_ID yang Anda sertakan dalam permintaan.

  • NOTIFICATION_CATEGORY_1 dan NOTIFICATION_CATEGORY_2: Opsional. Kategori notifikasi yang diperbarui yang Anda inginkan untuk komunikasi yang diterima kontak. Nilai ini dapat berupa salah satu dari berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

  • LANGUAGE: Kode bahasa untuk bahasa notifikasi yang dipilih kontak. Anda dapat menyertakan kode bahasa dari bahasa yang didukung.

Permintaan: 

PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

Isi permintaan: 

{
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan berikut ini: 

{
  "name": "projects/my-project/contacts/2",
  "email": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

Menghapus kontak

Untuk menghapus kontak, lakukan langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi apa yang saat ini Anda kelola kontaknya.

  3. Di samping Lihat menurut, pilih Kontak.

  4. Klik di samping alamat email kontak yang ingin Anda hapus. Kemudian, dalam dialog, konfirmasi bahwa Anda ingin menghapus kontak.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Untuk menghapus kontak yang ada, gunakan perintah gcloud essential-contacts delete:

    gcloud essential-contacts delete CONTACT_ID \
    --RESOURCE_TYPE="RESOURCE_ID"

    Ganti nilai berikut:

    • CONTACT_ID: ID numerik kontak yang ingin Anda hapus. Untuk melihat ID semua kontak di project, folder, atau organisasi, buat daftar kontak. ID numerik adalah semuanya setelah contacts dalam nama kontak.
    • RESOURCE_TYPE: Jenis resource tempat kontak ditentukan. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID project, organisasi, atau folder Google Cloud tempat kontak ditentukan. Project ID berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan menghapus kontak dengan ID yang ditentukan dalam project saat ini. Jika tidak ada kontak dengan ID yang ditentukan, gcloud CLI akan menampilkan error.

    Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk menghapus kontak, gunakan metode contacts.delete Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • CONTACT_ID: ID numerik kontak Anda. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, buat daftar kontak.

Permintaan: 

DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Jika permintaan berhasil, isi respons akan kosong.

Mengelola kontak menurut kategori

Di konsol Google Cloud, Anda juga dapat mengelola kontak menurut kategori dengan membuka tab Kategori di halaman Kontak penting.

Untuk menambahkan, mengubah, atau menghapus kontak yang ditetapkan ke satu kategori, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi apa yang saat ini Anda kelola kontaknya.

  3. Di samping Lihat berdasarkan, pilih Kategori.

  4. Klik di baris yang sama dengan kategori yang kontaknya ingin Anda kelola.

  5. Mengelola kontak yang ditetapkan ke kategori:

    • Untuk menambahkan kontak baru, klik Tambahkan kontak, lalu ikuti langkah-langkah untuk menambahkan kontak yang dijelaskan di halaman ini.

    • Untuk mengubah kategori yang ditetapkan untuk kontak, klik di samping kontak yang kategorinya ingin Anda ubah. Kemudian, pilih kategori notifikasi yang Anda inginkan dari menu drop-down Notification categories, lalu klik Save.

    • Untuk menghapus kontak, klik di samping alamat email kontak tersebut.

Memverifikasi transmisi email

Anda dapat mengirim email pengujian ke kontak di setiap kategori untuk memverifikasi apakah akun email dapat menerima email dari Google Cloud.

Untuk mengirim email pengujian kepada kontak dalam kategori tertentu, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman Kontak penting.

    Buka halaman Kontak penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource menampilkan project, folder, atau organisasi tempat Anda saat ini mengelola kontak.

  3. Di samping Lihat berdasarkan, pilih Kategori.

  4. Klik di baris yang sama dengan kategori yang kontaknya ingin Anda kirimi email uji coba.

  5. Centang kotak di samping kontak yang ingin Anda kirimi email.

  6. Klik Kirim. Email pengujian akan dikirim ke kontak yang dipilih.

  7. Berkomunikasilah dengan setiap kontak untuk memastikan mereka menerima email pengujian dari gcp-essential-contacts-noreply@google.com.

Mengelola kontak dengan Terraform

Anda dapat menggunakan Terraform untuk mengelola kontak notifikasi. Kontak memiliki format berikut dalam bahasa Terraform:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

Saat membuat kontak, ganti nilai berikut:

  • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: Project Google Cloud, organisasi, atau ID folder Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
  • EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.
  • LANGUAGE: Opsional. Kode bahasa untuk bahasa notifikasi pilihan kontak. Anda dapat menyertakan kode bahasa dari salah satu bahasa yang didukung.

  • NOTIFICATION_CATEGORIES: Array kategori notifikasi yang Anda inginkan untuk komunikasi yang diterima kontak. Contoh, ["BILLING", "LEGAL"].

    Array ini dapat berisi salah satu nilai berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

Untuk menambahkan, mengubah, atau menghapus kontak, tambahkan, ubah, atau hapus resource kontak di file konfigurasi Terraform Anda.

Untuk mengetahui detail selengkapnya, lihat dokumentasi Kontak Penting Terraform.

Langkah selanjutnya