Mengontrol akses ke rentang grup multicast

Halaman ini menjelaskan cara mengontrol akses ke rentang grup multicast.

Konfigurasi yang dijelaskan di halaman ini menentukan apakah project konsumen multicast dapat Mengaktifkan jaringan VPC konsumen multicast untuk rentang grup.

Ringkasan

Anda dapat memperbarui project konsumen multicast yang dapat mengakses rentang grup multicast sebagai berikut:

Tentang mencabut dan memulihkan akses ke rentang grup

Pertimbangkan hal berikut sebelum memperbarui akses ke rentang grup multicast:

  • Jika pembaruan Anda mencabut akses untuk project konsumen multicast yang ada dan memiliki aktivasi konsumen grup multicast, maka Google Cloud menonaktifkan aktivasi konsumen grup multicast, tetapi resource masih ada di project konsumen multicast dengan status INACTIVE.
  • Jika Anda memberikan akses ke project konsumen multicast yang sebelumnya Anda cabut aksesnya, administrator jaringan konsumen multicast harus menghapus aktivasi konsumen grup yang ada dan membuat yang baru. Resource INACTIVE yang ada tidak dapat digunakan kembali.

Memperbarui rentang grup untuk mengizinkan semua project

Bagian ini menjelaskan cara memperbarui rentang grup multicast untuk mengizinkan semua project.

Setelah menyelesaikan prosedur ini, project apa pun yang memiliki akses ke domain dapat menggunakan rentang grup ini.

gcloud

Untuk memperbarui rentang grup multicast agar mengizinkan semua project, gunakan perintah network-services multicast-group-ranges update dan tentukan flag berikut:

  • --no-require-explicit-accept
  • Jika daftar penerimaan konsumen multicast tidak kosong, Anda juga harus menentukan flag --clear-consumer-accept-list.
  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --no-require-explicit-accept \
      --clear-consumer-accept-list

Ganti GROUP_RANGE_NAME dengan nama rentang grup multicast.

API

Untuk memperbarui rentang grup multicast agar mengizinkan semua project, gunakan metode multicastGroupRanges.patch.

Tetapkan kolom requireExplicitAccept ke false. Jika daftar penerimaan konsumen tidak kosong, Anda juga harus mengosongkan kolom consumerAcceptList dengan menetapkan nilainya ke [].

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "false",
    "consumerAcceptList": []
  }

Ganti nilai berikut:

  • PROJECT_ID: ID project administrator multicast
  • GROUP_RANGE_NAME: nama rentang grup multicast

Memperbarui rentang grup untuk menolak semua project secara default

Bagian ini menjelaskan cara memperbarui rentang grup multicast untuk menolak semua project secara default.

Dalam prosedur berikut, Anda dapat secara opsional memberikan daftar project tertentu yang dapat mengakses rentang grup multicast. Atau, Anda dapat menentukan project yang akan diizinkan nanti seperti yang dijelaskan dalam Mengonfigurasi daftar penerimaan konsumen multicast.

gcloud

Untuk memperbarui rentang grup multicast agar menolak semua project secara default, gunakan perintah network-services multicast-group-ranges update command.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --require-explicit-accept \
      [--consumer-accept-list=LIST_OF_CONSUMERS]

Ganti nilai berikut:

  • GROUP_RANGE_NAME: nama rentang grup multicast.

  • LIST_OF_CONSUMERS: daftar project konsumen yang dapat menggunakan rentang grup multicast ini. Anda dapat menentukan hingga 100 project berdasarkan ID atau namanya.

    Jika project konsumen multicast yang ada menggunakan rentang grup multicast dan Anda ingin project tersebut terus memiliki akses, tentukan project dalam daftar. Jika tidak, Google Cloud semua aktivasi konsumen grup multicast yang ada untuk rentang grup akan dinonaktifkan. Jika project kemudian ditambahkan kembali ke daftar penerimaan konsumen, administrator jaringan konsumen multicast harus membuat aktivasi konsumen grup baru.

    Anda dapat secara opsional menghapus flag ini dan menentukan project yang akan diizinkan nanti seperti yang dijelaskan dalam Mengonfigurasi daftar penerimaan konsumen.

API

Untuk memperbarui rentang grup multicast agar menolak semua project secara default, gunakan metode multicastGroupRanges.patch.

Tetapkan kolom requireExplicitAccept ke true. Anda dapat secara opsional menetapkan kolom consumerAcceptList.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "true",
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

Ganti nilai berikut:

  • PROJECT_ID: ID project administrator multicast
  • GROUP_RANGE_NAME: nama rentang grup multicast

  • LIST_OF_CONSUMERS: daftar project konsumen yang dapat menggunakan rentang grup multicast ini. Gunakan format berikut: "project-1", "project-2". Anda dapat menentukan hingga 100 project berdasarkan ID atau namanya.

    Jika project konsumen multicast yang ada menggunakan rentang grup multicast dan Anda ingin project tersebut terus memiliki akses, tentukan project dalam daftar. Jika tidak, Google Cloud semua aktivasi konsumen grup multicast yang ada untuk rentang grup akan dinonaktifkan. Jika project kemudian ditambahkan kembali ke daftar penerimaan konsumen, administrator jaringan konsumen multicast harus membuat aktivasi konsumen grup baru.

    Anda dapat secara opsional menghapus consumerAcceptList dari isi permintaan dan mask pembaruan, serta menentukan project yang akan diizinkan nanti seperti yang dijelaskan dalam Mengonfigurasi daftar penerimaan konsumen.

Mengonfigurasi daftar penerimaan konsumen multicast

Bagian ini menjelaskan cara mengonfigurasi daftar penerimaan konsumen multicast untuk rentang grup multicast.

