Bicep 函式

  • 發行項

本文描述可用於 Bicep 檔案的所有函式。 如需 Bicep 檔案中各區段的描述，請參閱了解 Bicep 檔案的結構和語法。

無論部署至資源群組、訂閱、管理群組或租用戶，大多數函式的運作方式皆相同。 有些函式不能在所有範圍中使用。 這類函式如下所列。

函式的命名空間

兩個命名空間 az 和 sys 包含了所有 Bicep 函式。 使用函式時，通常無須指定命名空間。 只有當函式名稱與您在 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 命名空間。

參數檔案函式

getSecret 函式可在 Bicep 中使用，以從 KeyVault 取得安全值。 此函式位於 az 命名空間。

readEnvironmentVariable 函式可在 Bicep 中使用，以讀取環境變數值。 此函式位於 sys 命名空間。

資源函式

您可使用下列函式來取得資源值。 這些函式大多位於 az 命名空間。 list 函式和 getSecret 函式會直接在資源類型上呼叫，因而沒有命名空間限定詞。

範圍函式

您可使用下列函式來取得範圍值。 這些函式全都位於 az 命名空間。

字串函數

Bicep 提供下列函式來處理字串。 這些函式全都位於 sys 命名空間。

下一步