使用英语阅读

通过

Bicep 函数概述

  • 项目
  • 2025/04/30

本文介绍可在 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 命名空间还包括参数和资源循环的修饰器。 本文对这些命名空间进行了说明。

任何函数

Bicep 中提供了 任何函数 ，以帮助解决有关数据类型警告的问题。 此函数位于 sys 命名空间中。

数组函数

以下函数可用于处理数组。 所有这些函数都位于 sys 命名空间中。

无类域间函数 （CIDR） 函数

以下函数可用于处理 CIDR。 所有这些函数都在命名空间中 sys ：

日期函数

以下函数可用于处理日期。 所有这些函数都在命名空间中 sys ：

部署值函数

以下函数可用于获取与部署相关的值。 所有这些函数都在命名空间中 az ：

文件函数

以下函数可用于将外部文件的内容加载到 Bicep 文件中。 所有这些函数都在命名空间中 sys ：

Lambda 函数

以下函数可用于处理 Lambda 表达式。 所有这些函数都在命名空间中 sys ：

逻辑函数

以下函数可用于处理逻辑条件。 此函数位于命名空间中 sys ：

数值函数

以下函数可用于处理整数。 所有这些函数都在命名空间中 sys ：

对象函数

以下函数可用于处理对象。 所有这些函数都在命名空间中 sys ：

参数文件函数

以下函数可用于 Bicep 参数文件中。 所有这些函数都在命名空间中 sys ：

资源功能

以下函数可用于获取资源值。 其中的大多数函数位于 az 命名空间中。 和listgetSecret函数没有命名空间限定符，因为它们直接在资源类型中命名：

作用域函数

以下函数可用于获取作用域值。 所有这些函数都在命名空间中 az ：

字符串函数

Bicep 提供以下函数用于处理字符串。 所有这些函数都在命名空间中 sys ：

后续步骤