建立多點傳播群組範圍

正式發布版 (許可清單)：部分 Google Cloud 客戶可存取 Cloud Multicast。如有意願，請提交存取權申請表單。

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

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

事前準備

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

建立多點播送群組範圍

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

建立群組範圍

將多點傳播群組 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)。此外，與相同網域相關聯的一或多個多點播送群組範圍中的 IP 位址總數，不得超過「每個網域的多點播送群組」配額。

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

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：如果多點傳播消費者接受清單為空白，則決定哪些專案可以使用多點傳播群組範圍。這項設定會決定多點傳播用戶專案是否可以為群組範圍啟用多點傳播用戶虛擬私有雲網路。
       • 如要拒絕所有專案，請加入這個旗標。 如要讓專案使用群組範圍，請將專案加入多點傳播消費者接受清單。
       • (預設) 如要允許所有專案，請排除這個旗標。 凡是可存取多點播送網域的專案，都能使用群組範圍。在 Network Connectivity Center (NCC) 星狀拓撲中，您只要接受網域加入中樞，即可授予專案網域存取權。

     • 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)。此外，與相同網域相關聯的一或多個多點播送群組範圍中的 IP 位址總數，不得超過「每個網域的多點播送群組」配額。

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

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 為空白，則決定哪些專案可以使用多點傳播群組範圍。這項設定會決定多點傳播用戶專案是否可以啟用群組範圍的多點傳播用戶虛擬私有雲網路。
     • 如要拒絕所有專案，請設為 true。 只有將專案新增至 consumerAcceptList，專案才能使用群組範圍。
     • (預設) 如要允許所有專案，請設為 false。 凡是可存取多點播送網域的專案，都能使用群組範圍。在 NCC 星狀拓撲中，您必須接受網域加入中樞，才能授予專案網域存取權。

   • 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。

後續步驟

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