你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Bicep 函数

  • 项目

本文介绍可在 Bicep 文件中使用的所有函数。 有关 Bicep 文件中各部分的说明，请参阅了解 Bicep 文件的结构和语法。

大多数函数在部署到资源组、订阅、管理组或租户时工作方式相同。 某些函数并非可以在所有范围内使用。 下表对这些函数进行了说明。

函数的命名空间

所有 Bicep 函数都包含在两个命名空间中 - az 和 sys。 通常，使用函数时，无需指定命名空间。 仅当函数名称与在 Bicep 文件中定义的另一项相同时，才需要指定命名空间。 例如，如果创建一个名为 range 的参数，则需要通过添加 sys 命名空间来区分 range 函数。

// 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 中提供 any 函数可帮助解决有关数据类型警告的问题。 此函数位于 sys 命名空间中。

数组函数

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

CIDR 函数

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

日期函数

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

部署值函数

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

文件函数

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

Lambda 函数

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

逻辑函数

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

数值函数

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

对象函数

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

参数文件函数

Bicep 中提供了 getSecret 函数，用于从 KeyVault 获取安全值。 此函数位于 az 命名空间中。

Bicep 中提供了 readEnvironmentVariable 函数来读取环境变量值。 此函数位于 sys 命名空间中。

Resource functions

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

作用域函数

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

字符串函数

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

后续步骤