Numeriska funktioner för ARM-mallar

Resource Manager tillhandahåller följande funktioner för att arbeta med heltal i din Azure Resource Manager-mall (ARM-mall):

• lägga till
• copyIndex
• div
• sväva
• int
• max
• min
• mod
• mul
• under

lägg till

add(operand1, operand2)

Returnerar summan av de två angivna heltalen.

Funktionen add stöds inte i Bicep. Använd operatorn+ i stället.

Parameterar

Returvärde

Ett heltal som innehåller summan av parametrarna.

Exempel

I följande exempel läggs två parametrar till:

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

Utdata från standardvärdena från föregående exempel är:

copyIndex

copyIndex(loopName, offset)

Returnerar indexet för en iterationsloop.

I Bicep använder du iterativa loopar.

Parameterar

Anmärkningar

Den här funktionen används alltid med ett kopieringsobjekt . Om inget värde anges för offset returneras det aktuella iterationsvärdet. Iterationsvärdet börjar på noll.

Med egenskapen loopName kan du ange om copyIndex refererar till en resurs iteration eller egenskaps-iteration. Om inget värde anges för loopName används den aktuella iterationen av resurstyp. Ange ett värde för loopName när du itererar på en egenskap.

Mer information om hur du använder kopiera finns i:

• Resursiterering i ARM-mallar
• Egenskaps iteration i ARM-mallar
• Variabel iteration i ARM-mallar
• Utdataiteration i ARM-mallar

Exempel

I följande exempel visas en kopieringsloop och indexvärdet som ingår i namnet:

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

Returvärde

Ett heltal som representerar iterationens aktuella index.

div

div(operand1, operand2)

Returnerar heltalsdivisionen för de två angivna heltalen.

Funktionen div stöds inte i Bicep. Använd operatorn/ i stället.

Parameterar

Returvärde

Ett heltal som representerar divisionen.

Exempel

I följande exempel delas en parameter med en annan:

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

Utdata från standardvärdena från föregående exempel är:

flyta/sväva

float(arg1)

Konverterar värdet till ett flyttalsnummer. Du använder bara den här funktionen när du skickar anpassade parametrar till ett program, till exempel en logikapp.

Funktionen float stöds inte i Bicep.

Parameterar

Returvärde

Ett flyttalsnummer.

Exempel

I följande exempel visas hur du använder flyttal för att skicka parametrar till en logikapp:

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

Int

int(valueToConvert)

Konverterar det angivna värdet till ett heltal.

Använd funktionen i int Bicep.

Parameterar

Returvärde

Ett heltal för det konverterade värdet.

Exempel

Följande exempelmall konverterar parametervärdet från användaren till ett heltal:

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

Utdata från standardvärdena från föregående exempel är:

maximalt

max(arg1)

Returnerar det maximala värdet från en matris med heltal eller en kommaavgränsad lista med heltal.

Använd funktionen i max Bicep.

Parameterar

Returvärde

Ett heltal som representerar det maximala värdet från samlingen.

Exempel

I följande exempel visas hur du använder max med en matris och en lista med heltal:

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

Utdata från standardvärdena från föregående exempel är:

minut

min(arg1)

Returnerar det minsta värdet från en matris med heltal eller en kommaavgränsad lista med heltal.

Använd funktionen i min Bicep.

Parameterar

Returvärde

Ett heltal som representerar minimivärdet från samlingen.

Exempel

I följande exempel visas hur du använder min med en matris och en lista med heltal:

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

Utdata från standardvärdena från föregående exempel är:

modifikation

mod(operand1, operand2)

Returnerar kvoten för heltalsdivisionen med hjälp av de två angivna heltalen.

Funktionen mod stöds inte i Bicep. Använd operatorn% i stället.

Parameterar

Returvärde

Ett heltal som representerar resten.

Exempel

I följande exempel returneras kvoten för att dela upp en parameter med en annan:

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

Utdata från standardvärdena från föregående exempel är:

mul

mul(operand1, operand2)

Returnerar multiplikationen för de två angivna heltalen.

Funktionen mul stöds inte i Bicep. Använd operatorn * i stället.

Parameterar

Returvärde

Ett heltal som representerar multiplikationen.

Exempel

I följande exempel multipliceras en parameter med en annan:

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

Utdata från standardvärdena från föregående exempel är:

Underkategori

sub(operand1, operand2)

Returnerar subtraktionen för de två angivna heltalen.

Funktionen sub stöds inte i Bicep. Använd operatorn - i stället.

Parameterar

Returvärde

Ett heltal som representerar subtraktionen.

Exempel

I följande exempel subtraheras en parameter från en annan:

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

Utdata från standardvärdena från föregående exempel är:

Nästa steg

• En beskrivning av avsnitten i en ARM-mall finns i Förstå strukturen och syntaxen för ARM-mallar.
• Information om hur du itererar ett angivet antal gånger när du skapar en typ av resurs finns i Resursiteration i ARM-mallar.