Поделиться через

Общие сведения о функциях 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 пространстве имен:

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

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

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

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

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

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

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

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

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

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

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

Следующие шаги