Функции шаблонов ARM
В этой статье описаны все функции, которые можно использовать в шаблоне Azure Resource Manager (ARM). Сведения об использовании функций в шаблоне см. в разделе Синтаксис шаблона.
Для создания собственных функций см. раздел об определяемых пользователем функциях.
Большинство функций работают одинаково независимо от того, развернуты ли они в группе ресурсов, подписке, группе управления или клиенте. Некоторые функции можно использовать не во всех областях. Они отмечены в приведенных ниже списках.
Совет
Мы рекомендуем использовать Bicep, так как он предоставляет те же возможности, что и шаблоны ARM, и имеет более простой синтаксис. Дополнительные сведения см. в статьях Функции Bicep и Операторы Bicep.
Любая функция
Функция any в Bicep используется для устранения проблем, связанных с предупреждениями о типе данных.
Функции массива
Azure Resource Manager предоставляет ряд функций для работы с массивами.
- array.
- concat
- contains
- createArray
- empty
- first
- indexOf
- intersection
- last
- lastIndexOf
- length
- max
- min
- range
- skip
- take
- union
Для файлов Bicep используйте функции массивов.
Функции CIDR
Для работы с CIDR доступны следующие функции. Все эти функции находятся в пространстве имен sys
.
Функция сравнения
Resource Manager предоставляет ряд функций для выполнения сравнений в шаблонах.
Для файлов Bicep используйте логический оператор coalesce. Для сравнения используйте операторы сравнения.
Функции данных
Azure Resource Manager предоставляет следующие функции для работы с датами:
Для файлов Bicep используйте функции даты.
Функции для параметров развертывания
Диспетчер ресурсов предоставляет следующие функции для получения значений из разделов шаблонов и значений, связанных с развертыванием:
Для файлов Bicep используйте функции развертывания.
Лямбда-функции
Resource Manager предоставляет следующие функции для работы с лямбда-выражениями.
Для файлов Bicep используйте лямбда-функции.
Логические функции
Resource Manager предоставляет для работы с логическими условиями следующие функции:
Для файлов Bicep используйте логическую функцию bool. Для других логических значений используйте логические операторы.
Числовые функции
Диспетчер ресурсов предоставляет следующие функции для работы с целыми числами:
Для файлов Bicep, которые используют int
, min
и max
, используйте числовые функции. Для других числовых значений используйте числовые операторы.
Функции для работы с объектами
Azure Resource Manager предоставляет ряд функций для работы с объектами.
Для файлов Bicep используйте функции для объектов.
Функции для работы с ресурсами
Диспетчер ресурсов предоставляет следующие функции для получения значений ресурсов:
- extensionResourceId
- listAccountSas
- listKeys
- listSecrets
- list*
- pickZones
- providers (не рекомендуется)
- reference
- references
- resourceId — можно использовать в любой области, но допустимые параметры изменяются в зависимости от области.
- subscriptionResourceId
- tenantResourceId
Для файлов Bicep используйте функции для ресурсов.
Функции для работы с областями
Диспетчер ресурсов предоставляет следующие функции для получения значений области резервирования:
- managementGroup — можно использовать только при развертываниях в группе управления.
- resourceGroup — можно использовать только при развертываниях в группе ресурсов.
- subscription — может использоваться только при развертываниях в группу ресурсов или подписку.
- клиент — может использоваться для развертывания в любой области.
Для файлов Bicep используйте функции для области действия.
Строковые функции
Диспетчер ресурсов предоставляет следующие функции для работы со строками:
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- join
- json
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- string
- substring
- take
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Для файлов Bicep используйте строковые функции.
Следующие шаги
- Описание разделов в шаблоне ARM приведено в статье Общие сведения о структуре и синтаксисе шаблонов ARM.
- Сведения о слиянии нескольких шаблонов см. в разделе Использование связанных и вложенных шаблонов при развертывании ресурсов Azure.
- Чтобы выполнить итерацию заданное число раз при создании типа ресурса, см. статью Итерация ресурса в шаблонах ARM.
- Чтобы узнать, как развернуть созданный вами шаблон, см. статью Развертывание ресурсов с помощью шаблонов ARM и Azure PowerShell.