ARM 模板的数字函数

资源管理器提供以下函数，用于在 Azure 资源管理器模板（ARM 模板）中使用整数：

• 添加
• copyIndex
• div
• 漂浮
• int
• 最大
• min
• 模组
• mul
• 字幕

添加

add(operand1, operand2)

返回两个提供的整数的总和。

Bicep 不支持 add 函数。 请改用 + 运算符 。

参数

返回值

一个包含参数总和的整数。

示例：

以下示例添加两个参数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 5,
      "metadata": {
        "description": "First integer to add"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Second integer to add"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "addResult": {
      "type": "int",
      "value": "[add(parameters('first'), parameters('second'))]"
    }
  }
}

上述示例中使用默认值的输出为：

copyIndex

copyIndex(loopName, offset)

返回迭代循环的索引。

在 Bicep 中，使用 迭代循环。

参数

注解

此函数始终与 复制 对象一起使用。 如果未为 偏移量提供任何值，则返回当前迭代值。 迭代值从零开始。

通过 loopName 属性，可以指定 copyIndex 是引用资源迭代还是属性迭代。 如果未为 loopName 提供任何值，则使用当前资源类型迭代。 在对属性进行循环访问时为 loopName 提供值。

有关使用复制的详细信息，请参阅：

• ARM 模板中的资源迭代
• ARM 模板中的属性迭代
• ARM 模板中的变量迭代
• ARM 模板中的输出迭代

示例：

以下示例演示名称中包含的复制循环和索引值。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageCount": {
      "type": "int",
      "defaultValue": 2
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[concat(copyIndex(),'storage', uniqueString(resourceGroup().id))]",
      "location": "[resourceGroup().location]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {},
      "copy": {
        "name": "storagecopy",
        "count": "[parameters('storageCount')]"
      }
    }
  ],
  "outputs": {}
}

返回值

一个整数，表示迭代的当前索引。

div

div(operand1, operand2)

返回两个提供的整数的整数除法。

Bicep 不支持 div 函数。 请改用 / 运算符 。

参数

返回值

一个表示除法的整数。

示例：

以下示例将一个参数除以另一个参数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 8,
      "metadata": {
        "description": "Integer being divided"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer used to divide"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "divResult": {
      "type": "int",
      "value": "[div(parameters('first'), parameters('second'))]"
    }
  }
}

上述示例中使用默认值的输出为：

漂浮

float(arg1)

将值转换为浮点数。 仅当将自定义参数传递给应用程序（例如逻辑应用）时，才使用此函数。

Bicep 不支持 float 函数。

参数

返回值

浮点数。

示例：

以下示例演示如何使用 float 将参数传递给逻辑应用：

{
  "type": "Microsoft.Logic/workflows",
  "properties": {
    ...
    "parameters": {
      "custom1": {
        "value": "[float('3.0')]"
      },
      "custom2": {
        "value": "[float(3)]"
      },

整数 (int)

int(valueToConvert)

将指定的值转换为整数。

在 Bicep 中，使用 int 函数。

参数

返回值

已转换值的整数。

示例：

以下示例模板将用户提供的参数值转换为整数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToConvert": {
      "type": "string",
      "defaultValue": "4"
    }
  },
  "resources": [
  ],
  "outputs": {
    "intResult": {
      "type": "int",
      "value": "[int(parameters('stringToConvert'))]"
    }
  }
}

上述示例中使用默认值的输出为：

最大值

max(arg1)

返回整数数组或逗号分隔的整数列表中的最大值。

在 Bicep 中，使用 max 函数。

参数

返回值

一个整数，表示集合中的最大值。

示例：

以下示例演示如何对整数数组和整数列表使用 max。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ 0, 3, 2, 5, 4 ]
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "int",
      "value": "[max(parameters('arrayToTest'))]"
    },
    "intOutput": {
      "type": "int",
      "value": "[max(0,3,2,5,4)]"
    }
  }
}

上述示例中使用默认值的输出为：

分钟

min(arg1)

返回整数数组或逗号分隔的整数列表中的最小值。

在 Bicep 中，使用 min 函数。

参数

返回值

一个整数，表示集合中的最小值。

示例：

以下示例演示如何对整数数组和整数列表使用 min。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ 0, 3, 2, 5, 4 ]
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "int",
      "value": "[min(parameters('arrayToTest'))]"
    },
    "intOutput": {
      "type": "int",
      "value": "[min(0,3,2,5,4)]"
    }
  }
}

上述示例中使用默认值的输出为：

国防部

mod(operand1, operand2)

使用提供的两个整数返回整数除法的余数。

Bicep 不支持 mod 函数。 请改用 % 运算符 。

参数

返回值

一个表示余数的整数。

示例：

以下示例返回将一个参数除以另一个参数的余数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 7,
      "metadata": {
        "description": "Integer being divided"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer used to divide"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "modResult": {
      "type": "int",
      "value": "[mod(parameters('first'), parameters('second'))]"
    }
  }
}

上述示例中使用默认值的输出为：

mul

mul(operand1, operand2)

返回两个提供的整数的乘法。

Bicep 不支持 mul 函数。 请改用 * 运算符 。

参数

返回值

一个表示乘法的整数。

示例：

以下示例将一个参数乘以另一个参数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 5,
      "metadata": {
        "description": "First integer to multiply"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Second integer to multiply"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "mulResult": {
      "type": "int",
      "value": "[mul(parameters('first'), parameters('second'))]"
    }
  }
}

上述示例中使用默认值的输出为：

子项

sub(operand1, operand2)

返回两个提供的整数的减法。

Bicep 不支持 sub 函数。 请改用 - 运算符 。

参数

返回值

一个表示减法的整数。

示例：

以下示例从另一个参数中减去一个参数。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "first": {
      "type": "int",
      "defaultValue": 7,
      "metadata": {
        "description": "Integer subtracted from"
      }
    },
    "second": {
      "type": "int",
      "defaultValue": 3,
      "metadata": {
        "description": "Integer to subtract"
      }
    }
  },
  "resources": [
  ],
  "outputs": {
    "subResult": {
      "type": "int",
      "value": "[sub(parameters('first'), parameters('second'))]"
    }
  }
}

上述示例中使用默认值的输出为：

后续步骤

• 有关 ARM 模板中各部分的说明，请参阅了解 ARM 模板的结构和语法。
• 若要在创建资源类型时迭代指定的次数，请参阅 ARM 模板中的资源迭代。