Общие сведения о функциях Bicep
В этой статье описаны все функции, которые можно использовать в Bicep-файле. Сведения о определении пользовательских функций см. в разделе "Определяемые пользователем функции". Описание разделов в файле Bicep см . в разделе "Структура и синтаксис Bicep".
Большинство функций работают одинаково независимо от того, развернуты ли они в группе ресурсов, подписке, группе управления или клиенте. Некоторые функции можно использовать не во всех областях. Они отмечены в приведенных ниже списках.
Пространства имен для функций
Все функции Bicep находятся в двух пространствах имен: az
и sys
. Как правило, при использовании функции не нужно указывать пространство имен. Оно указывается только в том случае, если имя функции совпадает с именем другого элемента, определенного в файле Bicep. Например, если вы создадите параметр с именем range
, то функцию range
придется вызывать с указанием пространства имен sys
, чтобы отличить ее от этого параметра.
// Parameter contains the same name as a function
param range int
// Must use sys namespace to call the function.
// The second use of range refers to the parameter.
output result array = sys.range(1, range)
Пространство имен az
содержит функции для развертывания Azure. Пространство имен sys
содержит функции, которые используются для построения значений. Пространство имен sys
также содержит декораторы для параметров и циклов ресурсов. Области имен в этой статье отмечены.
Любая функция
Функция any в Bicep используется для устранения проблем, связанных с предупреждениями о типе данных. Эта функция находится в пространстве имен sys
.
Функции массива
Для работы с массивами доступны следующие функции. Все эти функции находятся в пространстве имен sys
.
- array.
- concat
- contains
- empty
- indexOf
- first
- flatten
- intersection
- last
- lastIndexOf
- length
- min
- max
- range
- skip
- take
- union
Функции без класса между доменами (CIDR)
Для работы с CIDR доступны следующие функции. Все эти функции находятся в sys
пространстве имен:
Функции данных
Для работы с датами доступны следующие функции. Все эти функции находятся в sys
пространстве имен:
Функции для параметров развертывания
Для получения значений, связанных с развертыванием, доступны следующие функции. Все эти функции находятся в az
пространстве имен:
Функции для работы с файлами
Для загрузки содержимого из внешних файлов в файл Bicep доступны следующие функции: Все эти функции находятся в sys
пространстве имен:
Лямбда-функции
Для работы с лямбда-выражениями доступны следующие функции. Все эти функции находятся в sys
пространстве имен:
Логическая функция
Для работы с логическими условиями доступна следующая функция. Эта функция находится в sys
пространстве имен:
Числовые функции
Для работы с целыми числами доступны следующие функции. Все эти функции находятся в sys
пространстве имен:
Функции для работы с объектами
Для работы с объектами доступны следующие функции. Все эти функции находятся в sys
пространстве имен:
Функции файлов параметров
Следующие функции доступны для использования в файлах параметров Bicep. Все эти функции находятся в sys
пространстве имен:
Функции для работы с ресурсами
Для получения значений ресурсов доступны следующие функции. Почти все эти функции находятся в пространстве имен az
. getSecret
Функции list
не имеют квалификаторов пространства имен, так как они именуются непосредственно в типе ресурса:
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (не рекомендуется)
- reference
- resourceId — это можно использовать в любой области, но допустимые параметры изменяются в зависимости от области.
- subscriptionResourceId
- tenantResourceId
Функции для работы с областями
Для получения значений области доступны следующие функции. Все эти функции находятся в az
пространстве имен:
- managementGroup
- resourceGroup — это можно использовать только в развертываниях в группе ресурсов.
- подписка . Это можно использовать только в развертываниях в группе ресурсов или подписке.
- tenant
Строковые функции
Bicep предоставляет следующие функции для работы со строками. Все эти функции находятся в sys
пространстве имен:
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- join
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- string
- substring
- take
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Следующие шаги
- Чтобы выполнить итерацию определенного количества раз при создании типа ресурса, см . итеративные циклы в Bicep.
- Сведения о развертывании созданного файла Bicep см. в статье "Развертывание Bicep-файлов с помощью Azure CLI и Azure PowerShell".