Zugriff auf Multicast-Gruppenbereiche steuern

Auf dieser Seite wird beschrieben, wie Sie den Zugriff auf Multicast-Gruppenbereiche steuern.

Die auf dieser Seite beschriebene Konfiguration bestimmt, ob ein Multicast-Nutzerprojekt ein Multicast-Nutzer-VPC-Netzwerk für einen Gruppenbereich aktivieren kann.

Übersicht

So aktualisieren Sie, welche Multicast-Nutzerprojekte auf einen Multicast-Gruppenbereich zugreifen können:

Zugriff auf Gruppenbereiche widerrufen und wiederherstellen

Beachten Sie Folgendes, bevor Sie den Zugriff auf einen Multicastgruppenbereich aktualisieren:

  • Wenn durch Ihr Update der Zugriff für ein bestehendes Multicast-Nutzerprojekt mit einer Nutzeraktivierung für die Multicast-Gruppe widerrufen wird,Google Cloud deaktiviert die Nutzeraktivierung für die Multicast-Gruppe. Die Ressource ist jedoch weiterhin im Multicast-Nutzerprojekt mit dem Status INACTIVE vorhanden.
  • Wenn Sie den Zugriff auf ein Multicast-Nutzerprojekt gewähren, für das Sie den Zugriff zuvor widerrufen haben, muss der Netzwerkadministrator des Multicast-Nutzers die vorhandene Gruppen-Nutzeraktivierung löschen und eine neue erstellen. Vorhandene INACTIVE-Ressourcen können nicht wiederverwendet werden.

Gruppenbereich aktualisieren, um alle Projekte zuzulassen

In diesem Abschnitt wird beschrieben, wie Sie einen Multicastgruppenbereich aktualisieren, um alle Projekte zuzulassen.

Nach Abschluss dieses Verfahrens kann in jedem Projekt, das Zugriff auf die Domain hat, dieser Gruppenbereich verwendet werden.

gcloud

Wenn Sie einen Multicastgruppenbereich aktualisieren möchten, um alle Projekte zuzulassen, verwenden Sie den network-services multicast-group-ranges update-Befehl und geben Sie die folgenden Flags an:

  • --no-require-explicit-accept
  • Wenn die Akzeptanzliste für Multicast-Verbraucher nicht leer ist, müssen Sie auch das Flag --clear-consumer-accept-list angeben.
  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --no-require-explicit-accept \
      --clear-consumer-accept-list

Ersetzen Sie GROUP_RANGE_NAME durch den Namen des Multicast-Gruppenbereichs.

API

Verwenden Sie die Methode multicastGroupRanges.patch, um einen Multicastgruppenbereich so zu aktualisieren, dass alle Projekte zugelassen werden.

Setzen Sie das Feld requireExplicitAccept auf false. Wenn die Liste der akzeptierten Nutzer nicht leer ist, müssen Sie auch das Feld consumerAcceptList leeren, indem Sie seinen Wert auf [] setzen.

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

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID des Multicast-Administratorprojekts
  • GROUP_RANGE_NAME: der Name des Multicastgruppenbereichs

Gruppenbereich aktualisieren, um alle Projekte standardmäßig abzulehnen

In diesem Abschnitt wird beschrieben, wie Sie einen Multicastgruppenbereich so aktualisieren, dass standardmäßig alle Projekte abgelehnt werden.

Im folgenden Verfahren können Sie optional eine Liste mit bestimmten Projekten angeben, die auf den Multicastgruppenbereich zugreifen können. Alternativ können Sie Projekte angeben, die später zugelassen werden sollen, wie unter Multicast-Nutzerakzeptanzliste konfigurieren beschrieben.

gcloud

Verwenden Sie den Befehl network-services multicast-group-ranges update, um einen Multicastgruppenbereich so zu aktualisieren, dass alle Projekte standardmäßig abgelehnt werden.

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

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_NAME: der Name des Multicastgruppenbereichs.
  • LIST_OF_CONSUMERS: Eine Liste von Nutzerprojekten, die diesen Multicastgruppenbereich verwenden können. Sie können bis zu 100 Projekte anhand ihrer ID oder ihres Namens angeben.

    Wenn ein vorhandenes Multicast-Nutzerprojekt den Multicast-Gruppenbereich verwendet und Sie möchten, dass es weiterhin Zugriff hat, geben Sie das Projekt in der Liste an. Andernfalls werden alle vorhandenen Nutzeraktivierungen für Multicast-Gruppen für den Gruppenbereich deaktiviert. Google Cloud Wenn ein Projekt später wieder der Annahmeliste des Nutzers hinzugefügt wird, muss der Administrator des Multicast-Nutzer-Netzwerks neue Gruppen-Nutzeraktivierungen erstellen.

    Sie können dieses Flag optional weglassen und später Projekte angeben, die zugelassen werden sollen, wie unter Zulassungsliste für Consumer konfigurieren beschrieben.

