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

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

• add
• copyIndex
• div
• float
• int
• max
• min
• mod
• mul
• sub

add

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

パラメーター

注釈

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

copyIndex がリソースの反復処理を指すのかプロパティの反復処理を指すのかは、loopName プロパティで指定できます。 loopName に値を指定しなかった場合は、現在のリソース タイプの反復処理が使われます。 プロパティに対する反復では、loopName に値を指定してください。

copy の使い方の詳細については、次を参照してください。

• 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": "2022-09-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 ではサポートされていません。 代わりに、/ 演算子を使用してください。

パラメーター

戻り値

除算を表す整数。

例

次の例では、一方のパラメーターをもう一方のパラメーターで除算します。

{
  "$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 ではサポートされていません。

パラメーター

戻り値

浮動小数点数。

例

次の例では、ロジック アプリにパラメーターを渡すために浮動小数点数を使用する方法を示します。

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

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

min(arg1)

整数の配列または整数のコンマ区切りリストから最小値を返します。

Bicep では、json 関数を使用します。

パラメーター

戻り値

コレクションの最小値を表す整数。

例

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

mod(operand1, operand2)

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

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

パラメーター

戻り値

剰余を表す整数。

例

次の例では、一方のパラメーターをもう一方のパラメーターで除算した剰余を返します。

{
  "$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 ではサポートされていません。 代わりに、* 演算子を使用してください。

パラメーター

戻り値

乗算を表す整数。

例

次の例では、一方のパラメーターをもう一方のパラメーターで乗算します。

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

sub(operand1, operand2)

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

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

パラメーター

戻り値

減算を表す整数。

例

次の例では、一方のパラメーターからもう一方のパラメーターを減算します。

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