Funzioni di matrice e oggetto per i modelli di Azure Resource ManagerArray and object functions for Azure Resource Manager templates

Resource Manager offre diverse funzioni per l'uso di matrici e oggetti.Resource Manager provides several functions for working with arrays and objects.

Per ottenere una matrice di valori stringa delimitata da un valore, vedere split.To get an array of string values delimited by a value, see split.

arrayarray

array(convertToArray)

Converte il valore in matrice.Converts the value to an array.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
convertToArrayconvertToArray Yes numero intero, stringa, matrice o oggettoint, string, array, or object Valore da convertire in matrice.The value to convert to an array.

Valore restituitoReturn value

Una matrice.An array.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione matrice con tipi diversi.The following example template shows how to use the array function with different types.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "intToConvert": {
            "type": "int",
            "defaultValue": 1
        },
        "stringToConvert": {
            "type": "string",
            "defaultValue": "a"
        },
        "objectToConvert": {
            "type": "object",
            "defaultValue": {"a": "b", "c": "d"}
        }
    },
    "resources": [
    ],
    "outputs": {
        "intOutput": {
            "type": "array",
            "value": "[array(parameters('intToConvert'))]"
        },
        "stringOutput": {
            "type": "array",
            "value": "[array(parameters('stringToConvert'))]"
        },
        "objectOutput": {
            "type": "array",
            "value": "[array(parameters('objectToConvert'))]"
        }
    }
}

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
intOutputintOutput ArrayArray [1][1]
stringOutputstringOutput ArrayArray ["a"]["a"]
objectOutputobjectOutput ArrayArray [{"a": "b", "c": "d"}][{"a": "b", "c": "d"}]

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/array.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/array.json

coalescecoalesce

coalesce(arg1, arg2, arg3, ...)

Restituisce il primo valore non null dai parametri.Returns first non-null value from the parameters. Stringhe vuote, matrici vuote e oggetti vuoti sono non null.Empty strings, empty arrays, and empty objects are not null.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes numero intero, stringa, matrice o oggettoint, string, array, or object Il primo valore da controllare per verificare se è null.The first value to test for null.
argomenti aggiuntiviadditional args NoNo numero intero, stringa, matrice o oggettoint, string, array, or object Valori aggiuntivi da controllare per verificare se sono null.Additional values to test for null.

Valore restituitoReturn value

Valore dei primi parametri non null, che può essere una stringa, un numero intero, una matrice o un oggetto.The value of the first non-null parameters, which can be a string, int, array, or object. Null se tutti i parametri sono null.Null if all parameters are null.

EsempioExample

Il modello di esempio seguente illustra l'output per diversi usi di coalesce.The following example template shows the output from different uses of coalesce.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "objectToTest": {
            "type": "object",
            "defaultValue": {
                "null1": null, 
                "null2": null,
                "string": "default",
                "int": 1,
                "object": {"first": "default"},
                "array": [1]
            }
        }
    },
    "resources": [
    ],
    "outputs": {
        "stringOutput": {
            "type": "string",
            "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').string)]"
        },
        "intOutput": {
            "type": "int",
            "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').int)]"
        },
        "objectOutput": {
            "type": "object",
            "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').object)]"
        },
        "arrayOutput": {
            "type": "array",
            "value": "[coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2, parameters('objectToTest').array)]"
        },
        "emptyOutput": {
            "type": "bool",
            "value": "[empty(coalesce(parameters('objectToTest').null1, parameters('objectToTest').null2))]"
        }
    }
}

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
stringOutputstringOutput StringString defaultdefault
intOutputintOutput intInt 11
objectOutputobjectOutput OggettoObject {"first": "default"}{"first": "default"}
arrayOutputarrayOutput ArrayArray [1][1]
emptyOutputemptyOutput BooleanoBool True True

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/coalesce.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/coalesce.json

concatconcat

concat(arg1, arg2, arg3, ...)

