更新多點傳播網域參數

本頁說明如何更新現有區域多播網域啟用的流量參數，藉此調整網域的多播基礎架構大小。

如要瞭解如何建立及啟用多播網域，請參閱「建立多播網域」。

事前準備

更新多點傳播網域參數前，請先詳閱下列資訊，並據此規劃更新：

• 更新期間的服務可用性：這項程序可能會導致服務暫時中斷，因為系統會根據您提供的新參數，重新佈建多點傳播基礎架構。 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 至 500000000 (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 到 500000000 (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 之間的值。