共用方式為

教學課程：將資源新增至 Azure Resource Manager 範本

在 上一個教學課程中，您已瞭解如何建立和部署第一個空白 Azure Resource Manager 範本 （ARM 範本）。 現在，您已準備好將實際資源部署至該範本。 在此情況下，使用 Azure 儲存體帳戶。 完成此指示需要 9 分鐘 。

先決條件

建議您完成 範本的入門教學課程，但這不是必需的。

您必須有 Visual Studio Code，以及 Azure PowerShell 或 Azure CLI。 如需詳細資訊，請參閱 範本工具。

新增資源

若要將 Azure 儲存體帳戶定義新增至現有的範本，請查看下列範例中的 JSON 檔案。 不要嘗試複製模板的各個部分，而是複製整個文件並用其內容替換模板。

將 {provide-unique-name} 和大括弧{}取代為獨特的儲存帳戶名稱。

這很重要

儲存體帳戶名稱必須在 Azure 中是唯一的。 它只有小寫字母或數字，並且限制為 24 個字符。 您可以使用 store1 等名稱作為前綴，然後添加您的姓名縮寫和今天的日期。 例如，名稱可以是 store1abc06132022。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

猜測儲存體帳戶的唯一名稱並不容易，而且不適用於自動化大型部署。 在本教學課程系列的稍後部分，您會使用範本功能來更輕鬆地建立唯一名稱。

資源屬性

您可能想知道如何尋找要用於每個資源類型的屬性。 您可以使用 ARM 範本參考 來尋找您要部署的資源類型。

您部署的每個資源至少具有下列三個屬性：

  • type：資源的類型。 此值是資源提供者的命名空間與資源類型 （例如 Microsoft.Storage/storageAccounts） 的組合。
  • apiVersion：用來建立資源的 REST API 版本。 每個資源提供者都會發佈自己的 API 版本，因此此值是類型特有的。
  • name：資源的名稱。

大部分的資源也有屬性 location ，可設定您部署資源的區域。

其他屬性會因資源類型和 API 版本而異。 了解 API 版本和可用屬性之間的連接非常重要，因此讓我們更詳細地討論。

在本教學課程中，您會將儲存體帳戶新增至範本。 您可以在 storageAccounts 2021-09-01 查看儲存體帳戶的 API 版本。 請注意，您不會將所有屬性新增至範本。 許多屬性都是選擇性的。 Microsoft.Storage資源提供者可以發行新的 API 版本，但您部署的版本不需要變更。 您可以繼續使用該版本，並知道部署結果是一致的。

如果您檢視較舊的 API 版本 ，您可能會看到一組較小的內容可供使用。

如果您決定變更資源的 API 版本，請務必評估該版本的內容，並適當調整範本。

部署範本

您可以部署樣板來創建儲存帳戶。 為您的部署提供不同的名稱，以便您可以在歷史記錄中輕鬆找到它。

如果您尚未建立資源群組，請參閱 建立資源群組。 此範例假設您已將變數設定 templateFile 為範本檔案的路徑，如 第一個教學課程所示。

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

備註

如果部署失敗，請使用 verbose 參數來取得您要建立之資源的相關資訊。 使用 debug 參數取得更多資訊，以進行偵錯。

這些錯誤是您可能會遇到的兩個可能的部署失敗：

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} 不是有效的儲存體帳戶名稱。 儲存體帳戶名稱的長度必須介於 3 到 24 個字元之間，而且只能使用數字和小寫字母。

    在範本中，取代 {provide-unique-name} 為唯一的儲存體帳戶名稱。 請參閱 新增資源。

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 已在使用中。

    在範本中，嘗試不同的儲存體帳戶名稱。

此部署比空白樣板部署耗時更久，因為您正在建立儲存帳戶。 這可能需要大約一分鐘。

確認部署

您可以從 Azure 入口網站探索資源群組來驗證部署。

  1. 登入 Azure 入口網站。
  2. 從左側功能表中，選取 [資源群組]。
  3. 核取 myResourceGroup 左側的方塊，然後選取 myResourceGroup
  4. 選取您部署的資源群組。
  5. 您會看到已部署儲存帳戶。
  6. 請注意，部署標籤現在顯示： 部署：2 成功。

清理資源

如果您要繼續進行下一個教學課程，則不需要刪除資源群組。

如果您現在要停止，您可能想要刪除資源群組來清除已部署的資源。

  1. 從 Azure 入口網站 中，從左側功能表中選取 [資源群組 ]。
  2. 在 [篩選任何欄位... ] 方塊中輸入資源群組名稱。
  3. 核取 myResourceGroup 旁邊的方塊，然後選取 myResourceGroup 或您選擇的資源群組名稱。
  4. 從頂端功能表選取 [刪除資源群組 ]。

後續步驟

您已建立簡單的範本來部署 Azure 儲存體帳戶。 在後面的教學課程中，您將瞭解如何將參數、變數、資源和輸出新增至範本。 這些功能是更複雜範本的建置區塊。

新增參數

  • Last updated on