Функции 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.

Функции CIDR

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

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

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

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

Для получения значений, связанных с развертыванием, доступны следующие функции. Все эти функции находятся в пространстве имен az.

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

Для загрузки содержимого из внешних файлов в файл Bicep доступны следующие функции: Все эти функции находятся в пространстве имен sys.

Лямбда-функции

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

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

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

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

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

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

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

Функции файла параметров

Функция getSecret доступна в Bicep для получения безопасного значения из KeyVault. Эта функция находится в пространстве имен az.

Функция readEnvironmentVariable доступна в Bicep для чтения значений переменных среды. Эта функция находится в пространстве имен sys.

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

Для получения значений ресурсов доступны следующие функции. Почти все эти функции находятся в пространстве имен az. Функции получения списков и getSecret вызываются напрямую для типа ресурса, поэтому у них нет квалификатора пространства имен.

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

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

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

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

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

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