Funzioni numeriche per i modelli di Azure Resource Manager

Gestione risorse fornisce le funzioni seguenti per usare i numeri interi:

add

add(operand1, operand2)

Restituisce la somma dei due numeri interi forniti.

Parametri

Parametro Obbligatorio Tipo Descrizione
operand1 int Il primo numero da aggiungere.
operand2 int Il secondo numero da aggiungere.

Valore restituito

Un intero che contiene la somma dei parametri.

Esempio

Il modello di esempio seguente aggiunge due parametri.

{
    "$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:

Nome Tipo Valore
addResult int 8

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

copyIndex

copyIndex(loopName, offset)

Restituisce l'indice di un ciclo di iterazione.

Parametri

Parametro Obbligatorio Tipo Descrizione
loopName No string Nome del ciclo per ottenere l'iterazione.
offset No int Il numero da aggiungere al valore di iterazione in base zero.

Osservazioni

Questa funzione viene sempre usata con un oggetto copy . Se non viene specificato alcun valore per offset, viene restituito il valore di iterazione corrente. Il valore di iterazione inizia da zero.

La proprietà loopName consente di specificare se copyIndex fa riferimento all'iterazione di una risorsa o all'iterazione di una proprietà. Se non viene specificato alcun valore per loopName, viene usata l'iterazione del tipo di risorsa corrente. Specificare un valore per loopName durante l'iterazione di una proprietà.

Per una descrizione completa dell'uso di copyIndex, vedere Creare più istanze di risorse in Azure Resource Manager.

Esempio

L'esempio seguente illustra un ciclo di copy e il valore di indice incluso nel nome.

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

Valore restituito

Un intero che rappresenta l'indice corrente dell'iterazione.

div

div(operand1, operand2)

Restituisce la divisione Integer dei due numeri interi forniti.

Parametri

Parametro Obbligatorio Tipo Descrizione
operand1 int Il numero da dividere.
operand2 int Il numero usato per dividere. Non può essere 0.

Valore restituito

Un intero che rappresenta la divisione.

Esempio

Il modello di esempio seguente mostra come dividere un parametro per un altro parametro.

{
    "$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:

Nome Tipo Valore
divResult int 2

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

float

float(arg1)

Converte il valore in un numero a virgola mobile. Usare questa funzione solo quando si passano parametri personalizzati a un'applicazione, ad esempio un'app per la logica.

Parametri

Parametro Obbligatorio Tipo Descrizione
arg1 stringa o int Il valore da convertire in un numero a virgola mobile.

Valore restituito

Un numero a virgola mobile.

Esempio

L'esempio seguente illustra come usare float per passare parametri a un'app per la logica:

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

int

int(valueToConvert)

Converte il valore specificato in un numero intero.

Parametri

Parametro Obbligatorio Tipo Descrizione
valueToConvert stringa o int Il valore da convertire in numero intero.

Valore restituito

Un intero del valore convertito.

Esempio

Il modello di esempio seguente converte il valore del parametro fornito dall'utente in intero.

{
    "$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:

Nome Tipo Valore
intResult int 4

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

max

max (arg1)

Restituisce il valore massimo da una matrice di numeri interi o da un elenco di numeri interi delimitato da virgole.

Parametri

Parametro Obbligatorio Tipo Descrizione
arg1 matrice di numeri interi o elenco di numeri interi delimitato da virgole La raccolta per ottenere il valore massimo.

Valore restituito

Un intero che rappresenta il valore massimo dalla raccolta.

Esempio

Il modello di esempio seguente mostra come usare la funzione max con una matrice e un elenco di numeri interi:

{
    "$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:

Nome Tipo Valore
arrayOutput int 5
intOutput int 5

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

Min

min (arg1)

Restituisce il valore minimo di una matrice di numeri interi o di un elenco di numeri interi delimitato da virgole.

Parametri

Parametro Obbligatorio Tipo Descrizione
arg1 matrice di numeri interi o elenco di numeri interi delimitato da virgole La raccolta per ottenere il valore minimo.

Valore restituito

un intero che rappresenta il valore minimo dalla raccolta.

Esempio

Il modello di esempio seguente mostra come usare la funzione min con una matrice e un elenco di numeri interi:

{
    "$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:

Nome Tipo Valore
arrayOutput int 0
intOutput int 0

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

mod

mod(operand1, operand2)

Restituisce la parte rimanente della divisione Integer usando i due numeri interi forniti.

Parametri

Parametro Obbligatorio Tipo Descrizione
operand1 int Il numero da dividere.
operand2 int Il numero usato per dividere; non può corrispondere a 0.

Valore restituito

Un intero che rappresenta il resto.

Esempio

Il modello di esempio seguente restituisce il resto della divisione di un parametro per un altro parametro.

{
    "$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:

Nome Tipo Valore
modResult int 1

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

mul

mul(operand1, operand2)

Restituisce la moltiplicazione dei due numeri interi forniti.

Parametri

Parametro Obbligatorio Tipo Descrizione
operand1 int Il primo numero da moltiplicare.
operand2 int Il secondo numero da moltiplicare.

Valore restituito

Un intero che rappresenta la moltiplicazione.

Esempio

Il modello di esempio seguente mostra come moltiplicare un parametro per un altro parametro.

{
    "$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:

Nome Tipo Valore
mulResult int 15

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

sub

sub(operand1, operand2)

Restituisce la sottrazione dei due numeri interi forniti.

Parametri

Parametro Obbligatorio Tipo Descrizione
operand1 int Il numero da cui sottrarre.
operand2 int Il numero sottratto.

Valore restituito

Un intero che rappresenta la sottrazione.

Esempio

Il modello di esempio seguente mostra come sottrarre un parametro da un altro parametro.

{
    "$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:

Nome Tipo Valore
subResult int 4

Per distribuire questo modello di esempio con l'interfaccia della riga di comando di Azure, usare:

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:

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

Passaggi successivi