使用 Private Link 啟用 Azure Digital Twins 的私人存取

本節說明如何在 Azure 入口網站 中設定 Azure Digital Twins 實例時開啟 Private Link。

Private Link 選項位於 實例設定的 [網络] 索引 標籤中。

1. 開始在 Azure 入口網站 中設定 Azure Digital Twins 實例。 如需指示，請參閱設定執行個體和驗證。

2. 當您到達實例設定的 [網络] 索引標籤時，您可以選取 [連線方法] 的 [私人端點] 選項來啟用私人端點。

   這樣做會新增名為 私人端點連線 的區段，您可以在其中設定私人端點的詳細數據。 選取 [+ 新增] 按鈕以繼續。

   

3. 在開啟的 [ 建立私人端點 ] 頁面中，輸入新私人端點的詳細數據。

   

   1. 填入選取的 [訂用帳戶] 和 [資源群組]。 將 [位置] 設定為與要使用的 VNet 相同的位置。 選擇端點的 [ 名稱 ]，然後針對 [目標子資源 ] 選取 [API]。

   2. 接下來，選取 您要用來部署端點的虛擬網路 和 子網 。

   3. 最後，選取是否要 [與私人 DNS 區域整合]。 您可以使用預設值 [是]，或者，如需此選項的說明，則可以遵循入口網站中的連結來深入了解私人 DNS 整合。

   4. 填寫組態選項之後，選取 [ 確定 ] 以完成。

4. 完成此程序之後，入口網站會返回 Azure Digital Twins 實例設定的 [網络 ] 索引標籤。 確認您的新端點在私人端點連線下可見。

   

5. 使用底部導覽按鈕繼續執行其餘的實例設定。

您無法使用 Azure CLI 在實體建立期間新增 Private Link 端點。

您可以切換至 Azure 入口網站，在實例建立期間新增端點，或繼續進行下一節，以在建立實例之後使用 CLI 新增私人端點。

1. 首先，在瀏覽器中瀏覽至 Azure 入口網站。 在入口網站搜尋列中搜尋 Azure Digital Twins 實例的名稱，以啟動您的 Azure Digital Twins 實例。

2. 選取 左側功能表中的 [網络 ]。

3. 切換至 [私人端點連線] 索引標籤。

4. 選取 [+ 私人端點] 以開啟 [建立私人端點] 設定。

   

5. 在 [基本資料] 索引標籤中，輸入或選取專案的 [訂用帳戶] 和 [資源群組]，以及端點的 [名稱] 和 [區域]。 區域必須與要使用的 VNet 區域相同。

   

   完成時，選取 [下一步：資源 >] 按鈕以移至下一個索引標籤。