Combina più matrici e restituisce la matrice concatenata oppure combina più valori di stringa e restituisce la stringa concatenata.Combines multiple arrays and returns the concatenated array, or combines multiple string values and returns the concatenated string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringa o matricearray or string La prima matrice o stringa per la concatenazione.The first array or string for concatenation.
argomenti aggiuntiviadditional arguments NoNo stringa o matricearray or string Matrici o stringhe aggiuntive in ordine sequenziale per la concatenazione.Additional arrays or strings in sequential order for concatenation.

Questa funzione può accettare qualsiasi numero di argomenti e può accettare stringhe o matrici per i parametri.This function can take any number of arguments, and can accept either strings or arrays for the parameters.

Valore restituitoReturn value

Stringa o matrice di valori concatenati.A string or array of concatenated values.

EsempioExample

Il modello di esempio seguente illustra come combinare due matrici.The following example template shows how to combine two arrays.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": { 
        "firstArray": { 
            "type": "array", 
            "defaultValue": [ 
                "1-1", 
                "1-2", 
                "1-3" 
            ] 
        },
        "secondArray": {
            "type": "array", 
            "defaultValue": [ 
                "2-1", 
                "2-2",
                "2-3" 
            ] 
        }
    },
    "resources": [
    ],
    "outputs": {
        "return": {
            "type": "array",
            "value": "[concat(parameters('firstArray'), parameters('secondArray'))]"
        }
    }
}

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
returnreturn ArrayArray ["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]

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/concat-array.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/concat-array.json

Il modello di esempio seguente illustra come combinare due valori stringa e restituisce una stringa concatenata.The following example template shows how to combine two string values and return a concatenated string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "prefix": {
            "type": "string",
            "defaultValue": "prefix"
        }
    },
    "resources": [],
    "outputs": {
        "concatOutput": {
            "value": "[concat(parameters('prefix'), '-', uniqueString(resourceGroup().id))]",
            "type" : "string"
        }
    }
}

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
concatOutputconcatOutput StringString prefix-5yj4yjf5mbg72prefix-5yj4yjf5mbg72

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/concat-string.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/concat-string.json

containscontains

contains(container, itemToFind)

Verifica se una matrice contiene un valore, se un oggetto contiene una chiave o se una stringa contiene una sottostringa.Checks whether an array contains a value, an object contains a key, or a string contains a substring.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
Contenitorecontainer Yes matrice, oggetto o stringaarray, object, or string Valore che contiene il valore da trovare.The value that contains the value to find.
itemToFinditemToFind Yes stringa o numero interostring or int Valore da trovare.The value to find.

Valore restituitoReturn value

True se l'elemento viene individuato; in caso contrario, restituisce False.True if the item is found; otherwise, False.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione contains con tipi diversi:The following example template shows how to use contains with different types:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringToTest": {
            "type": "string",
            "defaultValue": "OneTwoThree"
        },
        "objectToTest": {
            "type": "object",
            "defaultValue": {"one": "a", "two": "b", "three": "c"}
        },
        "arrayToTest": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "stringTrue": {
            "type": "bool",
            "value": "[contains(parameters('stringToTest'), 'e')]"
        },
        "stringFalse": {
            "type": "bool",
            "value": "[contains(parameters('stringToTest'), 'z')]"
        },
        "objectTrue": {
            "type": "bool",
            "value": "[contains(parameters('objectToTest'), 'one')]"
        },
        "objectFalse": {
            "type": "bool",
            "value": "[contains(parameters('objectToTest'), 'a')]"
        },
        "arrayTrue": {
            "type": "bool",
            "value": "[contains(parameters('arrayToTest'), 'three')]"
        },
        "arrayFalse": {
            "type": "bool",
            "value": "[contains(parameters('arrayToTest'), 'four')]"
        }
    }
}

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
stringTruestringTrue BooleanoBool True True
stringFalsestringFalse BooleanoBool FalseFalse
objectTrueobjectTrue BooleanoBool True True
objectFalseobjectFalse BooleanoBool FalseFalse
arrayTruearrayTrue BooleanoBool True True
arrayFalsearrayFalse BooleanoBool FalseFalse

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/contains.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/contains.json

createarraycreatearray

createArray (arg1, arg2, arg3, ...)

