ARM テンプレートの数値関数

Resource Manager には、Azure Resource Manager テンプレート (ARM テンプレート) で整数を操作するための次の関数が用意されています。

• 追加する
• copyIndex
• div
• float
• int
• 最大
• min
• モッド
• mul
• サブ

追加する

add(operand1, operand2)

指定された 2 つの整数の合計を返します。

add 関数は、Bicep ではサポートされていません。 代わりに + 演算子 を使用してください。

パラメーター

戻り値

パラメーターの合計を含む整数。

例

次の例では、2 つのパラメーターを追加します。

{
  "$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 では、 反復ループを使用します。

パラメーター

注釈

この関数は、常に コピー オブジェクトと共に使用されます。 オフセットに値が指定されていない場合は、現在の反復値が返されます。 反復値は 0 から始まります。

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
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[format('{0}storage{1}', range(0, parameters('storageCount'))[copyIndex()], uniqueString(resourceGroup().id))]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {},
      "copy": {
        "name": "storagecopy",
        "count": "[parameters('storageCount')]"
      }
    }
  ]
}

戻り値

イテレーションの現在のインデックスを表す整数。

div

div(operand1, operand2)

指定された 2 つの整数の整数除算を返します。

div 関数は、Bicep ではサポートされていません。 代わりに / 演算子 を使用してください。

パラメーター

戻り値

除算を表す整数。

例

次の例では、1 つのパラメーターを別のパラメーターで除算します。

{
  "$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

float(arg1)

値を浮動小数点数に変換します。 この関数は、ロジック アプリなどのアプリケーションにカスタム パラメーターを渡す場合にのみ使用します。

float 関数は、Bicep ではサポートされていません。

パラメーター

戻り値

浮動小数点数。

例

次の例は、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)

指定された 2 つの整数を使用して、整数除算の商を返します。

mod 関数は、Bicep ではサポートされていません。 代わりに % 演算子 を使用してください。

パラメーター

戻り値

剰余を表す整数。

例

次の例では、1 つのパラメーターを別のパラメーターで除算する商を返します。

{
  "$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)

指定された 2 つの整数の乗算を返します。

mul 関数は、Bicep ではサポートされていません。 代わりに * 演算子 を使用してください。

パラメーター

戻り値

乗算を表す整数。

例

次の例では、1 つのパラメーターに別のパラメーターを乗算します。

{
  "$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(mul(parameters('first'), parameters('second')), 3)]"
    }
  }
}

前の例の既定値の出力は次のとおりです。

サブ

sub(operand1, operand2)

指定された 2 つの整数の減算を返します。

sub 関数は、Bicep ではサポートされていません。 代わりに - 演算子 を使用してください。

パラメーター

戻り値

減算を表す整数。

例

次の例では、別のパラメーターから 1 つのパラメーターを減算します。

{
  "$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 テンプレートでのリソースの反復処理」を参照してください。