ARM 템플릿의 숫자 함수

아티클
03/20/2024

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

add
copyIndex
div
float
int
max
min
mod
mul
sub

팁

ARM 템플릿과 동일한 기능을 제공하고 구문이 사용하기 더 쉽기 때문에 Bicep를 권장합니다. Bicep에서 int, min 및 max 사용에 대해 자세히 알아보려면 숫자 함수를 참조하세요. 다른 숫자 값은 숫자 연산자를 참조하세요.

추가

add(operand1, operand2)

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

add 함수는 Bicep에서 지원되지 않습니다. 대신 + 연산자를 사용하세요.

매개 변수

매개 변수	필수	Type	설명
operand1	예	int	더할 첫 번째 숫자입니다.
operand2	예	int	더할 두 번째 숫자입니다.

반환 값

매개 변수의 합계를 포함하는 정수입니다.

예시

다음 예제에서는 두 개의 매개 변수를 추가합니다.

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

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
addResult	정수	8

copyIndex

copyIndex(loopName, offset)

반복 루프의 인덱스를 반환합니다.

Bicep에서 반복 루프를 사용합니다.

매개 변수

매개 변수	필수	Type	설명
loopName	아니요	string	반복을 가져오기 위한 루프의 이름입니다.
offset	아니요	int	0부터 시작하는 반복 값에 더할 숫자입니다.

설명

이 함수는 항상 copy 개체에 사용됩니다. offset 값을 제공하지 않으면 현재 반복 값이 반환됩니다. 반복 값은 0부터 시작합니다.

loopName 속성을 사용하면 copyIndex에서 리소스 반복 또는 속성 반복을 참조하는지 여부를 지정할 수 있습니다. loopName에 값을 제공하지 않으면 현재 리소스 종류 반복이 사용됩니다. 속성에서 반복하는 경우 loopName의 값을 제공합니다.

복사본을 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.

예시

다음 예제에서는 복사 루프 및 이름에 포함되는 인덱스 값을 보여 줍니다.

{
  "$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에서 지원되지 않습니다. 대신 / 연산자를 사용하세요.

매개 변수

매개 변수	필수	Type	설명
operand1	예	int	나누어지는 수입니다.
operand2	예	int	나누는 데 사용되는 정수입니다. 0일 수 없습니다.

반환 값

나누기를 나타내는 정수입니다.

예시

다음 예제에서는 다른 매개 변수로 매개 변수 하나를 나눕니다.

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

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
divResult	정수	2

float

float(arg1)

값을 부동 소수점 숫자로 변환합니다. 논리 앱과 같은 애플리케이션에 사용자 지정 매개 변수를 전달할 때만 이 함수를 사용합니다.

float 함수는 Bicep에서 지원되지 않습니다.

매개 변수

매개 변수	필수	Type	설명
arg1	예	문자열 또는 int	부동 소수점 숫자로 변환할 값입니다.

반환 값

부동 소수점 수입니다.

예시

다음 예제에서는 float를 사용해서 매개 변수를 논리 앱에 전달하는 방법을 보여 줍니다.

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

int

int(valueToConvert)

지정된 값을 정수로 변환합니다.

Bicep에서 int 함수를 사용합니다.

매개 변수

매개 변수	필수	Type	설명
valueToConvert	예	문자열 또는 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'))]"
    }
  }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
intResult	정수	4

최대

max(arg1)

정수 배열 또는 쉼표로 구분된 정수 목록 중에서 최대값을 반환합니다.

Bicep에서 max 함수를 사용합니다.

매개 변수

매개 변수	필수	Type	설명
arg1	예	정수 배열 또는 쉼표로 구분된 정수 목록	최대값을 가져올 컬렉션입니다.

반환 값

컬렉션의 최대값을 나타내는 정수입니다.

예시

다음 예제에서는 정수 배열 및 목록에 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)]"
    }
  }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
arrayOutput	정수	5
intOutput	정수	5

최소

min(arg1)

정수 배열 또는 쉼표로 구분된 정수 목록 중에서 최소값을 반환합니다.

Bicep에서 min 함수를 사용합니다.

매개 변수

매개 변수	필수	Type	설명
arg1	예	정수 배열 또는 쉼표로 구분된 정수 목록	최소값을 가져올 컬렉션입니다.

반환 값

컬렉션의 최소값을 나타내는 정수입니다.

예시

다음 예제에서는 정수 배열 및 목록에 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)]"
    }
  }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
arrayOutput	정수	0
intOutput	정수	0

mod

mod(operand1, operand2)

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

mod 함수는 Bicep에서 지원되지 않습니다. 대신 % 연산자를 사용하세요.

매개 변수

매개 변수	필수	Type	설명
operand1	예	int	나누어지는 수입니다.
operand2	예	int	나누는 데 사용되는 정수로, 0일 수 없습니다.

반환 값

나머지를 나타내는 정수입니다.

예시

다음 예제에서는 다른 매개 변수로 매개 변수 하나를 나눈 나머지를 반환합니다.

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

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
modResult	정수	1

mul

mul(operand1, operand2)

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

mul 함수는 Bicep에서 지원되지 않습니다. 대신 * 연산자를 사용하세요.

매개 변수

매개 변수	필수	Type	설명
operand1	예	int	곱할 첫 번째 숫자입니다.
operand2	예	int	곱할 두 번째 숫자입니다.

반환 값

곱하기를 나타내는 정수입니다.

예시

다음 예제에서는 다른 매개 변수로 매개 변수 하나를 곱합니다.

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

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
mulResult	정수	45

하위

sub(operand1, operand2)

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

sub 함수는 Bicep에서 지원되지 않습니다. 대신 - 연산자를 사용합니다.

매개 변수

매개 변수	필수	Type	설명
operand1	예	int	빼는 피감수입니다.
operand2	예	int	빼는 감수입니다.

반환 값

빼기를 나타내는 정수입니다.

예시

다음 예제에서는 다른 매개 변수에서 매개 변수 하나를 뺍니다.

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

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.

이름	타입	값
subResult	정수	4

다음 단계

ARM 템플릿의 섹션에 대한 설명은 ARM 템플릿의 구조 및 구문 이해를 참조하십시오.
리소스 형식을 만들 때 지정된 횟수만큼 반복하려면 ARM 템플릿의 리소스 반복을 참조하세요.

ARM 템플릿의 숫자 함수

추가

매개 변수

반환 값

예시

copyIndex

매개 변수

설명

예시

반환 값

div

매개 변수

반환 값

예시

float

매개 변수

반환 값

예시

int

매개 변수

반환 값

예시

최대

매개 변수

반환 값

예시

최소

매개 변수

반환 값

예시

mod

매개 변수

반환 값

예시

mul

매개 변수

반환 값

예시

하위

매개 변수

반환 값

예시

다음 단계

추가 리소스