Crea una matrice dai parametri.Creates an array from the parameters.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes Stringa, numero intero, matrice o oggettoString, Integer, Array, or Object Primo valore della matrice.The first value in the array.
argomenti aggiuntiviadditional arguments NoNo Stringa, numero intero, matrice o oggettoString, Integer, Array, or Object Altri valori della matrice.Additional values in the array.

Valore restituitoReturn value

Una matrice.An array.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione createArray con tipi diversi:The following example template shows how to use createArray with different types:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "objectToTest": {
            "type": "object",
            "defaultValue": {"one": "a", "two": "b", "three": "c"}
        },
        "arrayToTest": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "stringArray": {
            "type": "array",
            "value": "[createArray('a', 'b', 'c')]"
        },
        "intArray": {
            "type": "array",
            "value": "[createArray(1, 2, 3)]"
        },
        "objectArray": {
            "type": "array",
            "value": "[createArray(parameters('objectToTest'))]"
        },
        "arrayArray": {
            "type": "array",
            "value": "[createArray(parameters('arrayToTest'))]"
        }
    }
}

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
stringArraystringArray ArrayArray ["a", "b", "c"]["a", "b", "c"]
intArrayintArray ArrayArray [1, 2, 3][1, 2, 3]
objectArrayobjectArray ArrayArray [{"one": "a", "two": "b", "three": "c"}][{"one": "a", "two": "b", "three": "c"}]
arrayArrayarrayArray ArrayArray [["one", "two", "three"]][["one", "two", "three"]]

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/createarray.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/createarray.json

emptyempty

empty(itemToTest)

Determina se una matrice, un oggetto o una stringa sono vuoti.Determines if an array, object, or string is empty.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
itemToTestitemToTest Yes matrice, oggetto o stringaarray, object, or string Valore da controllare per verificare se è vuoto.The value to check if it is empty.

Valore restituitoReturn value

True se il valore è vuoto; in caso contrario, restituisce False.Returns True if the value is empty; otherwise, False.

EsempioExample

Il modello di esempio seguente controlla se una matrice, un oggetto e una stringa sono vuoti.The following example template checks whether an array, object, and string are empty.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testArray": {
            "type": "array",
            "defaultValue": []
        },
        "testObject": {
            "type": "object",
            "defaultValue": {}
        },
        "testString": {
            "type": "string",
            "defaultValue": ""
        }
    },
    "resources": [
    ],
    "outputs": {
        "arrayEmpty": {
            "type": "bool",
            "value": "[empty(parameters('testArray'))]"
        },
        "objectEmpty": {
            "type": "bool",
            "value": "[empty(parameters('testObject'))]"
        },
        "stringEmpty": {
            "type": "bool",
            "value": "[empty(parameters('testString'))]"
        }
    }
}

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
arrayEmptyarrayEmpty BooleanoBool True True
objectEmptyobjectEmpty BooleanoBool True True
stringEmptystringEmpty BooleanoBool True True

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/empty.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/empty.json

firstfirst

first(arg1)

Restituisce il primo elemento della matrice o il primo carattere della stringa.Returns the first element of the array, or first character of the string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringa o matricearray or string Valore per recuperare il primo elemento o carattere.The value to retrieve the first element or character.

Valore restituitoReturn value

Il tipo (string, int, array o object) del primo elemento di una matrice o il primo carattere di una stringa.The type (string, int, array, or object) of the first element in an array, or the first character of a string.

EsempioExample

Il modello di esempio seguente mostra come usare la prima funzione con una matrice e una stringa.The following example template shows how to use the first function with an array and string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "arrayToTest": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "arrayOutput": {
            "type": "string",
            "value": "[first(parameters('arrayToTest'))]"
        },
        "stringOutput": {
            "type": "string",
            "value": "[first('One Two Three')]"
        }
    }
}

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 StringString oneone
stringOutputstringOutput StringString OO

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/first.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/first.json

intersezioneintersection

intersection(arg1, arg2, arg3, ...)

Restituisce una matrice o un oggetto singoli con gli elementi comuni dei parametri.Returns a single array or object with the common elements from the parameters.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes matrice o oggettoarray or object Primo valore da usare per cercare elementi comuni.The first value to use for finding common elements.
arg2arg2 Yes matrice o oggettoarray or object Secondo valore da usare per cercare elementi comuni.The second value to use for finding common elements.
argomenti aggiuntiviadditional arguments NoNo matrice o oggettoarray or object Valori aggiuntivi da usare per cercare elementi comuni.Additional values to use for finding common elements.

