Funzioni numeriche per i modelli di Azure Resource ManagerNumeric functions for Azure Resource Manager templates

Gestione risorse fornisce le funzioni seguenti per usare i numeri interi:Resource Manager provides the following functions for working with integers:

addadd

add(operand1, operand2)

Restituisce la somma dei due numeri interi forniti.Returns the sum of the two provided integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
operand1operand1 Yes intint Il primo numero da aggiungere.First number to add.
operand2operand2 Yes intint Il secondo numero da aggiungere.Second number to add.

Valore restituitoReturn value

Un intero che contiene la somma dei parametri.An integer that contains the sum of the parameters.

EsempioExample

Il modello di esempio seguente aggiunge due parametri.The following example template adds two parameters.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
addResultaddResult intInt 88

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/add.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/add.json 

copyIndexcopyIndex

copyIndex(loopName, offset)

Restituisce l'indice di un ciclo di iterazione.Returns the index of an iteration loop.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
loopNameloopName NoNo stringstring Nome del ciclo per ottenere l'iterazione.The name of the loop for getting the iteration.
offsetoffset NoNo intint Il numero da aggiungere al valore di iterazione in base zero.The number to add to the zero-based iteration value.

OsservazioniRemarks

Questa funzione viene sempre usata con un oggetto copy .This function is always used with a copy object. Se non viene specificato alcun valore per offset, viene restituito il valore di iterazione corrente.If no value is provided for offset, the current iteration value is returned. Il valore di iterazione inizia da zero.The iteration value starts at zero. È possibile usare i cicli di iterazione quando si definiscono le risorse o le variabili.You can use iteration loops when defining either resources or variables.

La proprietà loopName consente di specificare se copyIndex fa riferimento all'iterazione di una risorsa o all'iterazione di una proprietà.The loopName property enables you to specify whether copyIndex is referring to a resource iteration or property iteration. Se non viene specificato alcun valore per loopName, viene usata l'iterazione del tipo di risorsa corrente.If no value is provided for loopName, the current resource type iteration is used. Specificare un valore per loopName durante l'iterazione di una proprietà.Provide a value for loopName when iterating on a property.

Per una descrizione completa dell'uso di copyIndex, vedere Creare più istanze di risorse in Azure Resource Manager.For a complete description of how you use copyIndex, see Create multiple instances of resources in Azure Resource Manager.

Per un esempio di utilizzo di copyIndex nella definizione di una variabile, vedere Variabili.For an example of using copyIndex when defining a variable, see Variables.

EsempioExample

L'esempio seguente illustra un ciclo di copy e il valore di indice incluso nel nome.The following example shows a copy loop and the index value included in the name.

"resources": [ 
  { 
    "name": "[concat('examplecopy-', copyIndex())]", 
    "type": "Microsoft.Web/sites", 
    "copy": { 
      "name": "websitescopy", 
      "count": "[parameters('count')]" 
    }, 
    ...
  }
]

Valore restituitoReturn value

Un intero che rappresenta l'indice corrente dell'iterazione.An integer representing the current index of the iteration.

divdiv

div(operand1, operand2)

Restituisce la divisione Integer dei due numeri interi forniti.Returns the integer division of the two provided integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
operand1operand1 Yes intint Il numero da dividere.The number being divided.
operand2operand2 Yes intint Il numero usato per dividere.The number that is used to divide. Non può essere 0.Cannot be 0.

Valore restituitoReturn value

Un intero che rappresenta la divisione.An integer representing the division.

EsempioExample

Il modello di esempio seguente mostra come dividere un parametro per un altro parametro.The following example template divides one parameter by another parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
divResultdivResult intInt 22

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/div.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/div.json 

floatfloat

float(arg1)

Converte il valore in un numero a virgola mobile.Converts the value to a floating point number. Usare questa funzione solo quando si passano parametri personalizzati a un'applicazione, ad esempio un'app per la logica.You only use this function when passing custom parameters to an application, such as a Logic App.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringa o intstring or int Il valore da convertire in un numero a virgola mobile.The value to convert to a floating point number.

Valore restituitoReturn value

Un numero a virgola mobile.A floating point number.

EsempioExample

L'esempio seguente illustra come usare float per passare parametri a un'app per la logica:The following example shows how to use float to pass parameters to a Logic App:

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

intint

int(valueToConvert)

Converte il valore specificato in un numero intero.Converts the specified value to an integer.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
valueToConvertvalueToConvert Yes stringa o intstring or int Il valore da convertire in numero intero.The value to convert to an integer.

