Multicast-Domain-Parameter aktualisieren

Auf dieser Seite wird beschrieben, wie Sie die Größe der Multicast-Infrastruktur für Ihre Domain ändern, indem Sie die Verkehrsparameter vorhandener zonaler Multicast-Domain-Aktivierungen aktualisieren.

Informationen zum Erstellen und Aktivieren von Multicast-Domains finden Sie unter Multicast-Domains erstellen.

Hinweise

Bevor Sie die Parameter der Multicast-Domain aktualisieren, sollten Sie Folgendes beachten und die Aktualisierung entsprechend planen:

• Dienstverfügbarkeit während der Aktualisierung: Bei diesem Vorgang kann es zu einer vorübergehenden Dienstunterbrechung kommen, während Google Cloud Ihre Multicast-Infrastruktur gemäß den neuen von Ihnen angegebenen Parametern neu bereitstellt.

  • Die Dienstunterbrechung betrifft die Multicast-Infrastruktur für die spezifische Aktivierung der Multicast-Domain, die Sie aktualisieren. Während des Updates können Multicast-Ersteller und ‑Empfänger keinen Traffic für die entsprechende Multicast-Domain und ‑Zone senden oder empfangen.

  • Die Dauer der Dienstunterbrechung hängt von mehreren Faktoren ab, z. B. von der Größe Ihrer aktuellen Multicast-Infrastruktur, der Anzahl der Multicast-Gruppenbereichsaktivierungen, die durch die Domainaktivierung erstellt werden, und der Größe der neuen Parameter, die Sie angeben. Bei umfangreichen Konfigurationen kann das Update zwischen 30 Minuten und einer Stunde dauern.

• Änderungen an Abrechnungsgebühren nach der Aktualisierung: Für die Aktivierung von Multicast-Domains fallen Abrechnungsgebühren an, wie unter Abrechnung beschrieben. Wenn Sie die Verkehrsparameter einer Multicast-Domain-Aktivierung aktualisieren, kann sich das auf die Abrechnungsgebühren für Ihr Projekt auswirken. Weitere Informationen erhalten Sie von IhremGoogle Cloud -Vertriebsmitarbeiter.

• Von Multicast-Nutzern nach dem Update erforderliche Maßnahmen: Nach dem Update müssen Multicast-Nutzer allen Multicast-Gruppen in der Domain und Zone wieder beitreten, um wieder Traffic zu empfangen. Koordinieren Sie sich bei Bedarf mit dem Administrator des Multicast-Nutzer-Netzwerks oder den Inhabern der Multicast-Nutzeranwendung.

Aktivierung einer Multicast-Domain aktualisieren

In diesem Abschnitt wird beschrieben, wie Sie die Parameter einer Multicast-Domain-Aktivierung aktualisieren, die die Skalierung Ihrer Multicast-Infrastruktur bestimmen.

Wenn Sie eine Multicast-Domain in mehreren Zonen aktiviert haben, führen Sie dieses Verfahren für jede zonale Multicast-Domain-Aktivierung aus, die Sie aktualisieren möchten.

gcloud

Verwenden Sie den Befehl network-services multicast-domain-activations update, um eine Aktivierung der Multicast-Domain zu aktualisieren.

Die Ausführung des folgenden Befehls dauert etwa 10 bis 30 Minuten. Nachdem der Befehl erfolgreich abgeschlossen wurde, kann es noch einige Minuten dauern, bis die Infrastruktur bereit ist, Multicast-Traffic zu empfangen und zu verteilen. Bei umfangreichen Konfigurationen kann der gesamte Vorgang zwischen 30 Minuten und einer Stunde dauern.

Hinweis :Wenn der folgende Befehl einen unerwarteten Fehler zurückgibt, z. B. einen Zeitüberschreitungsfehler, führen Sie den Befehl noch einmal aus, um das Update abzuschließen.

   gcloud network-services multicast-domain-activations update DOMAIN_ACTIVATION_NAME \
      --location=ZONE \
      --aggr-egress-pps=AGGR_EGRESS_PPS \
      --aggr-ingress-pps=AGGR_INGRESS_PPS \
      --avg-packet-size=AVG_PACKET_SIZE \
      --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS \
      --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS

