Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

マルチキャストドメインのパラメータを更新する

このページでは、既存のゾーンマルチキャストドメインのアクティベーションのトラフィックパラメータを更新して、ドメインのマルチキャストインフラストラクチャのサイズを変更する方法について説明します。

マルチキャストドメインの作成と有効化については、マルチキャストドメインを作成するをご覧ください。

始める前に

マルチキャストドメインパラメータを更新する前に、次の点を確認し、それに応じて更新を計画してください。

更新中のサービスの可用性: この手順では、指定した新しいパラメータに従って 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～500,000,000（5 億）の値を入力できます。デフォルト値は 1,000,000（100 万）です。他のフィールドのデフォルト値は、このフラグに入力した値に基づいて動的に設定されます。
  
  注: 下り（外向き）pps の合計がわからない場合は、次の式を使用しておおよその値を計算できます。推定できます。 AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2
- AGGR_INGRESS_PPS: 指定されたゾーンのドメインのすべてのマルチキャストグループの入力 pps を集計します。上り（内向き）バケットとは、マルチキャストプロデューサーからマルチキャストインフラストラクチャに送信されるパケットを指します。
  
  0～2,000,000（200 万）の値を入力できます。--aggr-ingress-pps に入力する値は、--aggr-egress-pps の値より大きくすることはできません。
- AVG_PACKET_SIZE: パケットの平均サイズ（バイト単位）。64～1,500 までの値を入力できます。
- MAX_PER_GROUP_INGRESS_PPS: 指定されたゾーンのドメイン内の単一のマルチキャストグループの上り（内向き）pps の最大値。このフラグを使用して、ドメイン内で最もアクティブなマルチキャストグループを指定します。これにより、 Google Cloud はマルチキャストインフラストラクチャに必要なスケールをより正確に判断できます。
  
  0～2,000,000（200 万）の値を入力できます。--max-per-group-ingress-pps に入力する値は、--aggr-ingress-pps の値より大きくすることはできません。
- MAX_PER_GROUP_SUBSCRIBERS: 指定されたゾーンのドメイン内の 1 つのマルチキャストグループに存在するマルチキャストコンシューマーの最大数。このフラグを使用して、マルチキャストコンシューマーが最も多いグループを指定します。これにより、 Google Cloud はマルチキャストインフラストラクチャに必要な規模をより正確に判断できます。このフラグを指定しても、グループのマルチキャストコンシューマーの数に上限は適用されません。
  
  1～500 までの値を入力できます。

API

マルチキャストドメインの有効化を更新するには、multicastDomainActivations.patch メソッドを使用します。

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