上一個

下一個

使用範本函式，為您的 Azure Resource Manager 範本增加彈性

已完成

在此情節中，您會想要盡可能輕鬆地將 Azure Resource Manager (ARM) 範本部署到不同的環境。 其中一個競爭區域是 Azure 儲存體帳戶的唯一名稱。

為了解決此問題，您決定使用 ARM 範本函式 (機器翻譯) 建立運算式。

什麼是 ARM 範本函式？

ARM 範本函式藉由在部署期間動態取得值，為您的 ARM 範本增加彈性。

若要了解函式，您必須先了解運算式。 運算式是在部署範本時所評估的值。 運算式的開頭和結尾都是方括弧 []，而且可以傳回字串、整數、布林值、陣列或物件。

在此學習路徑的上一個課程模組中，您已經使用過 Resource Manager 範本中的運算式。 例如，您使用了：

"parameters": {
  "location": {
    "type": "string",
    "defaultValue": "[resourceGroup().location]"
  }
},

運算式是 defaultValue: 屬性的值。 請注意，此運算式會保留 ARM 範本函式 resourceGroup()。 此函式會傳回要部署此範本的資源群組資訊。 .location 會從該函式所傳回的物件中取出一個屬性。 函式可讓您以動態方式建構所需的值。

如何使用 ARM 範本函式？

當您使用函數時，有幾個要遵循的規則：

• 當您將字串值傳遞至函式時，請使用單引號。 範例如下：concat('storage',uniqueString(resourceGroup().id))。 此函式是 concat，而您要傳入函式的字串為 'storage'。

• 若要在範本函式中使用常值，您需要「逸出字元」。 逸出字元會根據您要進行的逸出而有所不同。

• 若要將屬性設定為 null，您可以使用 null 或 [json('null')]。 當您提供 null 作為參數時，JSON 函式會傳回空的物件。

  "stringValue": null,
  "objectValue": "[json('null')]"
  

Resource Manager 為您提供了數個 ARM 範本函式 (機器翻譯)。 函式會根據其類型列在群組中：

• 陣列函式，用於處理陣列。 例如，first 與 last。
• 比較函式，用於在範本中進行比較。 例如，equals 與 greater。
• 日期函式，用於處理日期。 例如，utcNow 與 dateTimeAdd。
• 部署值函式，用於從範本的區段取得值，以及與部署相關的值。 例如，environment 與 parameters。
• 邏輯函式，用於處理邏輯條件。 例如，if 與 not。
• 數值函式，用於處理整數。 例如，max 與 mod。
• 物件函式，用於處理物件。 例如，contains 與 length。
• 資源函式，用於取得資源值。 例如，resourceGroup 與 subscription。
• 字串函式，用於處理字串。 例如，length 與 startsWith。

如何在一個運算式中使用數個函式？

您可以搭配使用數個範本函式，建立自己的運算式。 在此情節中，您需要建立一個運算式，結合前置詞輸入與資源群組識別碼的雜湊，為每個資源群組建立唯一名稱。 此運算式會產生如 dev2hu6fktr577wh 與 staging5his8hgr67tt5 之類的儲存體帳戶名稱。 您可以使用四個函式來建立此字串值。 例如：

"[toLower(concat('Storage',uniqueString(resourceGroup().id)))]"

讓我們逐步解說這個運算式。

從 concat 開始，此函式會接受任意數目的引數，而且可以接受字串或陣列作為參數。 在這裡，您會使用常值字串 "Storage"，並將其與另一個函式 uniqueString 的結果串連。 uniqueString 函式會根據參數建立具決定性的雜湊字串。 在這裡，您要使用另一個函式 resourceGroup 建立目前資源群組識別碼的雜湊。

下列是我們到目前為止所討論之內容的輸出：

若要符合命名慣例，您需要此字串全部小寫。 在這裡，您會將 toLower 函式新增為外部函式。

產生的字串看起來像這樣：

繼續