開始使用適用於 .NET 的 Azure CDN 程式庫

您可以使用 適用於 .NET 的 Azure CDN 程式庫 ，自動建立和管理 CDN 設定檔與端點。 本教學課程會逐步建立簡單的 .NET 主控台應用程式，示範數個可用的作業。 本教學課程並非旨在詳細說明適用於 .NET 的 Azure CDN 程式庫的所有層面。

您需要 Visual Studio 2015，才能完成本教學課程。 Visual Studio Community 2015 可供免費下載。

必要條件

在撰寫 CDN 管理程式碼之前，您必須做一些準備工作，讓程式碼與 Azure Resource Manager 進行互動。 若要執行這項準備作業，您必須：

• 建立資源群組，以包含本教學課程中建立的 CDN 設定檔
• 設定 Microsoft Entra ID，針對應用程式提供驗證
• 將權限套用到資源群組，以便只有來自您 Microsoft Entra 租用戶的授權使用者可以與 CDN 設定檔進行互動

建立資源群組

1. 登入 Azure 入口網站。

2. 按一下 [建立資源]。

3. 搜尋 [資源群組]，然後在 [資源群組] 窗格中，按一下 [建立]。

   

4. 將您的資源群組命名為 CdnConsoleTutorial 。 選取您的訂用帳戶，並選擇離您最近的位置。 您可以視需要按一下 [釘選到儀表板] 核取方塊，將資源群組釘選到入口網站的儀表板上。 釘選可方便日後尋找。 進行選擇之後，按一下 [建立] 。

   

5. 建立資源群組之後，如果您未將它釘選到儀表板，可以依序按一下 [瀏覽] 和 [資源群組] 來尋找。 如需開啟，請按一下資源群組。 請記下您的訂用帳戶 ID。 我們稍後將會用到此資訊。

   

建立 Microsoft Entra 應用程式，然後套用權限

有兩種方式可以使用 Microsoft Entra ID 來進行應用程式驗證：個別使用者或服務主體。 服務主體類似於 Windows 中的服務帳戶。 我們並未授與特定使用者權限來與 CDN 設定檔互動，而是改為將權限授與服務主體。 服務主體通常用於自動化的非互動式處理程序。 雖然本教學課程是撰寫互動式主控台應用程式，但我們將著重在服務主體處理方法。

建立服務主體包含數個步驟，其中包括建立 Microsoft Entra 應用程式。 若要建立它，我們將遵循此教學課程。

一旦您建立服務主體並指派 CDN 設定檔參與者角色之後，資源群組的 [使用者] 刀鋒視窗看起來應該如下列映像所示。

互動式使用者驗證

如果比起服務主體，您比較需要使用互動式個別使用者驗證，則此程序與服務主體的程序很類似。 事實上，您必須遵循相同的程序，但要進行些微變更。

1. 當您建立應用程式，而不是 Web 應用程式時，請選擇 [原生應用程式]。

   

2. 在下一個頁面上，系統將提示您輸入重新導向 URI。 URI 不會進行驗證，但請記住您的輸入。 您稍後將會用到此資訊。

3. 不需要 用戶端驗證金鑰。

4. 我們不會將服務主體指派給 CDN 設定檔參與者 角色，而是會指派個別使用者或群組。 在此範例中，您可以看到我已將「CDN 示範使用者」 指派給 CDN 設定檔參與者 角色。

   

建立專案並新增 NuGet 封裝

現在，我們已為 CDN 設定檔建立資源群組，並為 Microsoft Entra 應用程式授與權限來管理該群組內的 CDN 設定檔和端點，我們可以開始建立應用程式。