API

Wenn Sie einen Multicastgruppenbereich so aktualisieren möchten, dass alle Projekte standardmäßig abgelehnt werden, verwenden Sie die Methode multicastGroupRanges.patch.

Setzen Sie das Feld requireExplicitAccept auf true. Optional können Sie das Feld consumerAcceptList festlegen.

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

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID des Multicast-Administratorprojekts
  • GROUP_RANGE_NAME: der Name des Multicast-Gruppenbereichs
  • LIST_OF_CONSUMERS: Eine Liste von Nutzerprojekten, die diesen Multicastgruppenbereich verwenden können. Verwenden Sie das folgende Format: "project-1", "project-2". Sie können bis zu 100 Projekte anhand ihrer ID oder ihres Namens angeben.

    Wenn ein vorhandenes Multicast-Nutzerprojekt den Multicast-Gruppenbereich verwendet und Sie möchten, dass es weiterhin Zugriff hat, geben Sie das Projekt in der Liste an. Andernfalls werden alle vorhandenen Nutzeraktivierungen für Multicast-Gruppen für den Gruppenbereich deaktiviert. Google Cloud Wenn ein Projekt später wieder der Annahmeliste des Nutzers hinzugefügt wird, muss der Administrator des Multicast-Nutzer-Netzwerks neue Gruppen-Nutzeraktivierungen erstellen.

    Sie können consumerAcceptList optional aus dem Anfragetext und der Aktualisierungsmaske weglassen und Projekte angeben, die später zugelassen werden sollen, wie unter Liste der Nutzer akzeptieren konfigurieren beschrieben.

Annahmeliste für Multicast-Empfänger konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie die Akzeptanzliste für Multicast-Empfänger für einen Multicast-Gruppenbereich konfigurieren.

Wenn der Multicastgruppenbereich standardmäßig alle Projekte ablehnt, können Sie die Zulassungsliste für Nutzer so konfigurieren:

Neue Annahmeliste festlegen

In diesem Abschnitt wird beschrieben, wie Sie eine neue Akzeptanzliste für Multicast-Consumer für einen Multicast-Gruppenbereich festlegen.

Folgen Sie der Anleitung in diesem Abschnitt, wenn Sie die Liste der akzeptierten Multicast-Nutzer zum ersten Mal konfigurieren oder die vorhandene Liste der akzeptierten Nutzer ersetzen möchten. Wenn Sie die vorhandene Liste beibehalten und ein Multicast-Nutzerprojekt hinzufügen oder entfernen möchten, lesen Sie die Informationen unter Projekt der Zulassungsliste hinzufügen oder Projekt aus der Zulassungsliste entfernen.

gcloud

Verwenden Sie den Befehl network-services multicast-group-ranges update, um die Akzeptanzliste für einen Multicastgruppenbereich festzulegen.

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

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
  • LIST_OF_CONSUMERS: Ein oder mehrere Verbraucherprojekte, die diesen Multicastgruppenbereich verwenden können. Sie können bis zu 100 Projekte anhand ihrer ID oder ihres Namens angeben.

API

Verwenden Sie die Methode multicastGroupRanges.patch, um die Akzeptanzliste für einen Multicastgruppenbereich festzulegen.

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

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID des Projekts des Multicast-Administrators
  • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
  • LIST_OF_CONSUMERS: Ein oder mehrere Verbraucherprojekte, die diesen Multicastgruppenbereich verwenden können. Verwenden Sie das folgende Format: "project-1", "project-2". Sie können bis zu 100 Projekte anhand ihrer ID oder ihres Namens angeben.

Projekt auf die Zulassungsliste setzen

In diesem Abschnitt wird beschrieben, wie Sie ein Multicast-Nutzerprojekt der Akzeptanzliste für einen Multicast-Gruppenbereich hinzufügen.

gcloud

