教程：利用 ARM 模板参考

项目
07/10/2024

了解如何查找模板架构信息，以及如何使用该信息创建 Azure 资源管理器模板（ARM 模板）。

在本教程中，请使用 Azure 快速启动模板中提供的基础模板。可以使用模板参考文档来验证模板。

资源管理器模板参考部署存储帐户

本教程涵盖以下任务：

打开快速入门模板
了解模板
查找模板参考
编辑模板
部署模板

如果没有 Azure 订阅，请在开始前创建一个试用版订阅。

先决条件

若要完成本文，需要做好以下准备：

包含资源管理器工具扩展的 Visual Studio Code。请参阅快速入门：使用 Visual Studio Code 创建 ARM 模板。

打开快速入门模板

Azure 快速入门模板是 ARM 模板的存储库。无需从头开始创建模板，只需找到一个示例模板并对其自定义即可。本快速入门中使用的模板称为创建标准存储帐户。该模板定义 Azure 存储帐户资源。

在 Visual Studio Code 中，选择“文件”>“打开文件”。

在“文件名”中粘贴以下 URL：

https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json

选择“打开”以打开该文件。
选择“文件”>“另存为”，将该文件作为 azuredeploy.json 保存到本地计算机。

了解架构

在 Visual Studio Code 中，将模板折叠到根级别。你使用最简单的结构，其中包含以下元素：
- $schema：指定描述模板语言版本的 JSON 架构文件所在的位置。
- contentVersion：为此元素指定任意值，以便记录模板中的重要更改。
- metadata：指定模板的元数据。
- parameters：指定执行部署以自定义资源部署时提供的值。
- variables：指定在模板中用作 JSON 片段以简化模板语言表达式的值。此模板不包含此元素。
- resources：指定已在资源组中部署或更新的资源类型。
- outputs：指定部署后返回的值。
展开 resources。已定义 Microsoft.Storage/storageAccounts 资源。屏幕截图上显示的 API 版本为 2022-09-01。 SKU 名称使用参数值。此参数称为 storageAccountType。
展开 parameters 即可查看 storageAccountType 是如何定义的。此参数有八个允许的值。

部署模板

在本地 Shell 中，使用管理员权限运行以下命令。选择用于显示 PowerShell 代码或 CLI 代码的选项卡。

部署模板时，请使用新添加的值（例如 Standard_RAGRS）指定 storageAccountType 参数。如果使用原始快速启动模板，部署会失败，因为 Standard_RAGRS 不是允许的值。

CLI
PowerShell

echo "Enter a project name that is used to generate resource group name:" &&
read projectName &&
echo "Enter the location (i.e. chinaeast):" &&
read location &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'

$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
$location = Read-Host -Prompt "Enter the location (i.e. chinaeast)"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"

清理资源

不再需要 Azure 资源时，请通过删除资源组来清理部署的资源。

在 Azure 门户上的左侧菜单中选择“资源组” 。
在“按名称筛选”字段中输入资源组名称。
选择资源组名称。应会看到，该资源组中总共有六个资源。
在顶部菜单中选择“删除资源组”。

后续步骤

本教程介绍了如何使用模板参考来自定义现有的模板。若要了解如何创建多个存储帐户实例，请参阅：

创建多个实例

通过