建立多點傳播群組範圍

本頁說明多播管理員建立多播群組範圍的步驟。

如要瞭解多播設定程序的總覽，請參閱「多播設定總覽」。

事前準備

多點播送群組範圍必須與特定多點播送網域建立關聯。建立多播群組範圍前，請先按照步驟建立多播網域。

建立多點傳播群組範圍

本節說明如何在網域中建立多點傳播群組範圍。您可以重複這些步驟，在指定網域中建立多個群組範圍。

建立群組範圍

將多點傳播群組 IP 位址範圍與多點傳播網域建立關聯。

gcloud

1. 在多播管理員虛擬私有雲網路中，保留包含要使用多播群組 IP 位址的內部範圍。如要預留內部範圍，請使用 network-connectivity internal-ranges create 指令。

   gcloud network-connectivity internal-ranges create INTERNAL_RANGE_NAME \
      --network=ADMIN_NETWORK \
      --ip-cidr-range=CIDR_RANGE
   

   替換下列值：

   • INTERNAL_RANGE_NAME：要保留的內部範圍名稱
   • ADMIN_NETWORK：多點傳播管理員網路的名稱

   • CIDR_RANGE：要保留的 CIDR 範圍

     您指定的 CIDR 範圍必須是 D 類別位址 (例如 224.0.0.0 - 239.255.255.255)，且前置字串必須大於或等於 /23。舉例來說，224.1.60.0/24 是有效範圍。前置字串長度小於或等於 /22 的範圍無效。

   如要進一步瞭解如何建立內部範圍，請參閱「建立及使用內部範圍」。

2. 使用您保留的內部範圍，建立多播群組範圍。如要建立多點傳播群組範圍，請使用 network-services multicast-group-ranges create 指令。

   gcloud network-services multicast-group-ranges create GROUP_RANGE_NAME \
      --multicast-domain="projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME" \
      --reserved-internal-range="projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME" \
      --location=global \
      [--require-explicit-accept ] \
      [--consumer-accept-list=CONSUMER_ACCEPT_LIST] \
      [--distribution-scope=DISTRIBUTION_SCOPE] \
      [--enable-logging | --no-enable-logging]
   

   替換下列值：

   • GROUP_RANGE_NAME：多點傳播群組範圍的名稱
   • DOMAIN_NAME：先前建立的多播網域名稱
   • ADMIN_PROJECT：多點傳播管理員專案的 ID
   • INTERNAL_RANGE_NAME：您先前保留的內部範圍名稱

   • 請為多點播送流量、群組成員資格和記錄指定下列屬性。

     除了流量分配範圍，您可以在稍後視需要更新各項屬性。

     • --require-explicit-accept：如果多點傳播消費者接受清單為空白，這項屬性會決定哪些專案可以使用多點傳播群組範圍。這項設定決定多點傳播用戶專案是否可以啟用群組範圍的多點傳播用戶 VPC 網路。
       • 如要拒絕所有專案，請加入這個旗標。 只有將專案加入多點傳播消費者接受清單，專案才能使用群組範圍。
       • (預設) 如要允許所有專案，請排除這個旗標。 凡是可存取多點傳播網域的專案，都能使用群組範圍。在 Network Connectivity Center 星狀拓撲中，您必須接受專案加入中樞，才能授予專案網域存取權。

     • CONSUMER_ACCEPT_LIST：如果您指定 --require-explicit-accept，則可以輸入可使用這個多播群組範圍的多播消費者專案清單。如果多點傳播用戶專案不在接受清單中，該專案就無法使用這個群組範圍建立多點傳播用戶設定。

       您最多可以依專案 ID 或名稱指定 100 個專案。

     • DISTRIBUTION_SCOPE：決定多點傳播流量的位置範圍。你之後無法更新這項房源。

       • 如要允許這個範圍僅在區域內傳送多點播送流量，請將這個旗標設為 intra-zone。
       • (預設) 如要允許這個範圍跨區域傳送多點播送流量，請將這個標記設為 intra-region。

     • --[no-]enable-logging：決定是否啟用群組成員記錄事件。

       • 如要啟用記錄功能，請使用 --enable-logging。
       • (預設) 如要停用記錄功能，請使用 --no-enable-logging。

API

1. 在多播管理員虛擬私有雲網路中，保留包含要使用多播群組 IP 位址的內部範圍。如要預留內部範圍，請使用 internalRanges.create 方法。

   POST https://networkconnectivity.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/internalRanges?internalRangeId=INTERNAL_RANGE_NAME
   {
     "network": "projects/ADMIN_PROJECT/global/networks/ADMIN_NETWORK",
     "ipCidrRange": "CIDR_RANGE"
   }
   

   替換下列值：

   • INTERNAL_RANGE_NAME：要保留的內部範圍名稱
   • ADMIN_PROJECT：多點傳播管理員專案的 ID
   • ADMIN_NETWORK：多點傳播管理員網路的名稱

   • CIDR_RANGE：要保留的 CIDR 範圍

     您指定的 CIDR 範圍必須是 D 類別位址 (例如 224.0.0.0 - 239.255.255.255)，且前置字串必須大於或等於 /23。舉例來說，224.1.60.0/24 是有效範圍。前置字串長度小於或等於 /22 的範圍無效。

   如要進一步瞭解如何建立內部範圍，請參閱「建立及使用內部範圍」。

