更新多播网域参数

本页介绍了如何通过更新现有地区性多播网域激活的流量参数来调整网域的多播基础架构大小。

如需了解如何创建和激活多播网域，请参阅创建多播网域。

准备工作

在更新多播网域参数之前，请查看以下内容并相应地规划更新：

• 更新期间的服务可用性：此过程可能会导致服务暂时中断，因为 Google Cloud 会根据您提供的新参数重新配置多播基础设施。

  • 服务中断适用于您正在更新的特定多播网域激活的多播基础设施。在更新期间，多播提供方和使用方无法发送或接收相应多播网域和可用区的流量。

  • 服务中断的持续时间取决于多种因素，例如当前多播基础设施的规模、使用网域激活创建的多播群组范围激活的数量，以及您提供的新参数的规模。对于大规模配置，更新可能需要 30 分钟到 1 小时才能完成。

• 更新后结算费用的变化：多播网域激活会产生结算费用，如结算中所述。更新多播网域激活的流量参数可能会影响项目产生的账单费用。如需了解详情，请与您的Google Cloud 销售代表联系。

• 更新后多播使用方需要采取的操作：更新完成后，多播使用方必须重新加入网域和可用区中的所有多播群组，才能再次开始接收流量。如有必要，请与多播使用方网络管理员或多播使用方应用所有者协调。

更新多播网域激活

本部分介绍如何更新多播网域激活的参数，这些参数决定了多播基础架构的规模。

如果您在多个可用区中激活了多播网域，请针对要更新的每个可用区级多播网域激活执行以下步骤。

gcloud

如需更新多播网域激活，请使用 network-services multicast-domain-activations update 命令。

以下命令大约需要 10 到 30 分钟才能完成。命令成功完成后，可能还需要几分钟时间，基础设施才能准备好接收和分发多播流量。对于大规模配置，整个过程可能需要 30 分钟到 1 小时才能完全完成。

注意： 如果以下命令返回意外错误（例如超时错误），请再次运行该命令以完成更新。

   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

替换以下值：

• DOMAIN_ACTIVATION_NAME：多播网域激活的名称
• ZONE：在其中激活多播网域的可用区

• 根据您在此可用区中对多播流量的需求指定以下参数。 Google Cloud 会使用这些参数来确定多播基础设施的规模。

  在指定这些参数之前，请参阅以下内容：

  • 查看多播概览中所述的对应多播流量限制。

  • 请参阅以下有关可选标志和必需标志的信息：

    • 如果您之前在创建多播网域激活时指定了 --aggr-egress-pps，则指定 --aggr-egress-pps 是可选操作。否则，此标志为必需标志。
    • 所有其他标志均为可选。

  如需详细了解每个标志，请参阅以下内容：

  • AGGR_EGRESS_PPS：指定可用区的网域中所有多播群组的出站流量每秒数据包 (pps) 总数。出站流量是指从多播基础设施分配到多播使用方的数据包。

    您可以输入介于 0 到 5000000000（5 亿）之间的值。默认值为 1000000（100 万）。系统会根据您为此标志输入的值动态设置其他字段的默认值。

    注意：如果您不知道出站流量 pps 总数，可以使用以下公式进行估算：AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2。

  • AGGR_INGRESS_PPS：指定可用区的网域中所有多播群组的入站流量 pps 总数。入站流量是指从多播提供方发送到多播基础设施的数据包。

    您可以输入介于 0 到 2000000（200 万）之间的值。您为 --aggr-ingress-pps 输入的值不能大于 --aggr-egress-pps 的值。

  • AVG_PACKET_SIZE：平均数据包大小（以字节为单位）。您可以输入介于 64 到 1500 之间的值。

  • MAX_PER_GROUP_INGRESS_PPS：指定可用区的网域中单个多播群组的入站流量 pps 上限。使用此标志可指定网域中最活跃的多播群组，这有助于 Google Cloud 更准确地确定所需的多播基础设施规模。

    您可以输入介于 0 到 2000000（200 万）之间的值。您为 --max-per-group-ingress-pps 输入的值不能大于 --aggr-ingress-pps 的值。

  • MAX_PER_GROUP_SUBSCRIBERS：指定可用区的网域中单个多播群组的多播使用方数量上限。使用此标志可指定具有最多多播使用方的群组，这有助于 Google Cloud 更准确地确定所需的多播基础设施规模。包含此标志不会对群组的多播使用方数量施加限制。

    您可以输入介于 1 到 500 之间的值。

API

如需更新多播网域激活，请使用 multicastDomainActivations.patch 方法。

以下命令大约需要 10 到 30 分钟才能完成。命令成功完成后，可能还需要几分钟时间，基础设施才能准备好接收和分发多播流量。对于大规模配置，整个流程可能需要 30 分钟到 1 小时才能完全完成。

注意： 如果以下请求返回意外错误（例如超时错误），请再次发出请求以完成更新。

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"
  }
}

替换以下值：

• PROJECT_ID：多播管理员项目的 ID
• DOMAIN_ACTIVATION_NAME：多播网域激活的名称
• ZONE：在其中激活多播网域的可用区

• 根据您在此可用区中对多播流量的需求，为 trafficSpec 对象指定值。 Google Cloud 会使用这些参数来确定多播基础设施的规模。

  在指定这些参数之前，请参阅以下内容：

  • 查看多播概览中所述的对应多播流量限制。

  • 请参阅以下有关可选字段和必填字段的信息：

    • 如果您之前在创建多播网域激活时指定了 aggrEgressPps，则指定 aggrEgressPps 是可选操作。否则，此字段为必填字段。
    • trafficSpec 中的所有其他字段均为可选字段。

  如需详细了解各个字段，请参阅以下内容：

  • AGGR_EGRESS_PPS：指定可用区的网域中所有多播群组的出站流量每秒数据包 (pps) 总数。出站流量是指从多播基础设施分配到多播使用方的数据包。

    您可以输入介于 0 到 5000000000（5 亿）之间的值。默认值为 1000000（100 万）。系统会根据您为此字段输入的值动态设置其他字段的默认值。

    注意：如果您不知道出站流量 pps 总数，可以使用以下公式进行估算：AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2。

  • AGGR_INGRESS_PPS：指定可用区的网域中所有多播群组的入站流量 pps 总数。入站流量是指从多播提供方发送到多播基础设施的数据包。

    您可以输入介于 0 到 2000000（200 万）之间的值。您为 aggrIngressPps 输入的值不能大于 aggrEgressPps 的值。

  • AVG_PACKET_SIZE：平均数据包大小（以字节为单位）。您可以输入介于 64 到 1500 之间的值。

  • MAX_PER_GROUP_INGRESS_PPS：指定可用区的网域中单个多播群组的入站流量 pps 上限。使用此字段可指定网域中最活跃的多播群组，这有助于 Google Cloud 更准确地确定所需的多播基础设施规模。

    您可以输入介于 0 到 2000000（200 万）之间的值。您为 maxPerGroupIngressPps 输入的值不能大于 aggrIngressPps 的值。

  • MAX_PER_GROUP_SUBSCRIBERS：指定可用区的网域中单个多播群组的多播使用方数量上限。使用此字段可指定具有最多多播使用方的群组，这有助于 Google Cloud 更准确地确定所需的多播基础设施规模。提供此规范不会对群组的多播使用方数量施加限制。

    您可以输入介于 1 到 500 之间的值。