認知服務的自訂子網域名稱

Azure 認知服務會針對透過 Azure 入口網站Azure Cloud ShellAzure CLI 建立的每個資源,使用自訂子網域名稱。 不同於特定 Azure 區域中所有客戶常見的區域端點,自訂子網域名稱對於資源而言是唯一的。 需要自訂子網域名稱,才能啟用 Azure Active Directory (Azure AD) 等功能進行驗證。

這會如何影響現有的資源?

在 2019 年 7 月 1 日前建立的認知服務資源,將會使用相關聯服務的區域端點。 這些端點將會使用現有和新的資源。

如果您想要遷移現有資源以利用自訂子網域名稱,讓您可以啟用 Azure AD 等功能,請遵循下列指示:

  1. 登入 Azure 入口網站,並找出要新增自訂子網域名稱的認知服務資源。
  2. 在 [概觀] 刀鋒視窗中,找出[產生自訂網域名稱] 並加以選取。
  3. 此時會開啟一個面板,說明如何為您的資源建立唯一的自訂子網域。

    警告

    您建立自訂子網域名稱之後,便無法變更。

我是否需要更新現有資源?

不會。 區域端點將繼續針對新建和現有的認知服務運作,而且自訂子網域名稱為選用。 即使新增自訂子網域名稱,區域端點仍將繼續使用該資源。

如果 SDK 要求我提供資源的區域,該怎麼辦?

警告

語音服務會使用自訂子網域搭配私人端點。 在所有其他情況下,請使用區域端點搭配語音服務和相關聯的 SFK。

同時支援區域端點和自訂子網域名稱,而且可以交換使用。 但是必須要有完整的端點。

您可以在 Azure 入口網站中資源的 [概觀] 刀鋒視窗中找到區域資訊。 如需區域端點的完整清單,請參閱是否有區域端點的清單?

自訂子網域名稱是否為區域性?

是。 使用自訂子網域名稱並不會變更認知服務資源的任何區域性層面。

自訂子網域名稱的需求為何?

自訂子網域名稱對您的資源為唯一。 名稱只能包含英數字元和 - 字元;其長度必須介於 2 到 64 個字元之間,且結尾不可以是 -

我可以變更自訂網域名稱嗎?

不會。 自訂子網域名稱建立並與資源建立關聯之後,就無法變更。

我可以重複使用自訂網域名稱嗎?

每個自訂子網域名稱都是唯一的,因此若要重複使用您已指派給認知服務資源的自訂子網域名稱,您必須刪除現有的資源。 刪除資源之後,您便可以重複使用自訂子網域名稱。

有區域端點的清單嗎?

是。 這是您可以搭配 Azure 認知服務資源使用的區域端點清單。

注意

翻譯工具服務和 Bing 搜尋 API 會使用全域端點。

端點類型 區域 端點
公開 全域 (翻譯工具 & Bing) https://api.cognitive.microsoft.com
澳大利亞東部 https://australiaeast.api.cognitive.microsoft.com
巴西南部 https://brazilsouth.api.cognitive.microsoft.com
加拿大中部 https://canadacentral.api.cognitive.microsoft.com
美國中部 https://centralus.api.cognitive.microsoft.com
東亞 https://eastasia.api.cognitive.microsoft.com
美國東部 https://eastus.api.cognitive.microsoft.com
美國東部 2 https://eastus2.api.cognitive.microsoft.com
法國中部 https://francecentral.api.cognitive.microsoft.com
印度中部 https://centralindia.api.cognitive.microsoft.com
日本東部 https://japaneast.api.cognitive.microsoft.com
南韓中部 https://koreacentral.api.cognitive.microsoft.com
美國中北部 https://northcentralus.api.cognitive.microsoft.com
北歐 https://northeurope.api.cognitive.microsoft.com
南非北部 https://southafricanorth.api.cognitive.microsoft.com
美國中南部 https://southcentralus.api.cognitive.microsoft.com
東南亞 https://southeastasia.api.cognitive.microsoft.com
英國南部 https://uksouth.api.cognitive.microsoft.com
美國中西部 https://westcentralus.api.cognitive.microsoft.com
西歐 https://westeurope.api.cognitive.microsoft.com
美國西部 https://westus.api.cognitive.microsoft.com
美國西部 2 https://westus2.api.cognitive.microsoft.com
US Gov US Gov 維吉尼亞州 https://virginia.api.cognitive.microsoft.us
中國 中國東部 2 https://chinaeast2.api.cognitive.azure.cn
中國北部 https://chinanorth.api.cognitive.azure.cn

另請參閱