6. 在 [資源] 索引標籤中，輸入或選取下列資訊：

   • 線上方法：選取 [ 連線到我的目錄中 的 Azure 資源]，以搜尋您的 Azure Digital Twins 實例。
   • 訂用帳戶：輸入您的訂用帳戶。
   • 資源類型：選取 [Microsoft.DigitalTwins/digitalTwinsInstances
   • 資源：選取 Azure Digital Twins 實例的名稱。
   • 目標子資源：選取 [API]。

   

   完成時，選取 [下一步: 設定 >] 按鈕以移至下一個索引標籤。

7. 在 [設定] 索引標籤中，輸入或選取下列資訊：

   • 虛擬網路：選取您的虛擬網路。
   • 子網路：從虛擬網路中選擇子網路。
   • 與私人 DNS 區域整合：選取是否要 [與私人 DNS 區域整合]。 您可以使用預設值 [是]，或者，如需此選項的說明，則可以遵循入口網站中的連結來深入了解私人 DNS 整合。 如果您選取 [是]，則可以保留預設的設定資訊。

   

   完成時，您可以選取 [檢閱 + 建立] 按鈕以完成設定。

8. 在 [檢閱 + 建立] 索引標籤中，檢閱您的選取項目，然後選取 [建立] 按鈕。

當端點完成部署時，它應該會顯示在 Azure Digital Twins 實例的私人端點連線中。

若要建立私人端點，並使用 Azure CLI 將它連結至 Azure Digital Twins 實例，請使用 az network private-endpoint create 命令。 在參數中使用 --private-connection-resource-id 其完整標識符來識別 Azure Digital Twins 實例。

以下是使用 命令來建立私人端點的範例，只有必要的參數。

az network private-endpoint create --connection-name <private-link-service-connection> --name <name-for-private-endpoint> --resource-group <resource-group> --subnet <subnet-ID> --private-connection-resource-id "/subscriptions/<subscription-ID>/resourceGroups/<resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<Azure-Digital-Twins-instance-name>" 

如需必要和選擇性參數的完整清單，以及更多私人端點建立範例，請參閱 az network private-endpoint create 參考檔。

建立 Azure Digital Twins 實例的私人端點之後，您可以在 Azure Digital Twins 實例的 [網路 ] 索引卷標中檢視它。 此頁面會顯示與 實例相關聯的所有私人端點連線。

選取端點以詳細檢視其資訊、變更其組態設定，或刪除連線。

為 Azure Digital Twins 實例建立私人端點之後，您可以使用 az dt network private-endpoint connection 命令，繼續管理實例的私人端點連線。 工作包括：

• 顯示私人端點連線
• 設定私人端點連線的狀態
• 刪除私人端點連線
• 列出實例的所有私人端點連線

如需詳細資訊和範例，請參閱 az dt network private-endpoint reference 檔。

取得更多 Private Link 資訊

您可以使用 az dt network private-link 命令，取得實例 的 Private Link 狀態詳細資訊。 工作包括：

• 列出與 Azure Digital Twins 實例相關聯的私人連結
• 顯示與實例相關聯的私人連結

如需詳細資訊和範例，請參閱 az dt network private-link 參考檔。

若要在 Azure 入口網站 中停用或啟用公用網路存取，請開啟入口網站並流覽至您的 Azure Digital Twins 實例。

1. 選取 左側功能表中的 [網络 ]。

2. 在 [公用存取] 索引標籤中，將 [允許公用網路存取] 設定為 [已停用] 或 [所有網路]。

   

   選取儲存。

在 Azure CLI 中，您可以將 參數新增 --public-network-access 至 az dt create 命令，以停用或啟用公用網路存取。 雖然此命令也可以用來建立新的實例，但您可以使用它來編輯現有實例的屬性，方法是提供已經存在的實例名稱。 （如需此命令的詳細資訊，請參閱其 參考文件 或 設定 Azure Digital Twins 實例的一般指示。

若要停用 Azure Digital Twins 實例的公用網路存取，請使用 --public-network-access 如下的參數：

az dt create --dt-name <name-of-existing-instance> --resource-group <resource-group> --public-network-access Disabled

若要在目前停用的實例上啟用公用網路存取，請使用下列類似的命令：

az dt create --dt-name <name-of-existing-instance> --resource-group <resource-group> --public-network-access Enabled

使用 ARMClient 命令工具，可以使用下列命令來啟用或停用公用網路存取。

若要停用公用網路存取：

armclient login 

armclient PATCH /subscriptions/<your-Azure-subscription-ID>/resourceGroups/<your-resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<your-Azure-Digital-Twins-instance>?api-version=2020-12-01 "{ 'properties': { 'publicNetworkAccess': 'disabled' } }"  

若要啟用公用網路存取：

armclient login 

armclient PATCH /subscriptions/<your-Azure-subscription-ID>/resourceGroups/<your-resource-group>/providers/Microsoft.DigitalTwins/digitalTwinsInstances/<your-Azure-Digital-Twins-instance>?api-version=2020-12-01 "{ 'properties': { 'publicNetworkAccess': 'enabled' } }"