Megosztás a következőn keresztül:

Numerikus függvények ARM-sablonokhoz

  • Cikk

A Resource Manager az alábbi függvényeket biztosítja az Azure Resource Manager-sablonban (ARM-sablonban) lévő egész számok kezeléséhez:

Tipp.

A Bicep használatát javasoljuk, mert ugyanazokkal a képességekkel rendelkezik, mint az ARM-sablonok, és a szintaxis használata egyszerűbb. A , és minmax a Bicep használatával intkapcsolatos további információkért tekintse meg a numerikus függvényeket. Egyéb numerikus értékekért lásd a numerikus operátorokat.

add

add(operand1, operand2)

A két megadott egész szám összegét adja vissza.

A add Bicep nem támogatja a függvényt. Használja inkább az + operátort .

Paraméterek

Paraméter Kötelező Típus Leírás
operand1 Igen egész Első hozzáadandó szám.
operand2 Igen egész Második hozzáadandó szám.

Visszaadott érték

A paraméterek összegét tartalmazó egész szám.

Példa

Az alábbi példa két paramétert ad hozzá.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
addResult Int 8

copyIndex

copyIndex(loopName, offset)

Egy iterációs ciklus indexét adja vissza.

A Bicepben iteratív hurkokat használjon.

Paraméterek

Paraméter Kötelező Típus Leírás
loopName Nem húr Az iteráció lekéréséhez használt hurok neve.
Eltolás Nem egész A nulla alapú iterációs értékhez hozzáadni kívánt szám.

Megjegyzések

Ezt a függvényt mindig másolási objektummal használja a rendszer. Ha nincs megadva érték az eltoláshoz, a rendszer az aktuális iterációs értéket adja vissza. Az iterációs érték nullával kezdődik.

A loopName tulajdonsággal megadhatja, hogy a copyIndex erőforrás-iterációra vagy tulajdonság-iterációra hivatkozik-e. Ha nincs megadva érték a loopName értékhez, a rendszer az aktuális erőforrástípus-iterációt használja. Adjon meg egy értéket a loopName tulajdonságon való iteráláskor.

A másolással kapcsolatos további információkért lásd:

Példa

Az alábbi példa egy másolási ciklust és a névben szereplő indexértéket mutatja be.

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

Visszaadott érték

Az iteráció aktuális indexét jelölő egész szám.

div

div(operand1, operand2)

A két megadott egész szám egész számának osztását adja vissza.

A div Bicep nem támogatja a függvényt. Használja inkább az / operátort .

Paraméterek

Paraméter Kötelező Típus Leírás
operand1 Igen egész Az elosztott szám.
operand2 Igen egész Az osztáshoz használt szám. Nem lehet 0.

Visszaadott érték

Az osztást jelképező egész szám.

Példa

Az alábbi példa egy paramétert egy másik paraméterre oszt.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
divResult Int 2

float

float(arg1)

Az értéket lebegőpontos számmá alakítja. Ezt a függvényt csak akkor használja, ha egyéni paramétereket ad át egy alkalmazásnak, például egy logikai alkalmazásnak.

A float Bicep nem támogatja a függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
arg1 Igen sztring vagy int A lebegőpontos számmá konvertálandó érték.

Visszaadott érték

Lebegőpontos szám.

Példa

Az alábbi példa bemutatja, hogyan adhat át paramétereket egy logikai alkalmazásnak lebegőpontos objektum használatával:

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

egész

int(valueToConvert)

A megadott értéket egész számmá alakítja.

A Bicepben használja az int függvényt .

Paraméterek

Paraméter Kötelező Típus Leírás
valueToConvert Igen sztring vagy int Az egész számmá konvertálandó érték.

Visszaadott érték

A konvertált érték egész száma.

Példa

Az alábbi példasablon a felhasználó által megadott paraméterértéket egész számmá alakítja.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
intResult Int 4

max.

max(arg1)

Az egész számok tömbjének vagy az egész számok vesszővel tagolt listájának maximális értékét adja vissza.

A Bicepben használja a maximális függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
arg1 Igen egész számok tömbje vagy egész számok vesszővel tagolt listája A gyűjtemény a maximális érték lekéréséhez.

Visszaadott érték

A gyűjtemény maximális értékét jelölő egész szám.

Példa

Az alábbi példa bemutatja, hogyan használható a max tömb és az egész számok listája.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
arrayOutput Int 5
intOutput Int 5

p

min(arg1)

Az egész számok tömbjének vagy az egész számok vesszővel tagolt listájának minimális értékét adja vissza.

A Bicepben használja a min függvényt.

Paraméterek

Paraméter Kötelező Típus Leírás
arg1 Igen egész számok tömbje vagy egész számok vesszővel tagolt listája A gyűjtemény a minimális érték lekéréséhez.

Visszaadott érték

A gyűjtemény minimális értékét jelölő egész szám.

Példa

Az alábbi példa bemutatja, hogyan használható a min tömb és az egész számok listája.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
arrayOutput Int 0
intOutput Int 0

Mod

mod(operand1, operand2)

Az egész szám osztás fennmaradó részét adja vissza a két megadott egész szám használatával.

A mod Bicep nem támogatja a függvényt. Használja inkább a %operátort .

Paraméterek

Paraméter Kötelező Típus Leírás
operand1 Igen egész Az elosztott szám.
operand2 Igen egész Az osztáshoz használt szám nem lehet 0.

Visszaadott érték

A többit jelölő egész szám.

Példa

Az alábbi példa az egyik paraméter egy másik paraméterre való felosztásának fennmaradó részét adja vissza.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
modResult Int 0

Mul

mul(operand1, operand2)

A két megadott egész szám szorzását adja vissza.

A mul Bicep nem támogatja a függvényt. Használja helyette a * operátort .

Paraméterek

Paraméter Kötelező Típus Leírás
operand1 Igen egész Az első szorzandó szám.
operand2 Igen egész Második szorzandó szám.

Visszaadott érték

A szorzást jelképező egész szám.

Példa

Az alábbi példa megszorozza az egyik paramétert egy másik paramétersel.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
mulResult Int 45

Al

sub(operand1, operand2)

A két megadott egész szám kivonását adja vissza.

A sub Bicep nem támogatja a függvényt. Használja inkább a - operátort .

Paraméterek

Paraméter Kötelező Típus Leírás
operand1 Igen egész A kivont szám.
operand2 Igen egész A kivont szám.

Visszaadott érték

A kivonást jelképező egész szám.

Példa

Az alábbi példa kivon egy paramétert egy másik paraméterből.

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

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név Típus Érték
subResult Int 4

Következő lépések