Ersetzen Sie die folgenden Werte:

• DOMAIN_ACTIVATION_NAME: der Name der Aktivierung der Multicast-Domain
• ZONE: die Zone, in der die Multicast-Domain aktiviert wurde

• Geben Sie die folgenden Parameter entsprechend Ihren Anforderungen für den Multicast-Traffic in dieser Zone an. Google Cloud verwendet diese Parameter, um die Skalierung Ihrer Multicast-Infrastruktur zu bestimmen.

  Bevor Sie diese Parameter angeben, sollten Sie Folgendes lesen:

  • Sehen Sie sich die entsprechenden Einschränkungen für Multicast-Traffic an, die in der Multicast-Übersicht beschrieben werden.

  • Hier finden Sie Informationen zu optionalen und erforderlichen Flags:

    • Wenn Sie --aggr-egress-pps bereits beim Erstellen der Multicast-Domain-Aktivierung angegeben haben, ist die Angabe von --aggr-egress-pps optional. Andernfalls ist dieses Flag erforderlich.
    • Alle anderen Flags sind optional.

  Weitere Informationen zu den einzelnen Flags finden Sie hier:

  • AGGR_EGRESS_PPS: Die aggregierten ausgehenden Pakete pro Sekunde (pps) für alle Multicastgruppen in der Domain in der angegebenen Zone. Der Begriff „Egress“ bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Nutzer verteilt werden.

    Sie können einen Wert zwischen 0 und 500.000.000 (500 Millionen) eingeben. Der Standardwert ist 1.000.000 (1 Million). Standardwerte für die anderen Felder werden dynamisch auf Grundlage des Werts festgelegt, den Sie für dieses Flag eingeben.

    Hinweis :Wenn Sie die aggregierte Anzahl der ausgehenden Pakete pro Sekunde nicht kennen, können Sie sie mit der folgenden Formel schätzen:AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: Aggregierte PPS für eingehenden Traffic für alle Multicastgruppen in der Domain in der angegebenen Zone. Eingehender Traffic bezieht sich auf Pakete, die von Multicast-Erstellern an die Multicast-Infrastruktur gesendet werden.

    Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für --aggr-ingress-pps eingeben, darf nicht größer als der Wert von --aggr-egress-pps sein.

  • AVG_PACKET_SIZE: durchschnittliche Paketgröße in Byte. Sie können einen Wert zwischen 64 und 1.500 eingeben.

  • MAX_PER_GROUP_INGRESS_PPS: Maximale Anzahl von Paketen pro Sekunde (pps) für eine einzelne Multicastgruppe in der Domain in der angegebenen Zone. Mit diesem Flag können Sie die aktivste Multicastgruppe in der Domain angeben. So kann Google Cloud die erforderliche Skalierung Ihrer Multicastinfrastruktur genauer bestimmen.

    Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für --max-per-group-ingress-pps eingeben, darf nicht größer als der Wert von --aggr-ingress-pps sein.

  • MAX_PER_GROUP_SUBSCRIBERS: Maximale Anzahl von Multicast-Consumern für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Mit diesem Flag können Sie die Gruppe mit den meisten Multicast-Consumern angeben. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmt werden. Wenn Sie dieses Flag einfügen, wird die Anzahl der Multicast-Empfänger für eine Gruppe nicht begrenzt.

    Sie können einen Wert zwischen 1 und 500 eingeben.

API

Verwenden Sie zum Aktualisieren einer Multicast-Domainaktivierung die Methode multicastDomainActivations.patch.

Die Ausführung des folgenden Befehls dauert etwa 10 bis 30 Minuten. Nachdem der Befehl erfolgreich abgeschlossen wurde, kann es noch einige Minuten dauern, bis die Infrastruktur bereit ist, Multicast-Traffic zu empfangen und zu verteilen. Bei umfangreichen Konfigurationen kann der gesamte Vorgang zwischen 30 Minuten und einer Stunde dauern.

Hinweis :Wenn bei der folgenden Anfrage ein unerwarteter Fehler auftritt, z. B. ein Zeitüberschreitungsfehler, wiederholen Sie die Anfrage, um die Aktualisierung abzuschließen.

PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME?updateMask=trafficSpec