Valore restituitoReturn value

Una matrice o un oggetto con elementi comuni.An array or object with the common elements.

EsempioExample

Il modello di esempio seguente mostra come usare l'intersezione con matrici e oggetti:The following example template shows how to use intersection with arrays and objects:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "firstObject": {
            "type": "object",
            "defaultValue": {"one": "a", "two": "b", "three": "c"}
        },
        "secondObject": {
            "type": "object",
            "defaultValue": {"one": "a", "two": "z", "three": "c"}
        },
        "firstArray": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        },
        "secondArray": {
            "type": "array",
            "defaultValue": ["two", "three"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "objectOutput": {
            "type": "object",
            "value": "[intersection(parameters('firstObject'), parameters('secondObject'))]"
        },
        "arrayOutput": {
            "type": "array",
            "value": "[intersection(parameters('firstArray'), parameters('secondArray'))]"
        }
    }
}

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
objectOutputobjectOutput OggettoObject {"one": "a", "three": "c"}{"one": "a", "three": "c"}
arrayOutputarrayOutput ArrayArray ["two", "three"]["two", "three"]

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/intersection.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/intersection.json

jsonjson

json(arg1)

Restituisce un oggetto JSON.Returns a JSON object.

parametersParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringstring Valore da convertire in JSON.The value to convert to JSON.

Valore restituitoReturn value

Oggetto JSON dalla stringa specificata o un oggetto vuoto quando viene specificato null.The JSON object from the specified string, or an empty object when null is specified.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione json con matrici e oggetti:The following example template shows how to use the json function with arrays and objects:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
    ],
    "outputs": {
        "jsonOutput": {
            "type": "object",
            "value": "[json('{\"a\": \"b\"}')]"
        },
        "nullOutput": {
            "type": "bool",
            "value": "[empty(json('null'))]"
        }
    }
}

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
jsonOutputjsonOutput OggettoObject {"a": "b"}{"a": "b"}
nullOutputnullOutput BooleanBoolean True True

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/json.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/json.json

lastlast

last (arg1)

Restituisce l'ultimo elemento della matrice o l'ultimo carattere della stringa.Returns the last element of the array, or last character of the string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringa o matricearray or string Valore per recuperare l'ultimo elemento o carattere.The value to retrieve the last element or character.

Valore restituitoReturn value

Il tipo (string, int, array o object) dell'ultimo elemento di una matrice o l'ultimo carattere di una stringa.The type (string, int, array, or object) of the last element in an array, or the last character of a string.

EsempioExample

Il modello di esempio seguente mostra come usare l'ultima funzione con una matrice e una stringa.The following example template shows how to use the last function with an array and string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "arrayToTest": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "arrayOutput": {
            "type": "string",
            "value": "[last(parameters('arrayToTest'))]"
        },
        "stringOutput": {
            "type": "string",
            "value": "[last('One Two Three')]"
        }
    }
}

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 StringString threethree
stringOutputstringOutput StringString ee

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/last.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/last.json

lengthlength

length(arg1)

Restituisce il numero di elementi in una matrice o di caratteri in una stringa.Returns the number of elements in an array, or characters in a string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes stringa o matricearray or string Matrice da usare per ottenere il numero di elementi oppure stringa da usare per ottenere il numero di caratteri.The array to use for getting the number of elements, or the string to use for getting the number of characters.

Valore restituitoReturn value

Numero interoAn int.

EsempioExample

Il modello di esempio seguente mostra come usare la funzione length con una matrice e una stringa:The following example template shows how to use length with an array and string:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "arrayToTest": {
            "type": "array",
            "defaultValue": [
                "one",
                "two",
                "three"
            ]
        },
        "stringToTest": {
            "type": "string",
            "defaultValue": "One Two Three"
        }
    },
    "resources": [],
    "outputs": {
        "arrayLength": {
            "type": "int",
            "value": "[length(parameters('arrayToTest'))]"
        },
        "stringLength": {
            "type": "int",
            "value": "[length(parameters('stringToTest'))]"
        }
    }
}

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
arrayLengtharrayLength intInt 33
stringLengthstringLength intInt 1313

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/length.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/length.json

