Функции шаблонов 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
• min
• max
• range
• skip
• take
• union

Для файлов Bicep используйте функции массивов.

Функции CIDR

Для работы с CIDR доступны следующие функции. Все эти функции находятся в пространстве имен sys.

• parseCidr
• cidrSubnet
• cidrHost

Функции сравнения

Resource Manager предоставляет ряд функций для выполнения сравнений в шаблонах.

• coalesce
• equals
• less
• lessOrEquals
• greater
• greaterOrEquals

Для файлов Bicep используйте логический оператор coalesce. Для сравнения используйте операторы сравнения.

Функции данных

Azure Resource Manager предоставляет следующие функции для работы с датами:

• dateTimeAdd
• dateTimeFromEpoch
• dateTimeToEpoch
• utcNow

Для файлов Bicep используйте функции даты.

Функции для параметров развертывания

Диспетчер ресурсов предоставляет следующие функции для получения значений из разделов шаблонов и значений, связанных с развертыванием:

• deployment
• environment (среда)
• parameters
• variables

Для файлов Bicep используйте функции развертывания.

Логические функции

Resource Manager предоставляет для работы с логическими условиями следующие функции:

• and
• bool
• false
• if
• not (не);
• или диспетчер конфигурации служб
• true

Для файлов Bicep используйте логическую функцию bool. Для других логических значений используйте логические операторы.

Числовые функции

Диспетчер ресурсов предоставляет следующие функции для работы с целыми числами:

• add
• copyIndex
• div
• float
• int
• min
• max
• mod (модуль)
• mul
• sub

Для файлов Bicep, которые используют int, min и max, используйте числовые функции. Для других числовых значений используйте числовые операторы.

Функции для работы с объектами

Azure Resource Manager предоставляет ряд функций для работы с объектами.

• contains
• createObject
• empty
• intersection
• items
• json
• length
• null
• union

Для файлов Bicep используйте функции для объектов.

Функции для работы с ресурсами

Диспетчер ресурсов предоставляет следующие функции для получения значений ресурсов:

• extensionResourceId
• listAccountSas
• listKeys
• listSecrets
• list*
• pickZones
• providers (не рекомендуется)
• reference
• Ссылки
• resourceId — можно использовать в любой области, но допустимые параметры изменяются в зависимости от области.
• subscriptionResourceId
• tenantResourceId

Для файлов Bicep используйте функции для ресурсов.

Функции для работы с областями

Диспетчер ресурсов предоставляет следующие функции для получения значений области резервирования:

• managementGroup — можно использовать только при развертываниях в группе управления.
• resourceGroup — можно использовать только при развертываниях в группе ресурсов.
• subscription — можно использовать только при развертываниях в группе ресурсов или подписке.
• клиент — может использоваться для развертывания в любой области.

Для файлов Bicep используйте функции для области действия.

Строковые функции

Диспетчер ресурсов предоставляет следующие функции для работы со строками:

• base64
• base64ToJson
• base64ToString
• concat
• contains
• dataUri
• dataUriToString
• empty
• endsWith
• first
• format
• guid
• indexOf
• join
• last
• lastIndexOf
• length
• newGuid
• padLeft
• replace
• skip
• split
• startsWith
• строка
• substring
• take
• toLower
• toUpper
• trim
• uniqueString
• uri
• uriComponent
• uriComponentToString

Для файлов Bicep используйте строковые функции.

Дальнейшие действия

• Описание разделов в шаблоне ARM приведено в статье Общие сведения о структуре и синтаксисе шаблонов ARM.
• Сведения о слиянии нескольких шаблонов см. в разделе Использование связанных и вложенных шаблонов при развертывании ресурсов Azure.
• Чтобы выполнить итерацию заданное число раз при создании типа ресурса, см. раздел Итерация ресурса в шаблонах ARM.
• Чтобы узнать, как развернуть созданный вами шаблон, см. статью Развертывание ресурсов с помощью шаблонов ARM и Azure PowerShell.