從 Visual Studio 2015 中，依序選取 [檔案]、[新增] 和 [專案...]，以開啟 [新增專案] 對話方塊。 展開 [Visual C#]，然後選取左側窗格中的 [Windows]。 選取中央窗格的 [主控台應用程式]。 為您的專案命名，然後選取 [確定]。

我們的專案將使用 NuGet 封裝內含的一些 Azure 程式庫。 讓我們將這些程式庫新增至專案。

1. 依序選取 [工具] 功能表、[Nuget 封裝管理員] 及 [封裝管理員主控台]。

   

2. 在 [封裝管理員主控台] 中，執行下列命令來安裝 Active Directory Authentication Library (ADAL)：

   Install-Package Microsoft.Identity.Client

3. 執行下列命令來安裝 Azure CDN 管理程式庫：

   Install-Package Microsoft.Azure.Management.Cdn

指示詞、常數、主要方法和協助程式方法

讓我們開始撰寫程式的基本結構。

1. 回到 [Program.cs] 索引標籤，使用下列命令取代頂端的 using 指示詞：

   using System;
   using System.Collections.Generic;
   using Microsoft.Azure.Management.Cdn;
   using Microsoft.Azure.Management.Cdn.Models;
   using Microsoft.Azure.Management.Resources;
   using Microsoft.Azure.Management.Resources.Models;
   using Microsoft.Identity.Client;
   using Microsoft.Rest;
   

2. 我們必須定義一些我們的方法會用到的常數。 在 Program 類別中，但在 Main 方法之前，新增下列程式碼區塊。 務必視需要使用您自己的值來取代預留位置，包括 <角括號>。

   //Tenant app constants
   private const string clientID = "<YOUR CLIENT ID>";
   private const string clientSecret = "<YOUR CLIENT AUTHENTICATION KEY>"; //Only for service principals
   private const string authority = "https://login.microsoftonline.com/<YOUR TENANT ID>/<YOUR TENANT DOMAIN NAME>";
   
   //Application constants
   private const string subscriptionId = "<YOUR SUBSCRIPTION ID>";
   private const string profileName = "CdnConsoleApp";
   private const string endpointName = "<A UNIQUE NAME FOR YOUR CDN ENDPOINT>";
   private const string resourceGroupName = "CdnConsoleTutorial";
   private const string resourceLocation = "<YOUR PREFERRED AZURE LOCATION, SUCH AS Central US>";
   

3. 此外，也要在類別層級設定這兩個變數。 稍後會使用這些變數來判斷我們的設定檔和端點是否已經存在。

   static bool profileAlreadyExists = false;
   static bool endpointAlreadyExists = false;
   

4. 取代 Main 方法，如下所示：

   static void Main(string[] args)
   {
       //Get a token
       AuthenticationResult authResult = GetAccessToken();
   
       // Create CDN client
       CdnManagementClient cdn = new CdnManagementClient(new TokenCredentials(authResult.AccessToken))
           { SubscriptionId = subscriptionId };
   
       ListProfilesAndEndpoints(cdn);
   
       // Create CDN Profile
       CreateCdnProfile(cdn);
   
       // Create CDN Endpoint
       CreateCdnEndpoint(cdn);
   
       Console.WriteLine();
   
       // Purge CDN Endpoint
       PromptPurgeCdnEndpoint(cdn);
   
       // Delete CDN Endpoint
       PromptDeleteCdnEndpoint(cdn);
   
       // Delete CDN Profile
       PromptDeleteCdnProfile(cdn);
   
       Console.WriteLine("Press Enter to end program.");
       Console.ReadLine();
   }
   

5. 在我們的其他方法中有一些會透過「是/否」問題來提示使用者。 新增下列方法，以使其更加容易：

   private static bool PromptUser(string Question)
   {
       Console.Write(Question + " (Y/N): ");
       var response = Console.ReadKey();
       Console.WriteLine();
       if (response.Key == ConsoleKey.Y)
       {
           return true;
       }
       else if (response.Key == ConsoleKey.N)
       {
           return false;
       }
       else
       {
           // They pressed something other than Y or N.  Let's ask them again.
           return PromptUser(Question);
       }
   }
   

現在已撰寫了程式的基本結構，我們應該建立 Main 方法所呼叫的方法。

驗證

在可以使用 Azure CDN 管理庫之前，需要先驗證服務主體，並取得驗證權杖。 此方法會使用 Active Directory 驗證程式庫來擷取權杖。

private static AuthenticationResult GetAccessToken()
{
    AuthenticationContext authContext = new AuthenticationContext(authority);
    ClientCredential credential = new ClientCredential(clientID, clientSecret);
    AuthenticationResult authResult =
        authContext.AcquireTokenAsync("https://management.core.windows.net/", credential).Result;

    return authResult;
}

如果您使用個別使用者驗證，GetAccessToken 方法看起來就會稍有不同。

private static AuthenticationResult GetAccessToken()
{
    AuthenticationContext authContext = new AuthenticationContext(authority);
    AuthenticationResult authResult = authContext.AcquireTokenAsync("https://management.core.windows.net/",
        clientID, new Uri("http://<redirect URI>"), new PlatformParameters(PromptBehavior.RefreshSession)).Result;

    return authResult;
}

務必使用您在 Microsoft Entra ID 中註冊應用程式時所輸入的重新導向 URI 來取代 <redirect URI>。

列出 CDN 設定檔和端點

現在我們已經準備好執行 CDN 作業。 方法的首要任務就是列出資源群組中的所有設定檔和端點，且如果找到與常數中所指定的設定檔和端點名稱相符的項目，請記下該項目以供後續使用，如此一來，我們就不用嘗試建立重複的項目。

private static void ListProfilesAndEndpoints(CdnManagementClient cdn)
{
    // List all the CDN profiles in this resource group
    var profileList = cdn.Profiles.ListByResourceGroup(resourceGroupName);
    foreach (Profile p in profileList)
    {
        Console.WriteLine("CDN profile {0}", p.Name);
        if (p.Name.Equals(profileName, StringComparison.OrdinalIgnoreCase))
        {
            // Hey, that's the name of the CDN profile we want to create!
            profileAlreadyExists = true;
        }

        //List all the CDN endpoints on this CDN profile
        Console.WriteLine("Endpoints:");
        var endpointList = cdn.Endpoints.ListByProfile(p.Name, resourceGroupName);
        foreach (Endpoint e in endpointList)
        {
            Console.WriteLine("-{0} ({1})", e.Name, e.HostName);
            if (e.Name.Equals(endpointName, StringComparison.OrdinalIgnoreCase))
            {
                // The unique endpoint name already exists.
                endpointAlreadyExists = true;
            }
        }
        Console.WriteLine();
    }
}

建立 CDN 設定檔和端點

接下來，我們會建立設定檔。

private static void CreateCdnProfile(CdnManagementClient cdn)
{
    if (profileAlreadyExists)
    {
        Console.WriteLine("Profile {0} already exists.", profileName);
    }
    else
    {
        Console.WriteLine("Creating profile {0}.", profileName);
        ProfileCreateParameters profileParms =
            new ProfileCreateParameters() { Location = resourceLocation, Sku = new Sku(SkuName.StandardVerizon) };
        cdn.Profiles.Create(profileName, profileParms, resourceGroupName);
    }
}

建立設定檔之後，我們將建立端點。

private static void CreateCdnEndpoint(CdnManagementClient cdn)
{
    if (endpointAlreadyExists)
    {
        Console.WriteLine("Profile {0} already exists.", profileName);
    }
    else
    {
        Console.WriteLine("Creating endpoint {0} on profile {1}.", endpointName, profileName);
        EndpointCreateParameters endpointParms =
            new EndpointCreateParameters()
            {
                Origins = new List<DeepCreatedOrigin>() { new DeepCreatedOrigin("Contoso", "www.contoso.com") },
                IsHttpAllowed = true,
                IsHttpsAllowed = true,
                Location = resourceLocation
            };
        cdn.Endpoints.Create(endpointName, endpointParms, profileName, resourceGroupName);
    }
}

清除端點

假設端點已建立，我們可能想要在程式中執行的一個常見工作是清除此端點中的內容。

private static void PromptPurgeCdnEndpoint(CdnManagementClient cdn)
{
    if (PromptUser(String.Format("Purge CDN endpoint {0}?", endpointName)))
    {
        Console.WriteLine("Purging endpoint. Please wait...");
        cdn.Endpoints.PurgeContent(resourceGroupName, profileName, endpointName, new List<string>() { "/*" });
        Console.WriteLine("Done.");
        Console.WriteLine();
    }
}

刪除 CDN 設定檔和端點

最後一個方法會刪除我們的端點和設定檔。

private static void PromptDeleteCdnEndpoint(CdnManagementClient cdn)
{
    if(PromptUser(String.Format("Delete CDN endpoint {0} on profile {1}?", endpointName, profileName)))
    {
        Console.WriteLine("Deleting endpoint. Please wait...");
        cdn.Endpoints.DeleteIfExists(endpointName, profileName, resourceGroupName);
        Console.WriteLine("Done.");
        Console.WriteLine();
    }
}

private static void PromptDeleteCdnProfile(CdnManagementClient cdn)
{
    if(PromptUser(String.Format("Delete CDN profile {0}?", profileName)))
    {
        Console.WriteLine("Deleting profile. Please wait...");
        cdn.Profiles.DeleteIfExists(profileName, resourceGroupName);
        Console.WriteLine("Done.");
        Console.WriteLine();
    }
}

執行程式

我們現在可以按一下 Visual Studio 中的 [開始] 按鈕來編譯及執行程式。

當程式達到上述提示時，您應該能夠回到您在 Azure 入口網站中的資源群組，並看見設定檔已建立。

接著，可確認提示來執行程式的其餘部分。

後續步驟

若要查看此逐步解說中已完成的專案，請 下載範例。

若要尋找適用於 .NET 的 Azure CDN 管理程式庫的其他相關文件，請檢視 MSDN 上的參考。

使用 PowerShell管理 CDN 資源。