2. 使用您保留的內部範圍，建立多播群組範圍。如要建立多點傳播群組範圍，請使用 multicastGroupRanges.create 方法。

   POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/global/multicastGroupRanges?multicastGroupRangeId=GROUP_RANGE_NAME
   {
     "multicastDomain": "projects/ADMIN_PROJECT/locations/global/multicastDomains/DOMAIN_NAME",
     "reservedInternalRange": "projects/ADMIN_PROJECT/locations/global/internalRanges/INTERNAL_RANGE_NAME",
     "requireExplicitAccept": "REQUIRE_EXPLICIT_ACCEPT",
     "consumerAcceptList": [
         "CONSUMER_ACCEPT_LIST"
     ],
     "distributionScope": "DISTRIBUTION_SCOPE",
     "logConfig": {
         "enabled": "LOGGING_ENABLED"
    }
   }
   

   替換下列值：

   • GROUP_RANGE_NAME：多點傳播群組範圍的名稱
   • ADMIN_PROJECT：多點傳播管理員專案的 ID
   • DOMAIN_NAME：先前建立的多播網域名稱
   • INTERNAL_RANGE_NAME：您先前保留的內部範圍名稱

   如要指定多點播送流量、群組成員資格和記錄的屬性，請在要求主體中加入下列欄位。除了流量分配範圍，您可以在稍後視需要更新各項屬性。

   • REQUIRE_EXPLICIT_ACCEPT：如果 consumerAcceptList 為空白，這項設定會決定哪些專案可以使用多點傳播群組範圍。這項設定決定多點傳播用戶專案是否可以啟用群組範圍的多點傳播用戶 VPC 網路。
     • 如要拒絕所有專案，請設為 true。 您必須將專案新增至 consumerAcceptList，才能使用群組範圍。
     • (預設) 如要允許所有專案，請設為 false。 凡是可存取多點傳播網域的專案，都能使用群組範圍。在 Network Connectivity Center 星狀拓撲中，您必須接受專案加入中樞，才能授予專案網域存取權。

   • CONSUMER_ACCEPT_LIST：如果將 requireExplicitAccept 設為 true，即可輸入可使用這個多播群組範圍的多播消費者專案清單。

     如果多點傳播用戶專案不在接受清單中，該專案就無法使用這個群組範圍建立多點傳播用戶設定。

     您最多可以依專案 ID 或名稱指定 100 個專案。 請使用下列格式："consumerAcceptList": ["project-1", "project-2"]。

   • DISTRIBUTION_SCOPE：決定多點傳播流量的位置範圍。你之後無法更新這項房源。

     • 如要允許這個範圍僅在區域內傳送多點播送流量，請設為 INTRA_ZONE。
     • (預設) 如要允許這個範圍跨區域傳送多點播送流量，請設為 INTRA_REGION。

   • LOGGING_ENABLED：決定是否啟用群組成員記錄事件。

     • 如要啟用記錄功能，請設為 true。
     • (預設) 如要停用記錄功能，請設為 false。

啟用群組範圍

在多點傳播製作人或消費者需要使用相關聯群組 IP 位址的每個區域中，啟用群組範圍。

如果未在特定區域中啟用群組範圍，就無法使用相關聯的群組 IP 位址，在該區域中傳送或接收多點播送流量。

gcloud

如要啟用多點傳播群組範圍，請使用 network-services multicast-group-range-activations create 指令。

  gcloud network-services multicast-group-range-activations create GROUP_RANGE_ACTIVATION_NAME \
     --multicast-domain-activation="projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME" \
     --multicast-group-range="projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME" \
     --location=ZONE \
     [--enable-logging | --no-enable-logging]

替換下列值：

• GROUP_RANGE_ACTIVATION_NAME：多點傳播群組範圍啟用作業的名稱
• ADMIN_PROJECT：多點傳播管理員的專案 ID
• ZONE：要啟用群組範圍的區域。 這必須是您先前啟用網域的區域。
• DOMAIN_ACTIVATION_NAME：您先前在這個區域中建立的網域啟用名稱
• GROUP_RANGE_NAME：您先前建立的群組範圍名稱
• --[no-]enable-logging：選用，決定是否啟用群組成員資格事件記錄。在區域群組範圍啟用時設定這個旗標，會覆寫全域群組範圍的設定。
  • 如要啟用記錄功能，請使用 --enable-logging。
  • (預設) 如要停用記錄功能，請使用 --no-enable-logging。

API

如要啟用多點傳播群組範圍，請使用 multicastGroupRangeActivations.create 方法。

POST https://networkservices.googleapis.com/v1/projects/ADMIN_PROJECT/locations/ZONE/multicastGroupRangeActivations?multicastGroupRangeActivationId=GROUP_RANGE_ACTIVATION_NAME
{
    "multicastDomainActivation": "projects/ADMIN_PROJECT/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME",
    "multicastGroupRange": "projects/ADMIN_PROJECT/locations/global/multicastGroupRanges/GROUP_RANGE_NAME",
    "logConfig": {
          "enabled": "LOGGING_ENABLED"
    }
}

替換下列值：

• GROUP_RANGE_ACTIVATION_NAME：多點傳播群組範圍啟用作業的名稱
• ADMIN_PROJECT：多點傳播管理員的專案 ID
• ZONE：要啟用群組範圍的區域。 這必須是您先前啟用網域的區域。
• DOMAIN_ACTIVATION_NAME：您先前在這個區域中建立的網域啟用名稱
• GROUP_RANGE_NAME：您先前建立的群組範圍名稱
• LOGGING_ENABLED：決定是否啟用群組成員記錄事件記錄。在區域群組範圍啟用時設定記錄功能，會覆寫全域群組範圍的設定。
  • 如要啟用記錄功能，請設為 true。
  • (預設) 如要停用記錄功能，請設為 false。

後續步驟

• 如要查看您建立的多播群組範圍設定，請參閱「查看多播群組範圍設定」。
• 更新多點傳播群組範圍設定
• 啟用虛擬私有雲網路，產生多點傳播流量