Руководство. Добавление ресурса в шаблон Azure Resource Manager

В предыдущем руководстве вы узнали, как создать и развернуть первый пустой шаблон Azure Resource Manager (шаблон ARM). Теперь вы готовы развернуть реальный ресурс на этом шаблоне. В этом случае учетная запись хранения Azure. Эта инструкция занимает 9 минут .

Предпосылки

Рекомендуется завершить вводное руководство по шаблонам, но это не обязательно.

Вам необходимо иметь Visual Studio Code, а также Azure PowerShell или Azure CLI. Дополнительные сведения см. в разделе "Инструменты шаблона".

Добавление ресурса

Чтобы добавить определение учетной записи хранения Azure в существующий шаблон, просмотрите JSON-файл в следующем примере. Вместо того чтобы скопировать разделы шаблона, скопируйте весь файл и замените шаблон его содержимым.

Замените {provide-unique-name} и фигурные скобки {} уникальным именем учетной записи хранения.

{
  "$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 и доступными свойствами, поэтому давайте рассмотрим более подробную информацию.

В этом руководстве вы добавите учетную запись хранения в шаблон. Вы можете просмотреть версию API учетной записи хранения в storageAccounts 2021-09-01. Обратите внимание, что вы не добавляете все свойства в шаблон. Многие свойства являются необязательными. Поставщик Microsoft.Storage ресурсов может освободить новую версию API, но развертываемая версия не требует изменения. Вы можете продолжать использовать эту версию и знать, что результаты развертывания согласованы.

Если вы просматриваете старую версию API , возможно, вы увидите, что доступен меньший набор свойств.

Если вы решите изменить версию API для ресурса, убедитесь, что вы оцениваете свойства для этой версии и соответствующим образом настраиваете шаблон.

Развертывание шаблона

Вы можете развернуть шаблон для создания учетной записи хранения. Присвойте развертыванию другое имя, чтобы его можно было легко найти в истории.

Если вы еще не создали группу ресурсов, см. статью "Создать группу ресурсов". В примере предполагается, что вы задали переменную templateFile как путь к файлу шаблона, как показано в первом руководстве.

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

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Эти ошибки являются двумя возможными сбоями развертывания, которые могут возникнуть:

• 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. В последующих руководствах вы узнаете, как добавлять параметры, переменные, ресурсы и выходные данные в шаблон. Эти функции являются стандартными блоками для гораздо более сложных шаблонов.