Multicast-Gruppenbereiche erstellen
Auf dieser Seite werden die Schritte beschrieben, die ein Multicast-Administrator ausführen muss, um Multicast-Gruppenbereiche zu erstellen.
Eine Übersicht über den Konfigurationsprozess für Cloud Multicast finden Sie unter Übersicht über die Cloud Multicast-Konfiguration.
Hinweis
Ein Multicast-Gruppenbereich muss mit einer bestimmten Multicast-Domain verknüpft sein. Bevor Sie einen Multicast-Gruppenbereich erstellen, führen Sie die Schritte zum Erstellen einer Multicast-Domain aus.
Multicast-Gruppenbereich erstellen
In diesem Abschnitt wird beschrieben, wie Sie einen Multicast-Gruppenbereich in einer Domain erstellen. Sie können diese Schritte wiederholen, um mehrere Gruppenbereiche in einer bestimmten Domain zu erstellen.
Gruppenbereich erstellen
Verknüpfen Sie einen IP-Adressbereich für die Multicast-Gruppe mit der Multicast-Domain.
gcloud
Reservieren Sie einen internen Bereich im VPC-Netzwerk des Multicast-Administrators, der die Multicast-Gruppen-IP-Adressen enthält, die Sie verwenden möchten. Verwenden Sie den Befehl
network-connectivity internal-ranges create, um einen internen Bereich zu reservieren.gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \ --network=ADMIN_NETWORK \ --ip-cidr-range=CIDR_RANGE
Ersetzen Sie die folgenden Werte:
INTERNAL_RANGE_NAME: ein Name für den zu reservierenden internen BereichADMIN_NETWORK: der Name des Multicast-AdministratornetzwerksCIDR_RANGE: der zu reservierende CIDR-BereichDer von Ihnen angegebene CIDR-Bereich muss eine Adresse der Klasse D sein (z. B.
224.0.0.0–239.255.255.255). Außerdem darf die Gesamtzahl der IP-Adressen in einem oder mehreren Multicast-Gruppenbereichen, die mit derselben Domain verknüpft sind, Ihr Kontingent für Multicast-Gruppen pro Domain nicht überschreiten.
Weitere Informationen zum Erstellen interner Bereiche finden Sie unter Interne Bereiche erstellen und verwenden.
Erstellen Sie einen Multicast-Gruppenbereich mit dem internen Bereich, den Sie reserviert haben. Verwenden Sie den Befehl
network-services multicast-group-ranges create, um einen Multicast-Gruppenbereich zu erstellen.gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \ --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \ --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \ --location=global \ [--require-explicit-accept ] \ [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \ [--distribution-scope=DISTRIBUTION_SCOPE] \ [--enable-logging | --no-enable-logging]
Ersetzen Sie die folgenden Werte:
GROUP_RANGE_NAME: ein Name für den Multicast-GruppenbereichDOMAIN_NAME: der Name der Multicast-Domain, die Sie zuvor erstellt haben.ADMIN_PROJECT: die ID des Multicast-AdministratorprojektsINTERNAL_RANGE_NAME: der Name des internen Bereichs, den Sie zuvor reserviert haben.Geben Sie die folgenden Attribute für Multicast-Traffic, Gruppenmitgliedschaft und Logging an.
Mit Ausnahme des Bereichs für die Trafficverteilung können Sie jede Property später nach Bedarf aktualisieren.
--require-explicit-accept: Bestimmt, welche Projekte den Multicast-Gruppenbereich verwenden können, wenn die Zulassungsliste für Multicast-Nutzer leer ist. Diese Konfiguration bestimmt, ob ein Multicast-Nutzerprojekt ein Multicast-Nutzer-VPC-Netzwerk für den Gruppenbereich aktivieren kann.- Wenn Sie alle Projekte ablehnen möchten, fügen Sie dieses Flag hinzu. Ein Projekt kann den Gruppenbereich nur verwenden, wenn Sie es der Multicast-Nutzerannahmeliste hinzufügen.
- (Standard) Wenn Sie alle Projekte zulassen möchten, schließen Sie dieses Flag aus. Jedes Projekt, das Zugriff auf die Multicast-Domain hat, kann den Gruppenbereich verwenden. In der Sterntopologie des Network Connectivity Center (NCC) gewähren Sie einem Projekt Zugriff auf die Domain, indem Sie es dem Hub hinzufügen.
CONSUMER_ACCEPT_LIST: Wenn Sie--require-explicit-acceptangegeben haben, können Sie eine Liste der Multicast-Nutzerprojekte eingeben, die diesen Multicast-Gruppenbereich verwenden können. Wenn ein Multicast-Nutzerprojekt nicht in der Annahmeliste enthalten ist, kann das Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellen.Sie können bis zu 100 Projekte nach Projekt-ID oder Name angeben.
DISTRIBUTION_SCOPE: Bestimmt den Standortbereich des Multicast-Traffics. Sie können dieses Attribut später nicht mehr aktualisieren.- Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, setzen Sie dieses Flag auf
intra-zone. - (Standard) Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic über Zonen hinweg sendet, setzen Sie dieses Flag auf
intra-region.
- Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, setzen Sie dieses Flag auf
--[no-]enable-logging: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen für den Gruppenbereich aktiviert ist. Diese Einstellung gilt für alle zonalen Aktivierungen des Gruppenbereichs, für die Logging nicht explizit aktiviert oder deaktiviert wird.- Verwenden Sie
--enable-logging, um das Logging zu aktivieren. - (Standard) Wenn Sie das Logging deaktiviert lassen möchten, lassen Sie dieses Flag weg oder verwenden Sie
--no-enable-logging.
- Verwenden Sie
API
Reservieren Sie einen internen Bereich im VPC-Netzwerk des Multicast-Administrators, der die Multicast-Gruppen-IP-Adressen enthält, die Sie verwenden möchten. Verwenden Sie die Methode
internalRanges.create, um einen internen Bereich zu reservieren.POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME { "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK", "ipCidrRange": "CIDR_RANGE" }Ersetzen Sie die folgenden Werte:
INTERNAL_RANGE_NAME: ein Name für den zu reservierenden internen BereichADMIN_PROJECT: die ID des Multicast-AdministratorprojektsADMIN_NETWORK: der Name des Multicast-AdministratornetzwerksCIDR_RANGE: der zu reservierende CIDR-BereichDer von Ihnen angegebene CIDR-Bereich muss eine Adresse der Klasse D sein (z. B.
224.0.0.0–239.255.255.255). Außerdem darf die Gesamtzahl der IP-Adressen in einem oder mehreren Multicast-Gruppenbereichen, die mit derselben Domain verknüpft sind, Ihr Kontingent für Multicast-Gruppen pro Domain nicht überschreiten.
Weitere Informationen zum Erstellen interner Bereiche finden Sie unter Interne Bereiche erstellen und verwenden.
Erstellen Sie einen Multicast-Gruppenbereich mit dem internen Bereich, den Sie reserviert haben. Verwenden Sie zum Erstellen eines Multicast-Gruppenbereichs die Methode
multicastGroupRanges.create.POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME { "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME", "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME", "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT", "consumerAcceptList": [ "CONSUMER_ACCEPT_LIST" ], "distributionScope": "DISTRIBUTION_SCOPE", "logConfig": { "enabled": "LOGGING_ENABLED" } }Ersetzen Sie die folgenden Werte:
GROUP_RANGE_NAME: ein Name für den Multicast-GruppenbereichADMIN_PROJECT: die ID des Multicast-AdministratorprojektsDOMAIN_NAME: der Name der Multicast-Domain, die Sie zuvor erstellt haben.INTERNAL_RANGE_NAME: der Name des internen Bereichs, den Sie zuvor reserviert haben.
Wenn Sie Attribute für Multicast-Traffic, Gruppenmitgliedschaft und Logging angeben möchten, fügen Sie die folgenden Felder in den Anfragetext ein. Mit Ausnahme des Bereichs für die Trafficverteilung können Sie jede Property später nach Bedarf aktualisieren.
REQUIRE_EXPLICIT_ACCEPT: Bestimmt, welche Projekte den Multicast-Gruppenbereich verwenden können, wennconsumerAcceptListleer ist. Diese Konfiguration bestimmt, ob ein Multicast-Nutzerprojekt ein Multicast-Nutzer-VPC-Netzwerk für den Gruppenbereich aktivieren kann.- Wenn Sie alle Projekte ablehnen möchten, legen Sie
truefest. Ein Projekt kann den Gruppenbereich nur verwenden, wenn Sie es zuconsumerAcceptListhinzufügen. - (Standard) Wenn Sie alle Projekte zulassen möchten, legen Sie
falsefest. Jedes Projekt, das Zugriff auf die Multicast-Domain hat, kann den Gruppenbereich verwenden. In der NCC-Sterntopologie gewähren Sie einem Projekt Zugriff auf die Domain, indem Sie es dem Hub hinzufügen.
- Wenn Sie alle Projekte ablehnen möchten, legen Sie
CONSUMER_ACCEPT_LIST: Wenn SierequireExplicitAcceptauftruesetzen, können Sie eine Liste der Multicast-Nutzerprojekte eingeben, die diesen Multicast-Gruppenbereich verwenden können.Wenn ein Multicast-Nutzerprojekt nicht in der Annahmeliste enthalten ist, kann das Projekt keine Multicast-Nutzerkonfigurationen mit diesem Gruppenbereich erstellen.
Sie können bis zu 100 Projekte nach Projekt-ID oder Name angeben. Verwenden Sie das folgende Format:
"consumerAcceptList": ["project-1", "project-2"].DISTRIBUTION_SCOPE: Bestimmt den Standortbereich des Multicast-Traffics. Sie können dieses Attribut später nicht mehr aktualisieren.- Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, legen Sie
INTRA_ZONEfest. - (Standard) Wenn Sie diesen Bereich für das Senden von Multicast-Traffic über Zonen hinweg zulassen möchten, legen Sie
INTRA_REGIONfest.
- Wenn Sie zulassen möchten, dass dieser Bereich Multicast-Traffic nur innerhalb einer Zone sendet, legen Sie
LOGGING_ENABLED: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen für den Gruppenbereich aktiviert ist. Diese Einstellung gilt für alle zonalen Aktivierungen des Gruppenbereichs, für die Logging nicht explizit aktiviert oder deaktiviert wird.- Setzen Sie den Wert auf
true, um das Logging zu aktivieren. - (Standard) Wenn Sie das Logging deaktiviert lassen möchten, lassen Sie das Feld
logConfigweg oder setzen Sieenabledauffalse.
- Setzen Sie den Wert auf
Gruppenbereich aktivieren
Aktivieren Sie den Gruppenbereich in jeder Zone, in der Multicast-Produzenten oder ‑Nutzer die zugehörigen Gruppen-IP-Adressen verwenden müssen.
Wenn Sie einen Gruppenbereich in einer bestimmten Zone nicht aktivieren, können die zugehörigen Gruppen-IP-Adressen nicht zum Senden oder Empfangen von Multicast-Traffic in der Zone verwendet werden.
gcloud
Verwenden Sie den Befehl network-services multicast-group-range-activations create, um einen Multicast-Gruppenbereich zu aktivieren.
gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
--multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
--multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
--location=ZONE \
[--enable-logging | --no-enable-logging]
Ersetzen Sie die folgenden Werte:
GROUP_RANGE_ACTIVATION_NAME: ein Name für die Aktivierung des Multicast-GruppenbereichsADMIN_PROJECT: die Projekt-ID des Multicast-AdministratorsZONE: die Zone, in der der Gruppenbereich aktiviert werden soll. Dies muss eine Zone sein, in der Sie die Domain zuvor aktiviert haben.DOMAIN_ACTIVATION_NAME: der Name der Domainaktivierung, die Sie zuvor in dieser Zone erstellt haben.GROUP_RANGE_NAME: der Name des zuvor erstellten Gruppenbereichs--[no-]enable-logging: optional, bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist. Wenn Sie dieses Flag für die Aktivierung eines zonalen Gruppenbereichs konfigurieren, wird die Einstellung für den globalen Gruppenbereich überschrieben.- (Standard) Wenn Sie die Logging-Einstellung vom globalen Gruppenbereich übernehmen möchten, lassen Sie dieses Flag weg.
- Verwenden Sie
--enable-logging, um das Logging in dieser Zone unabhängig von der globalen Einstellung zu aktivieren. - Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung deaktivieren möchten, verwenden Sie
--no-enable-logging.
API
Verwenden Sie zum Aktivieren eines Multicast-Gruppenbereichs die Methode multicastGroupRangeActivations.create.
POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
"multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
"multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
"logConfig": {
"enabled": "LOGGING_ENABLED"
}
}
Ersetzen Sie die folgenden Werte:
GROUP_RANGE_ACTIVATION_NAME: ein Name für die Aktivierung des Multicast-GruppenbereichsADMIN_PROJECT: die Projekt-ID des Multicast-AdministratorsZONE: die Zone, in der der Gruppenbereich aktiviert werden soll. Dies muss eine Zone sein, in der Sie die Domain zuvor aktiviert haben.DOMAIN_ACTIVATION_NAME: der Name der Domainaktivierung, die Sie zuvor in dieser Zone erstellt haben.GROUP_RANGE_NAME: der Name des zuvor erstellten GruppenbereichsLOGGING_ENABLED: Bestimmt, ob die Protokollierung von Gruppenmitgliedschaftsereignissen aktiviert ist. Wenn Sie das Logging für die Aktivierung eines zonalen Gruppenbereichs konfigurieren, wird die Einstellung für den globalen Gruppenbereich überschrieben.- (Standard) Wenn Sie die Logging-Einstellung vom globalen Gruppenbereich übernehmen möchten, lassen Sie das Feld
logConfigim Anfragetext weg. - Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung aktivieren möchten, setzen Sie
enabledauftrue. - Wenn Sie das Logging in dieser Zone unabhängig von der globalen Einstellung deaktivieren möchten, setzen Sie
enabledauffalse.
- (Standard) Wenn Sie die Logging-Einstellung vom globalen Gruppenbereich übernehmen möchten, lassen Sie das Feld
Nächste Schritte
- Informationen zum Aufrufen der von Ihnen erstellten Multicast-Gruppenbereichskonfigurationen finden Sie unter Multicast-Gruppenbereichskonfigurationen ansehen.
- Konfigurationen für Multicast-Gruppenbereiche aktualisieren
- VPC-Netzwerk zum Erzeugen von Multicast-Traffic aktivieren