È possibile usare questa funzione con una matrice per specificare il numero di iterazioni durante la creazione di risorse.You can use this function with an array to specify the number of iterations when creating resources. Nell'esempio seguente, il parametro siteNames fa riferimento a una matrice di nomi da usare durante la creazione di siti Web.In the following example, the parameter siteNames would refer to an array of names to use when creating the web sites.

"copy": {
    "name": "websitescopy",
    "count": "[length(parameters('siteNames'))]"
}

Per altre informazioni sull'uso di questa funzione con una matrice, vedere Creare più istanze di risorse in Gestione risorse di Azure.For more information about using this function with an array, see Create multiple instances of resources in Azure Resource Manager.

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

Numero intero che rappresenta il valore massimo.An int representing the maximum value.

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

Numero intero che rappresenta il valore minimo.An int representing the minimum value.

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

rangerange

range(startingInteger, numberOfElements)

Crea una matrice di numeri interi da un numero intero iniziale, contenente un dato numero di elementi.Creates an array of integers from a starting integer and containing a number of items.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
startingIntegerstartingInteger Yes intint Primo numero intero nella matrice.The first integer in the array.
numberofElementsnumberofElements Yes intint Numero di valori interi della matrice.The number of integers in the array.

Valore restituitoReturn value

Matrice di numeri interi.An array of integers.

EsempioExample

Il modello di esempio seguente illustra come usare la funzione range:The following example template shows how to use the range function:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "startingInt": {
            "type": "int",
            "defaultValue": 5
        },
        "numberOfElements": {
            "type": "int",
            "defaultValue": 3
        }
    },
    "resources": [],
    "outputs": {
        "rangeOutput": {
            "type": "array",
            "value": "[range(parameters('startingInt'),parameters('numberOfElements'))]"
        }
    }
}

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
rangeOutputrangeOutput ArrayArray [5, 6, 7][5, 6, 7]

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/range.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/range.json

skipskip

skip(originalValue, numberToSkip)

Restituisce una matrice con tutti gli elementi dopo il numero specificato nella matrice stessa o una stringa con tutti i caratteri dopo il numero specificato nella stringa stessa.Returns an array with all the elements after the specified number in the array, or returns a string with all the characters after the specified number in the string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
originalValueoriginalValue Yes stringa o matricearray or string Stringa o matrice da usare per i valori da ignorare.The array or string to use for skipping.
numberToSkipnumberToSkip Yes intint Numero di elementi o caratteri da ignorare.The number of elements or characters to skip. Se il valore è minore o uguale a 0, vengono restituiti tutti gli elementi o i caratteri nel valore.If this value is 0 or less, all the elements or characters in the value are returned. Se il valore è maggiore della lunghezza della stringa o della matrice, viene restituita una stringa o una matrice vuota.If it is larger than the length of the array or string, an empty array or string is returned.

Valore restituitoReturn value

Stringa o matrice.An array or string.

EsempioExample

Il modello di esempio seguente ignora il numero di elementi specificato nella matrice e il numero di caratteri specificato in una stringa.The following example template skips the specified number of elements in the array, and the specified number of characters in a string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testArray": {
            "type": "array",
            "defaultValue": [
                "one",
                "two",
                "three"
            ]
        },
        "elementsToSkip": {
            "type": "int",
            "defaultValue": 2
        },
        "testString": {
            "type": "string",
            "defaultValue": "one two three"
        },
        "charactersToSkip": {
            "type": "int",
            "defaultValue": 4
        }
    },
    "resources": [],
    "outputs": {
        "arrayOutput": {
            "type": "array",
            "value": "[skip(parameters('testArray'),parameters('elementsToSkip'))]"
        },
        "stringOutput": {
            "type": "string",
            "value": "[skip(parameters('testString'),parameters('charactersToSkip'))]"
        }
    }
}

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 ArrayArray ["three"]["three"]
stringOutputstringOutput StringString two threetwo three

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/skip.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/skip.json

