Numerikus függvények ARM-sablonokhoz

  • Cikk

Resource Manager az azure Resource Manager-sablonban (ARM-sablonban) lévő egész számokhoz a következő függvényeket biztosítja:

Tipp

A Bicep használatát javasoljuk, mert ugyanazokat a képességeket kínálja, mint az ARM-sablonok, és a szintaxis használata is egyszerűbb. A , minés max a Bicep használatával intkapcsolatos további információkért lásd a numerikus függvényeket. Más 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 Description
operandus1 Yes int Első hozzáadandó szám.
operandus2 Yes int Második hozzáadandó szám.

Visszatérési é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élda kimenete az alapértelmezett értékekkel:

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

copyIndex

copyIndex(loopName, offset)

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

A Bicepben iteratív hurkokat használjon.

Paraméterek

Paraméter Kötelező Típus Description
loopName No sztring Az iteráció lekéréséhez használt hurok neve.
offset No int A nulla alapú iterációs értékhez hozzáadandó szám.

Megjegyzések

Ezt a függvényt mindig másolási objektummal használják. Ha nincs megadva érték az eltoláshoz, a függvény 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 értékhez egy tulajdonság iterálásakor.

További információ a másolás használatáról:

Példa

Az alábbi példa egy másolási hurkot é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')]"
      }
    }
  ]
}

Visszatérési é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 egész osztását adja eredményül.

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 Description
operandus1 Yes int Az osztandó szám.
operandus2 Yes int Az osztáshoz használt szám. Nem lehet 0.

Visszatérési érték

Az osztást jelölő egész szám.

Példa

Az alábbi példa az egyik paramétert egy másik paraméterre osztja.

{
  "$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 Description
arg1 Yes sztring vagy int A lebegőpontos számmá konvertálandó érték.

Visszatérési érték

Egy lebegőpontos szám.

Példa

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

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

int

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 Description
valueToConvert Yes sztring vagy int Az egész számmá konvertálandó érték.

Visszatérési érték

Az átalakított é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 eredményül.

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

Paraméterek

Paraméter Kötelező Típus Description
arg1 Yes 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.

Visszatérési érték

Egy egész szám, amely a gyűjtemény maximális értékét jelöli.

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 eredményül.

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

Paraméterek

Paraméter Kötelező Típus Description
arg1 Yes 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.

Visszatérési érték

A gyűjtemény minimális értékét képviselő 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 helyette a % operátort .

Paraméterek

Paraméter Kötelező Típus Description
operandus1 Yes int Az osztandó szám.
operandus2 Yes int Az osztáshoz használt szám nem lehet 0.

Visszatérési érték

A maradékot 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 maradéká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élda kimenete az alapértelmezett értékekkel:

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

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 Description
operandus1 Yes int Első szorzandó szám.
operandus2 Yes int Második szorzandó szám.

Visszatérési érték

A szorzást jelölő 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élda kimenete az alapértelmezett értékekkel:

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 helyette a - operátort .

Paraméterek

Paraméter Kötelező Típus Description
operandus1 Yes int Az a szám, amelyből kivonva van.
operandus2 Yes int A kivont szám.

Visszatérési érték

A kivonást jelölő 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élda kimenete az alapértelmezett értékekkel:

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

Következő lépések