{
  "trafficSpec": {
    "aggrEgressPps": "AGGR_EGRESS_PPS",
    "aggrIngressPps": "AGGR_INGRESS_PPS",
    "avgPacketSize": "AVG_PACKET_SIZE",
    "maxPerGroupIngressPps": "MAX_PER_GROUP_INGRESS_PPS",
    "maxPerGroupSubscribers": "MAX_PER_GROUP_SUBSCRIBERS"
  }
}

Ersetzen Sie die folgenden Werte:

• PROJECT_ID: die ID des Projekts des Multicast-Administrators
• DOMAIN_ACTIVATION_NAME: der Name der Aktivierung der Multicast-Domain
• ZONE: die Zone, in der die Multicast-Domain aktiviert wurde

• Geben Sie Werte für das trafficSpec-Objekt entsprechend Ihren Anforderungen für den Multicast-Traffic in dieser Zone an. Google Cloud verwendet diese Parameter, um die Skalierung Ihrer Multicast-Infrastruktur zu bestimmen.

  Bevor Sie diese Parameter angeben, sollten Sie Folgendes lesen:

  • Sehen Sie sich die entsprechenden Einschränkungen für Multicast-Traffic an, die in der Multicast-Übersicht beschrieben werden.

  • Hier finden Sie Informationen zu optionalen und erforderlichen Feldern:

    • Wenn Sie aggrEgressPps bereits beim Erstellen der Multicast-Domainaktivierung angegeben haben, ist die Angabe von aggrEgressPps optional. Andernfalls ist dieses Feld erforderlich.
    • Alle anderen Felder in trafficSpec sind optional.

  Weitere Informationen zu den einzelnen Feldern finden Sie hier:

  • AGGR_EGRESS_PPS: Die aggregierten ausgehenden Pakete pro Sekunde (pps) für alle Multicastgruppen in der Domain in der angegebenen Zone. Der Begriff „Egress“ bezieht sich auf Pakete, die von der Multicast-Infrastruktur an Multicast-Nutzer verteilt werden.

    Sie können einen Wert zwischen 0 und 500.000.000 (500 Millionen) eingeben. Der Standardwert ist 1.000.000 (1 Million). Standardwerte für die anderen Felder werden dynamisch auf Grundlage des Werts festgelegt, den Sie für dieses Feld eingeben.

    Hinweis :Wenn Sie die aggregierte Anzahl der ausgehenden Pakete pro Sekunde nicht kennen, können Sie sie mit der folgenden Formel schätzen:AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: Aggregierte PPS für eingehenden Traffic für alle Multicastgruppen in der Domain in der angegebenen Zone. Eingehender Traffic bezieht sich auf Pakete, die von Multicast-Erstellern an die Multicast-Infrastruktur gesendet werden.

    Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für aggrIngressPps eingeben, darf nicht größer als der Wert von aggrEgressPps sein.

  • AVG_PACKET_SIZE: durchschnittliche Paketgröße in Byte. Sie können einen Wert zwischen 64 und 1.500 eingeben.

  • MAX_PER_GROUP_INGRESS_PPS: Maximale Anzahl von Paketen pro Sekunde (pps) für eine einzelne Multicastgruppe in der Domain in der angegebenen Zone. In diesem Feld können Sie die aktivste Multicastgruppe in der Domain angeben. So kann Google Cloud die erforderliche Skalierung Ihrer Multicastinfrastruktur genauer bestimmt werden.

    Sie können einen Wert zwischen 0 und 2.000.000 (2 Millionen) eingeben. Der Wert, den Sie für maxPerGroupIngressPps eingeben, darf nicht größer als der Wert von aggrIngressPps sein.

  • MAX_PER_GROUP_SUBSCRIBERS: Maximale Anzahl von Multicast-Consumern für eine einzelne Multicast-Gruppe in der Domain in der angegebenen Zone. Geben Sie in diesem Feld die Gruppe mit den meisten Multicast-Empfängern an. So kann Google Cloud die erforderliche Skalierung Ihrer Multicast-Infrastruktur genauer bestimmt werden. Durch die Angabe dieser Spezifikation wird die Anzahl der Multicast-Nutzer für eine Gruppe nicht begrenzt.

    Sie können einen Wert zwischen 1 und 500 eingeben.