Valore restituitoReturn value

Un intero del valore convertito.An integer of the converted value.

EsempioExample

Il modello di esempio seguente converte il valore del parametro fornito dall'utente in intero.The following example template converts the user-provided parameter value to integer.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringToConvert": { 
            "type": "string",
            "defaultValue": "4"
        }
    },
    "resources": [
    ],
    "outputs": {
        "intResult": {
            "type": "int",
            "value": "[int(parameters('stringToConvert'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
intResultintResult intInt 44

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/int.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/int.json

maxmax

max (arg1)

Restituisce il valore massimo da una matrice di numeri interi o da un elenco di numeri interi delimitato da virgole.Returns the maximum value from an array of integers or a comma-separated list of integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes matrice di numeri interi o elenco di numeri interi delimitato da virgolearray of integers, or comma-separated list of integers La raccolta per ottenere il valore massimo.The collection to get the maximum value.

Valore restituitoReturn value

Un intero che rappresenta il valore massimo dalla raccolta.An integer representing the maximum value from the collection.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione max con una matrice e un elenco di numeri interi:The following example template shows how to use max with an array and a list of integers:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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)]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
arrayOutputarrayOutput intInt 55
intOutputintOutput intInt 55

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/max.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/max.json

Minmin

min (arg1)

Restituisce il valore minimo di una matrice di numeri interi o di un elenco di numeri interi delimitato da virgole.Returns the minimum value from an array of integers or a comma-separated list of integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes matrice di numeri interi o elenco di numeri interi delimitato da virgolearray of integers, or comma-separated list of integers La raccolta per ottenere il valore minimo.The collection to get the minimum value.

Valore restituitoReturn value

un intero che rappresenta il valore minimo dalla raccolta.An integer representing minimum value from the collection.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione min con una matrice e un elenco di numeri interi:The following example template shows how to use min with an array and a list of integers:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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)]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
arrayOutputarrayOutput intInt 00
intOutputintOutput intInt 00

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/min.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/min.json

modmod

mod(operand1, operand2)

Restituisce la parte rimanente della divisione Integer usando i due numeri interi forniti.Returns the remainder of the integer division using the two provided integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
operand1operand1 Yes intint Il numero da dividere.The number being divided.
operand2operand2 Yes intint Il numero usato per dividere; non può corrispondere a 0.The number that is used to divide, Cannot be 0.

Valore restituitoReturn value

Un intero che rappresenta il resto.An integer representing the remainder.

EsempioExample

Il modello di esempio seguente restituisce il resto della divisione di un parametro per un altro parametro.The following example template returns the remainder of dividing one parameter by another parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
modResultmodResult intInt 11

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/mod.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/mod.json

mulmul

mul(operand1, operand2)

Restituisce la moltiplicazione dei due numeri interi forniti.Returns the multiplication of the two provided integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
operand1operand1 Yes intint Il primo numero da moltiplicare.First number to multiply.
operand2operand2 Yes intint Il secondo numero da moltiplicare.Second number to multiply.

Valore restituitoReturn value

Un intero che rappresenta la moltiplicazione.An integer representing the multiplication.

EsempioExample

Il modello di esempio seguente mostra come moltiplicare un parametro per un altro parametro.The following example template multiplies one parameter by another parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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(parameters('first'), parameters('second'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
mulResultmulResult intInt 1515

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/mul.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/mul.json

subsub

sub(operand1, operand2)

Restituisce la sottrazione dei due numeri interi forniti.Returns the subtraction of the two provided integers.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
operand1operand1 Yes intint Il numero da cui sottrarre.The number that is subtracted from.
operand2operand2 Yes intint Il numero sottratto.The number that is subtracted.

Valore restituitoReturn value

Un intero che rappresenta la sottrazione.An integer representing the subtraction.

EsempioExample

Il modello di esempio seguente mostra come sottrarre un parametro da un altro parametro.The following example template subtracts one parameter from another parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-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'))]"
        }
    }
}

L'output dell'esempio precedente con i valori predefiniti è il seguente:The output from the preceding example with the default values is:

NomeName TipoType ValoreValue
subResultsubResult intInt 44

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:To deploy this example template with Azure CLI, use:

az group deployment create -g functionexamplegroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/sub.json

Per distribuire questo modello di esempio con PowerShell, usare:To deploy this example template with PowerShell, use:

New-AzureRmResourceGroupDeployment -ResourceGroupName functionexamplegroup -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/functions/sub.json

Passaggi successiviNext steps