Funciones numéricas para plantillas de ARM

Resource Manager proporciona las siguientes funciones para trabajar con enteros en la plantilla de Azure Resource Manager (plantilla de ARM):

• agregar
• copyIndex
• div
• float
• int
• máximo
• min
• modificación
• mul
• sustituto

añadir

add(operand1, operand2)

Devuelve la suma de los dos enteros proporcionados.

La función add no es compatible con Bicep. Use el + operador en su lugar.

Parámetros

Valor devuelto

Entero que contiene la suma de los parámetros.

Ejemplo

En el ejemplo siguiente se agregan dos parámetros:

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

La salida de los valores predeterminados del ejemplo anterior es:

copyIndex

copyIndex(loopName, offset)

Devuelve el índice de un bucle de iteración.

En Bicep, use bucles iterativos.

Parámetros

Observaciones

Esta función siempre se usa con un objeto copy . Si no se proporciona ningún valor para el desplazamiento, se devuelve el valor de iteración actual. El valor de iteración comienza en cero.

La propiedad loopName permite especificar si copyIndex hace referencia a una iteración de recursos o a una iteración de propiedad. Si no se proporciona ningún valor para loopName, se usa la iteración del tipo de recurso actual. Proporcione un valor para loopName al iterar en una propiedad.

Para obtener más información sobre el uso de la copia, consulte:

• Iteración de recursos en plantillas de ARM
• Iteración de propiedades en plantillas de ARM
• Iteración de variables en plantillas de ARM
• Iteración de salida en plantillas de ARM

Ejemplo

En el ejemplo siguiente se muestra un bucle de copia y el valor de índice incluido en el nombre:

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

Valor devuelto

Entero que representa el índice actual de la iteración.

div

div(operand1, operand2)

Devuelve la división de enteros de los dos enteros proporcionados.

La función div no es compatible con Bicep. Use el / operador en su lugar.

Parámetros

Valor devuelto

Entero que representa la división.

Ejemplo

En el ejemplo siguiente se divide un parámetro por otro:

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

La salida de los valores predeterminados del ejemplo anterior es:

flotante

float(arg1)

Convierte el valor en un número de punto flotante. Esta función solo se usa al pasar parámetros personalizados a una aplicación, como una aplicación lógica.

La función float no es compatible con Bicep.

Parámetros

Valor devuelto

Número de punto flotante.

Ejemplo

En el ejemplo siguiente se muestra cómo usar float para pasar parámetros a una aplicación lógica:

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

Int

int(valueToConvert)

Convierte el valor especificado en un entero.

En Bicep, use la int función .

Parámetros

Valor devuelto

Entero del valor convertido.

Ejemplo

La plantilla de ejemplo siguiente convierte el valor del parámetro proporcionado por el usuario en un entero:

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

La salida de los valores predeterminados del ejemplo anterior es:

máximo

max(arg1)

Devuelve el valor máximo de una matriz de enteros o una lista separada por comas de enteros.

En Bicep, use la max función .

Parámetros

Valor devuelto

Entero que representa el valor máximo de la colección.

Ejemplo

En el ejemplo siguiente se muestra cómo usar max con una matriz y una lista de enteros:

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

La salida de los valores predeterminados del ejemplo anterior es:

Min

min(arg1)

Devuelve el valor mínimo de una matriz de enteros o una lista separada por comas de enteros.

En Bicep, use la min función .

Parámetros

Valor devuelto

Entero que representa el valor mínimo de la colección.

Ejemplo

En el ejemplo siguiente se muestra cómo usar min con una matriz y una lista de enteros:

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

La salida de los valores predeterminados del ejemplo anterior es:

Módulo

mod(operand1, operand2)

Devuelve el cociente de la división de enteros utilizando los dos enteros proporcionados.

La función mod no es compatible con Bicep. Use el operador% en su lugar.

Parámetros

Valor devuelto

Entero que representa el resto.

Ejemplo

En el ejemplo siguiente se devuelve el cociente de dividir un parámetro por otro:

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

La salida de los valores predeterminados del ejemplo anterior es:

mul

mul(operand1, operand2)

Devuelve la multiplicación de los dos enteros proporcionados.

La función mul no es compatible con Bicep. Use el operador * en su lugar.

Parámetros

Valor devuelto

Entero que representa la multiplicación.

Ejemplo

En el ejemplo siguiente se multiplica un parámetro por otro:

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

La salida de los valores predeterminados del ejemplo anterior es:

submarino

sub(operand1, operand2)

Devuelve la resta de los dos enteros proporcionados.

La función sub no es compatible con Bicep. Use el operador - en su lugar.

Parámetros

Valor devuelto

Entero que representa la resta.

Ejemplo

En el ejemplo siguiente se resta un parámetro de otro:

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

La salida de los valores predeterminados del ejemplo anterior es:

Pasos siguientes

• Para obtener una descripción de las secciones de una plantilla de ARM, vea Nociones sobre la estructura y la sintaxis de las plantillas de Azure Resource Manager.
• Para iterar un número especificado de veces al crear un tipo de recurso, consulte Iteración de recursos en las plantillas de Resource Manager.