ARM 템플릿의 숫자 함수

Resource Manager는 ARM 템플릿(Azure Resource Manager 템플릿)에서 숫자 작업을 수행하는 데 사용할 수 있도록 아래의 함수를 제공합니다.

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

추가

add(operand1, operand2)

제공된 두 개 정수의 합계를 반환합니다.

add 함수는 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 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부터 시작합니다.

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": "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)

제공된 두 정수의 나누기를 반환합니다.

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에서 지원되지 않습니다.

매개 변수

반환 값

부동 소수점 수입니다.

예시

다음 예제에서는 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

mod(operand1, operand2)

제공된 두 정수를 사용하여 나누기한 나머지를 반환합니다.

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)

제공된 두 정수의 곱하기를 반환합니다.

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(operand1, operand2)

제공된 두 정수의 빼기를 반환합니다.

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 템플릿의 리소스 반복을 참조하세요.