taketake

take(originalValue, numberToTake)

Restituisce una matrice con il numero specificato di elementi dall'inizio della matrice, o una stringa con il numero specificato di caratteri dall'inizio della stringa.Returns an array with the specified number of elements from the start of the array, or a string with the specified number of characters from the start of the string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
originalValueoriginalValue Yes stringa o matricearray or string Stringa o matrice da cui prendere gli elementi.The array or string to take the elements from.
numberToTakenumberToTake Yes intint Numero di elementi o caratteri da prendere.The number of elements or characters to take. Se il valore è minore o uguale a 0, viene restituita una stringa o un matrice vuota.If this value is 0 or less, an empty array or string is returned. Se il valore è maggiore della lunghezza della stringa o matrice specificata, vengono restituiti tutti gli elementi nella stringa o nella matrice.If it is larger than the length of the given array or string, all the elements in the array or string are returned.

Valore restituitoReturn value

Stringa o matrice.An array or string.

EsempioExample

Il modello di esempio seguente prende il numero specificato di elementi dalla matrice e di caratteri dalla stringa.The following example template takes the specified number of elements from the array, and characters from a string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testArray": {
            "type": "array",
            "defaultValue": [
                "one",
                "two",
                "three"
            ]
        },
        "elementsToTake": {
            "type": "int",
            "defaultValue": 2
        },
        "testString": {
            "type": "string",
            "defaultValue": "one two three"
        },
        "charactersToTake": {
            "type": "int",
            "defaultValue": 2
        }
    },
    "resources": [],
    "outputs": {
        "arrayOutput": {
            "type": "array",
            "value": "[take(parameters('testArray'),parameters('elementsToTake'))]"
        },
        "stringOutput": {
            "type": "string",
            "value": "[take(parameters('testString'),parameters('charactersToTake'))]"
        }
    }
}

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 ArrayArray ["one", "two"]["one", "two"]
stringOutputstringOutput StringString inon

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/take.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/take.json

unionunion

union(arg1, arg2, arg3, ...)

Restituisce una matrice o un oggetto singoli con tutti gli elementi dei parametri.Returns a single array or object with all elements from the parameters. Valori e chiavi duplicati sono inclusi una sola volta.Duplicate values or keys are only included once.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes matrice o oggettoarray or object Primo valore da usare per l'aggiunta di elementi.The first value to use for joining elements.
arg2arg2 Yes matrice o oggettoarray or object Secondo valore da usare per l'aggiunta di elementi.The second value to use for joining elements.
argomenti aggiuntiviadditional arguments NoNo matrice o oggettoarray or object Valori aggiuntivi da usare per l'aggiunta di elementi.Additional values to use for joining elements.

Valore restituitoReturn value

Una matrice o un oggetto.An array or object.

EsempioExample

Il modello di esempio seguente mostra come usare l'intersezione con matrici e oggetti:The following example template shows how to use union with arrays and objects:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "firstObject": {
            "type": "object",
            "defaultValue": {"one": "a", "two": "b", "three": "c1"}
        },
        "secondObject": {
            "type": "object",
            "defaultValue": {"three": "c2", "four": "d", "five": "e"}
        },
        "firstArray": {
            "type": "array",
            "defaultValue": ["one", "two", "three"]
        },
        "secondArray": {
            "type": "array",
            "defaultValue": ["three", "four"]
        }
    },
    "resources": [
    ],
    "outputs": {
        "objectOutput": {
            "type": "object",
            "value": "[union(parameters('firstObject'), parameters('secondObject'))]"
        },
        "arrayOutput": {
            "type": "array",
            "value": "[union(parameters('firstArray'), parameters('secondArray'))]"
        }
    }
}

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
objectOutputobjectOutput OggettoObject {"one": "a", "two": "b", "three": "c2", "four": "d", "five": "e"}{"one": "a", "two": "b", "three": "c2", "four": "d", "five": "e"}
arrayOutputarrayOutput ArrayArray ["one", "two", "three", "four"]["one", "two", "three", "four"]

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/union.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/union.json

Passaggi successiviNext steps