Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

更新多點傳播網域參數

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

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

事前準備

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

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

指定這些參數之前，請參閱下列內容：
- 請參閱 Cloud Multicast 總覽，瞭解多播流量的相關限制。
- 請參閱下列選用和必要旗標的相關資訊：
  - 如果您在建立多點傳播網域啟用作業時已指定 --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 會使用這些參數判斷多點播送基礎架構的規模。

指定這些參數之前，請參閱下列內容：
- 請參閱 Cloud Multicast 總覽，瞭解多播流量的相關限制。
- 請參閱下列選填和必填欄位資訊：
  - 如果您在建立多點傳播網域啟用作業時已指定 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 的值。