Jika rentang grup multicast menolak semua project secara default, Anda dapat mengonfigurasi daftar penerimaan konsumen sebagai berikut:

Menetapkan daftar penerimaan baru

Bagian ini menjelaskan cara menetapkan daftar penerimaan konsumen multicast baru untuk rentang grup multicast.

Ikuti langkah-langkah di bagian ini jika Anda mengonfigurasi daftar penerimaan konsumen multicast untuk pertama kalinya atau jika Anda ingin mengganti daftar penerimaan konsumen yang ada. Jika Anda ingin mempertahankan daftar yang ada dan menambahkan atau menghapus project konsumen multicast, lihat Menambahkan project ke daftar penerimaan atau Menghapus project dari daftar penerimaan.

gcloud

Untuk menetapkan daftar penerimaan untuk rentang grup multicast, gunakan perintah network-services multicast-group-ranges update command.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --consumer-accept-list=LIST_OF_CONSUMERS

Ganti nilai berikut:

  • GROUP_RANGE_NAME: nama rentang grup multicast
  • LIST_OF_CONSUMERS: satu atau beberapa project konsumen yang dapat menggunakan rentang grup multicast ini. Anda dapat menentukan hingga 100 project berdasarkan ID atau namanya.

API

Untuk menetapkan daftar penerimaan untuk rentang grup multicast, gunakan metode multicastGroupRanges.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

Ganti nilai berikut:

  • PROJECT_ID: ID project administrator multicast
  • GROUP_RANGE_NAME: nama rentang grup multicast
  • LIST_OF_CONSUMERS: satu atau beberapa project konsumen yang dapat menggunakan rentang grup multicast ini. Gunakan format berikut: "project-1", "project-2". Anda dapat menentukan hingga 100 project berdasarkan ID atau namanya.

Menambahkan project ke daftar penerimaan

Bagian ini menjelaskan cara menambahkan project konsumen multicast ke daftar penerimaan untuk rentang grup multicast.

gcloud

Untuk menambahkan project konsumen multicast ke daftar penerimaan, gunakan network-services multicast-group-ranges update perintah.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --add-consumer-accept-list=LIST_OF_CONSUMERS

Ganti nilai berikut:

  • GROUP_RANGE_NAME: nama rentang grup multicast
  • LIST_OF_CONSUMERS: satu atau beberapa project konsumen multicast yang akan ditambahkan ke daftar penerimaan sehingga dapat menggunakan rentang grup multicast ini.

API

Untuk menambahkan project konsumen multicast ke daftar penerimaan, dapatkan daftar penerimaan saat ini, lalu buat permintaan API untuk memperbarui daftar:

  1. Untuk mendapatkan daftar penerimaan saat ini untuk rentang grup, ikuti petunjuk di Melihat rentang grup multicast. Salin daftar penerimaan agar dapat menggunakannya di langkah berikutnya.

  2. Untuk memperbarui daftar penerimaan, gunakan metode multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    Ganti nilai berikut:

    • PROJECT_ID: ID project administrator multicast
    • GROUP_RANGE_NAME: nama rentang grup multicast
    • UPDATED_LIST_OF_CONSUMERS: daftar project yang diperbarui yang mencakup project yang ada untuk dipertahankan dan project baru yang akan ditambahkan. Gunakan format berikut: "project-1", "project-2". API akan mengganti seluruh daftar penerimaan konsumen dengan daftar yang Anda berikan.

Menghapus project dari daftar penerimaan

Bagian ini menjelaskan cara menghapus project konsumen multicast dari daftar penerimaan untuk rentang grup multicast.

gcloud

Untuk menghapus project konsumen multicast dari daftar penerimaan, gunakan network-services multicast-group-ranges update perintah.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --remove-consumer-accept-list=LIST_OF_CONSUMERS

Ganti nilai berikut:

  • GROUP_RANGE_NAME: nama rentang grup multicast
  • LIST_OF_CONSUMERS: satu atau beberapa project konsumen multicast yang akan dihapus dari daftar penerimaan konsumen sehingga tidak dapat menggunakan rentang grup multicast ini.

API

Untuk menghapus project konsumen multicast dari daftar penerimaan, dapatkan daftar penerimaan saat ini, lalu buat permintaan API untuk memperbarui daftar:

  1. Untuk mendapatkan daftar penerimaan saat ini untuk rentang grup, ikuti petunjuk di Melihat rentang grup multicast. Salin daftar penerimaan agar dapat menggunakannya di langkah berikutnya.

  2. Untuk memperbarui daftar penerimaan, gunakan metode multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    Ganti nilai berikut:

    • PROJECT_ID: ID project administrator multicast
    • GROUP_RANGE_NAME: nama rentang grup multicast
    • UPDATED_LIST_OF_CONSUMERS: daftar project yang diperbarui yang mencakup project yang ada untuk dipertahankan dan tidak menyertakan project yang ingin Anda hapus. Gunakan format berikut: "project-1", "project-2". API akan mengganti seluruh daftar penerimaan konsumen dengan daftar yang Anda berikan.

Mengosongkan daftar penerimaan

Bagian ini menjelaskan cara mengosongkan daftar penerimaan untuk rentang grup multicast.

gcloud

Untuk mengosongkan daftar penerimaan konsumen untuk rentang grup multicast, gunakan perintah network-services multicast-group-ranges update command.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --clear-consumer-accept-list

Ganti GROUP_RANGE_NAME dengan nama rentang grup multicast.

API

Untuk mengosongkan daftar penerimaan konsumen untuk rentang grup multicast, gunakan metode multicastGroupRanges.patch method.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": []
  }

Ganti nilai berikut:

  • PROJECT_ID: ID project administrator multicast
  • GROUP_RANGE_NAME: nama rentang grup multicast