Verwenden Sie den Befehl network-services multicast-group-ranges update, um ein Multicast-Nutzerprojekt der Akzeptanzliste hinzuzufügen.

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

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
  • LIST_OF_CONSUMERS: ein oder mehrere Multicast-Nutzerprojekte, die der Akzeptanzliste hinzugefügt werden sollen, damit sie diesen Multicast-Gruppenbereich verwenden können.

API

So fügen Sie ein Multicast-Nutzerprojekt der Zulassungsliste hinzu: Rufen Sie die aktuelle Zulassungsliste ab und senden Sie dann eine API-Anfrage, um die Liste zu aktualisieren:

  1. Wenn Sie die aktuelle Akzeptanzliste für den Gruppenbereich abrufen möchten, folgen Sie der Anleitung unter Multicast-Gruppenbereiche ansehen. Kopieren Sie die Akzeptanzliste, damit Sie sie im nächsten Schritt verwenden können.

  2. Verwenden Sie zum Aktualisieren der Annahmeliste die Methode multicastGroupRanges.patch.

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

    Ersetzen Sie die folgenden Werte:

    • PROJECT_ID: die ID des Projekts des Multicast-Administrators
    • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
    • UPDATED_LIST_OF_CONSUMERS: die aktualisierte Liste der Projekte, die die vorhandenen Projekte, die beibehalten werden sollen, und alle neuen Projekte enthält, die hinzugefügt werden sollen. Verwenden Sie das folgende Format: "project-1", "project-2". Die API ersetzt die gesamte Liste der Nutzerakzeptanz durch die von Ihnen bereitgestellte Liste.

Projekt aus der Zulassungsliste entfernen

In diesem Abschnitt wird beschrieben, wie Sie ein Multicast-Nutzerprojekt aus der Akzeptanzliste für einen Multicast-Gruppenbereich entfernen.

gcloud

Wenn Sie ein Multicast-Nutzerprojekt aus der Zulassungsliste entfernen möchten, verwenden Sie den Befehl network-services multicast-group-ranges update.

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

Ersetzen Sie die folgenden Werte:

  • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
  • LIST_OF_CONSUMERS: Ein oder mehrere Multicast-Nutzerprojekte, die aus der Liste der akzeptierten Nutzer entfernt werden sollen, damit sie diesen Multicast-Gruppenbereich nicht verwenden können.

API

Wenn Sie ein Multicast-Nutzerprojekt aus der Zulassungsliste entfernen möchten, rufen Sie die aktuelle Zulassungsliste ab und senden Sie dann eine API-Anfrage, um die Liste zu aktualisieren:

  1. Wenn Sie die aktuelle Akzeptanzliste für den Gruppenbereich abrufen möchten, folgen Sie der Anleitung unter Multicast-Gruppenbereiche ansehen. Kopieren Sie die Akzeptanzliste, damit Sie sie im nächsten Schritt verwenden können.

  2. Verwenden Sie zum Aktualisieren der Annahmeliste die Methode multicastGroupRanges.patch.

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

    Ersetzen Sie die folgenden Werte:

    • PROJECT_ID: die ID des Projekts des Multicast-Administrators
    • GROUP_RANGE_NAME: Name des Multicastgruppenbereichs
    • UPDATED_LIST_OF_CONSUMERS: die aktualisierte Liste der Projekte, die die vorhandenen Projekte enthält, die beibehalten werden sollen, und alle Projekte ausschließt, die Sie entfernen möchten. Verwenden Sie das folgende Format: "project-1", "project-2". Die API ersetzt die gesamte Liste der Verbraucherzustimmungen durch die von Ihnen bereitgestellte Liste.

Liste der akzeptierten Absender löschen

In diesem Abschnitt wird beschrieben, wie Sie die Akzeptanzliste für einen Multicastgruppenbereich löschen.

gcloud

Verwenden Sie den network-services multicast-group-ranges update-Befehl, um die Liste der akzeptierten Empfänger für einen Multicastgruppenbereich zu löschen.

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

Ersetzen Sie GROUP_RANGE_NAME durch den Namen des Multicast-Gruppenbereichs.

API

Verwenden Sie die Methode multicastGroupRanges.patch, um die Liste der akzeptierten Empfänger für einen Multicastgruppenbereich zu löschen.

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

Ersetzen Sie die folgenden Werte:

  • PROJECT_ID: die ID des Multicast-Administratorprojekts
  • GROUP_RANGE_NAME: der Name des Multicastgruppenbereichs