Funzioni di stringa nei modelli di Azure Resource ManagerString functions for Azure Resource Manager templates

Gestione risorse fornisce le funzioni seguenti per usare le stringhe:Resource Manager provides the following functions for working with strings:

base64base64

base64(inputString)

Restituisce la rappresentazione base64 della stringa di input.Returns the base64 representation of the input string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
inputStringinputString Yes stringstring Il valore da restituire come rappresentazione base64.The value to return as a base64 representation.

Valore restituitoReturn value

Stringa contenente la rappresentazione base64.A string containing the base64 representation.

esempiExamples

Il modello di esempio seguente mostra come usare la funzione base64.The following example template shows how to use the base64 function.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringData": {
            "type": "string",
            "defaultValue": "one, two, three"
        },
        "jsonFormattedData": {
            "type": "string",
            "defaultValue": "{'one': 'a', 'two': 'b'}"
        }
    },
    "variables": {
        "base64String": "[base64(parameters('stringData'))]",
        "base64Object": "[base64(parameters('jsonFormattedData'))]"
    },
    "resources": [
    ],
    "outputs": {
        "base64Output": {
            "type": "string",
            "value": "[variables('base64String')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[base64ToString(variables('base64String'))]"
        },
        "toJsonOutput": {
            "type": "object",
            "value": "[base64ToJson(variables('base64Object'))]"
        }
    }
}

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
base64Outputbase64Output StringString b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput StringString one, two, threeone, two, three
toJsonOutputtoJsonOutput OggettoObject {"one": "a", "two": "b"}{"one": "a", "two": "b"}

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

base64ToJsonbase64ToJson

base64tojson

Converte una rappresentazione base64 in un oggetto JSON.Converts a base64 representation to a JSON object.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
base64Valuebase64Value Yes stringstring Rappresentazione base64 da convertire in un oggetto JSON.The base64 representation to convert to a JSON object.

Valore restituitoReturn value

Oggetto JSON.A JSON object.

esempiExamples

Il modello di esempio seguente usa la funzione base64ToJson per convertire un valore base64:The following example template uses the base64ToJson function to convert a base64 value:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringData": {
            "type": "string",
            "defaultValue": "one, two, three"
        },
        "jsonFormattedData": {
            "type": "string",
            "defaultValue": "{'one': 'a', 'two': 'b'}"
        }
    },
    "variables": {
        "base64String": "[base64(parameters('stringData'))]",
        "base64Object": "[base64(parameters('jsonFormattedData'))]"
    },
    "resources": [
    ],
    "outputs": {
        "base64Output": {
            "type": "string",
            "value": "[variables('base64String')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[base64ToString(variables('base64String'))]"
        },
        "toJsonOutput": {
            "type": "object",
            "value": "[base64ToJson(variables('base64Object'))]"
        }
    }
}

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
base64Outputbase64Output StringString b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput StringString one, two, threeone, two, three
toJsonOutputtoJsonOutput OggettoObject {"one": "a", "two": "b"}{"one": "a", "two": "b"}

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

base64ToStringbase64ToString

base64ToString(base64Value)

Converte una rappresentazione base64 in una stringa.Converts a base64 representation to a string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
base64Valuebase64Value Yes stringstring Rappresentazione base64 da convertire in stringa.The base64 representation to convert to a string.

Valore restituitoReturn value

Stringa del valore base64 convertito.A string of the converted base64 value.

esempiExamples

Il modello di esempio seguente usa la funzione base64ToString per convertire un valore base64:The following example template uses the base64ToString function to convert a base64 value:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringData": {
            "type": "string",
            "defaultValue": "one, two, three"
        },
        "jsonFormattedData": {
            "type": "string",
            "defaultValue": "{'one': 'a', 'two': 'b'}"
        }
    },
    "variables": {
        "base64String": "[base64(parameters('stringData'))]",
        "base64Object": "[base64(parameters('jsonFormattedData'))]"
    },
    "resources": [
    ],
    "outputs": {
        "base64Output": {
            "type": "string",
            "value": "[variables('base64String')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[base64ToString(variables('base64String'))]"
        },
        "toJsonOutput": {
            "type": "object",
            "value": "[base64ToJson(variables('base64Object'))]"
        }
    }
}

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
base64Outputbase64Output StringString b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput StringString one, two, threeone, two, three
toJsonOutputtoJsonOutput OggettoObject {"one": "a", "two": "b"}{"one": "a", "two": "b"}

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

concatconcat

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

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

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
arg1arg1 Yes Stringa o matricestring or array Il primo valore per la concatenazione.The first value for concatenation.
Argomenti aggiuntiviadditional arguments NoNo stringstring Altri valori in ordine sequenziale per la concatenazione.Additional values in sequential order for concatenation.

Valore restituitoReturn value

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

esempiExamples

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

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

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.

esempiExamples

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

dataUridataUri

dataUri(stringToConvert)

Converte un valore in un URI di dati.Converts a value to a data URI.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToConvertstringToConvert Yes stringstring Valore da convertire in un URI di dati.The value to convert to a data URI.

Valore restituitoReturn value

Stringa formattata come URI di dati.A string formatted as a data URI.

esempiExamples

Il modello di esempio seguente converte un valore in un URI di dati e converte un URI di dati in una stringa:The following example template converts a value to a data URI, and converts a data URI to a string:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringToTest": {
            "type": "string",
            "defaultValue": "Hello"
        },
        "dataFormattedString": {
            "type": "string",
            "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
        }
    },
    "resources": [],
    "outputs": {
        "dataUriOutput": {
            "value": "[dataUri(parameters('stringToTest'))]",
            "type" : "string"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[dataUriToString(parameters('dataFormattedString'))]"
        }
    }
}

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
dataUriOutputdataUriOutput StringString data:text/plain;charset=utf8;base64,SGVsbG8=data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutputtoStringOutput StringString Hello, World!Hello, World!

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

dataUriToStringdataUriToString

dataUriToString(dataUriToConvert)

Converte un valore formattato come URI di dati in una stringa.Converts a data URI formatted value to a string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
dataUriToConvertdataUriToConvert Yes stringstring Valore dell'URI di dati da convertire.The data URI value to convert.

Valore restituitoReturn value

Stringa contenente il valore convertito.A string containing the converted value.

esempiExamples

Il modello di esempio seguente converte un valore in un URI di dati e converte un URI di dati in una stringa:The following example template converts a value to a data URI, and converts a data URI to a string:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "stringToTest": {
            "type": "string",
            "defaultValue": "Hello"
        },
        "dataFormattedString": {
            "type": "string",
            "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
        }
    },
    "resources": [],
    "outputs": {
        "dataUriOutput": {
            "value": "[dataUri(parameters('stringToTest'))]",
            "type" : "string"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[dataUriToString(parameters('dataFormattedString'))]"
        }
    }
}

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
dataUriOutputdataUriOutput StringString data:text/plain;charset=utf8;base64,SGVsbG8=data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutputtoStringOutput StringString Hello, World!Hello, World!

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

esempiExamples

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

endsWithendsWith

endsWith(stringToSearch, stringToFind)

Determina se una stringa termina con un valore.Determines whether a string ends with a value. Il confronto non fa distinzione tra maiuscole e minuscole.The comparison is case-insensitive.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToSearchstringToSearch Yes stringstring Valore che contiene l'elemento da cercare.The value that contains the item to find.
stringToFindstringToFind Yes stringstring Valore da trovare.The value to find.

Valore restituitoReturn value

True se l'ultimo carattere o i caratteri della stringa corrispondono al valore; in caso contrario, restituisce False.True if the last character or characters of the string match the value; otherwise, False.

esempiExamples

Il modello di esempio seguente mostra come usare le funzioni startsWith ed endsWith:The following example template shows how to use the startsWith and endsWith functions:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "startsTrue": {
            "value": "[startsWith('abcdef', 'ab')]",
            "type" : "bool"
        },
        "startsCapTrue": {
            "value": "[startsWith('abcdef', 'A')]",
            "type" : "bool"
        },
        "startsFalse": {
            "value": "[startsWith('abcdef', 'e')]",
            "type" : "bool"
        },
        "endsTrue": {
            "value": "[endsWith('abcdef', 'ef')]",
            "type" : "bool"
        },
        "endsCapTrue": {
            "value": "[endsWith('abcdef', 'F')]",
            "type" : "bool"
        },
        "endsFalse": {
            "value": "[endsWith('abcdef', 'e')]",
            "type" : "bool"
        }
    }
}

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
startsTruestartsTrue BooleanoBool True True
startsCapTruestartsCapTrue BooleanoBool True True
startsFalsestartsFalse BooleanoBool FalseFalse
endsTrueendsTrue BooleanoBool True True
endsCapTrueendsCapTrue BooleanoBool True True
endsFalseendsFalse 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/startsendswith.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/startsendswith.json

firstfirst

first(arg1)

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

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

Stringa del primo carattere o il tipo del primo elemento in una matrice (stringa, numero intero, matrice o oggetto).A string of the first character, or the type (string, int, array, or object) of the first element in an array.

esempiExamples

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

guidguid

guid (baseString, ...)

Crea un valore con il formato di un identificatore univoco globale in base ai valori specificati come parametri.Creates a value in the format of a globally unique identifier based on the values provided as parameters.

parametersParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
baseStringbaseString Yes stringstring Il valore usato nella funzione hash per creare il GUID.The value used in the hash function to create the GUID.
parametri aggiuntivi in base alle esigenzeadditional parameters as needed NoNo stringstring È possibile aggiungere tutte le stringhe necessarie per creare il valore che specifica il livello di univocità.You can add as many strings as needed to create the value that specifies the level of uniqueness.

OsservazioniRemarks

Questa funzione è utile quando è necessario creare un valore con il formato di un identificatore univoco globale.This function is helpful when you need to create a value in the format of a globally unique identifier. È possibile specificare i valori dei parametri che limitano l'ambito di univocità per il risultato.You provide parameter values that limit the scope of uniqueness for the result. È possibile specificare se il nome è univoco nella sottoscrizione, nel gruppo di risorse o nella distribuzione.You can specify whether the name is unique down to subscription, resource group, or deployment.

Il valore restituito non è una stringa casuale, ma il risultato di una funzione hash.The returned value is not a random string, but rather the result of a hash function. Il valore restituito è lungo 36 caratteri.The returned value is 36 characters long. Non è globalmente univoco.It is not globally unique.

Gli esempi seguenti illustrano come usare guid per creare un valore univoco per livelli di uso comune.The following examples show how to use guid to create a unique value for commonly used levels.

Con ambito univoco nella sottoscrizioneUnique scoped to subscription

"[guid(subscription().subscriptionId)]"

Con ambito univoco nel gruppo di risorseUnique scoped to resource group

"[guid(resourceGroup().id)]"

Con ambito univoco nella distribuzione per un gruppo di risorseUnique scoped to deployment for a resource group

"[guid(resourceGroup().id, deployment().name)]"

Valore restituitoReturn value

Stringa contenente 36 caratteri nel formato di un identificatore univoco globale.A string containing 36 characters in the format of a globally unique identifier.

esempiExamples

Il modello di esempio seguente restituisce risultati da guid:The following example template returns results from guid:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {},
    "variables": {},
    "resources": [],
    "outputs": {
        "guidPerSubscription": {
            "value": "[guid(subscription().subscriptionId)]",
            "type": "string"
        },
        "guidPerResourceGroup": {
            "value": "[guid(resourceGroup().id)]",
            "type": "string"
        },
        "guidPerDeployment": {
            "value": "[guid(resourceGroup().id, deployment().name)]",
            "type": "string"
        }
    }
}

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

indexOfindexOf

indexOf(stringToSearch, stringToFind)

Restituisce la prima posizione di un valore all'interno di una stringa.Returns the first position of a value within a string. Il confronto non fa distinzione tra maiuscole e minuscole.The comparison is case-insensitive.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToSearchstringToSearch Yes stringstring Valore che contiene l'elemento da cercare.The value that contains the item to find.
stringToFindstringToFind Yes stringstring Valore da trovare.The value to find.

Valore restituitoReturn value

Numero intero che rappresenta la posizione dell'elemento da trovare.An integer that represents the position of the item to find. Il valore è in base zero.The value is zero-based. Se l'elemento non viene trovato, viene restituito -1.If the item is not found, -1 is returned.

esempiExamples

Il modello di esempio seguente mostra come usare le funzioni indexOf e lastIndexOf:The following example template shows how to use the indexOf and lastIndexOf functions:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "firstT": {
            "value": "[indexOf('test', 't')]",
            "type" : "int"
        },
        "lastT": {
            "value": "[lastIndexOf('test', 't')]",
            "type" : "int"
        },
        "firstString": {
            "value": "[indexOf('abcdef', 'CD')]",
            "type" : "int"
        },
        "lastString": {
            "value": "[lastIndexOf('abcdef', 'AB')]",
            "type" : "int"
        },
        "notFound": {
            "value": "[indexOf('abcdef', 'z')]",
            "type" : "int"
        }
    }
}

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
firstTfirstT intInt 00
lastTlastT intInt 33
firstStringfirstString intInt 22
lastStringlastString intInt 00
notFoundnotFound intInt -1-1

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

lastlast

last (arg1)

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

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

Stringa dell'ultimo carattere o il tipo dell'ultimo elemento in una matrice (stringa, numero intero, matrice o oggetto).A string of the last character, or the type (string, int, array, or object) of the last element in an array.

esempiExamples

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

lastIndexOflastIndexOf

lastIndexOf(stringToSearch, stringToFind)

Restituisce l'ultima posizione di un valore all'interno di una stringa.Returns the last position of a value within a string. Il confronto non fa distinzione tra maiuscole e minuscole.The comparison is case-insensitive.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToSearchstringToSearch Yes stringstring Valore che contiene l'elemento da cercare.The value that contains the item to find.
stringToFindstringToFind Yes stringstring Valore da trovare.The value to find.

Valore restituitoReturn value

Numero intero che rappresenta l'ultima posizione dell'elemento da trovare.An integer that represents the last position of the item to find. Il valore è in base zero.The value is zero-based. Se l'elemento non viene trovato, viene restituito -1.If the item is not found, -1 is returned.

esempiExamples

Il modello di esempio seguente mostra come usare le funzioni indexOf e lastIndexOf:The following example template shows how to use the indexOf and lastIndexOf functions:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "firstT": {
            "value": "[indexOf('test', 't')]",
            "type" : "int"
        },
        "lastT": {
            "value": "[lastIndexOf('test', 't')]",
            "type" : "int"
        },
        "firstString": {
            "value": "[indexOf('abcdef', 'CD')]",
            "type" : "int"
        },
        "lastString": {
            "value": "[lastIndexOf('abcdef', 'AB')]",
            "type" : "int"
        },
        "notFound": {
            "value": "[indexOf('abcdef', 'z')]",
            "type" : "int"
        }
    }
}

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
firstTfirstT intInt 00
lastTlastT intInt 33
firstStringfirstString intInt 22
lastStringlastString intInt 00
notFoundnotFound intInt -1-1

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

lengthlength

length(string)

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

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.

esempiExamples

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

padLeftpadLeft

padLeft(valueToPad, totalLength, paddingCharacter)

Restituisce una stringa allineata a destra mediante l'aggiunta di caratteri a sinistra, fino a raggiungere la lunghezza totale specificata.Returns a right-aligned string by adding characters to the left until reaching the total specified length.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
valueToPadvalueToPad Yes Stringa o numero interostring or int Il valore per eseguire l'allineamento a destra.The value to right-align.
totalLengthtotalLength Yes intint Numero totale di caratteri della stringa restituita.The total number of characters in the returned string.
paddingCharacterpaddingCharacter NoNo Carattere singolosingle character Il carattere da utilizzare per la spaziatura interna a sinistra, fino a raggiungere la lunghezza totale.The character to use for left-padding until the total length is reached. Il valore predefinito è uno spazio.The default value is a space.

Se la stringa originale è più lunga rispetto al numero di caratteri di riempimento, non vengono aggiunti caratteri.If the original string is longer than the number of characters to pad, no characters are added.

Valore restituitoReturn value

Stringa contenente come minimo il numero di caratteri specificati.A string with at least the number of specified characters.

esempiExamples

Il modello di esempio seguente mostra come il valore del parametro fornito dall'utente viene completato aggiungendo il carattere zero finché la stringa non raggiunge il numero totale di caratteri.The following example template shows how to pad the user-provided parameter value by adding the zero character until it reaches the total number of characters.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "123"
        }
    },
    "resources": [],
    "outputs": {
        "stringOutput": {
            "type": "string",
            "value": "[padLeft(parameters('testString'),10,'0')]"
        }
    }
}

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 00000001230000000123

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

replacereplace

replace(originalString, oldString, newString)

Restituisce una nuova stringa con tutte le istanze di una stringa sostituita con un'altra stringa.Returns a new string with all instances of one string replaced by another string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
originalStringoriginalString Yes stringstring Valore che contiene tutte le istanze di una stringa sostituita con un'altra stringa.The value that has all instances of one string replaced by another string.
oldStringoldString Yes stringstring Stringa da rimuovere dalla stringa originale.The string to be removed from the original string.
newStringnewString Yes stringstring Stringa da aggiungere al posto della stringa rimossa.The string to add in place of the removed string.

Valore restituitoReturn value

Stringa con i caratteri sostituiti.A string with the replaced characters.

esempiExamples

Il modello di esempio seguente illustra come rimuovere tutti i trattini dalla stringa fornita dall'utente e come sostituire parte della stringa con un'altra stringa.The following example template shows how to remove all dashes from the user-provided string, and how to replace part of the string with another string.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "123-123-1234"
        }
    },
    "resources": [],
    "outputs": {
        "firstOutput": {
            "type": "string",
            "value": "[replace(parameters('testString'),'-', '')]"
        },
        "secodeOutput": {
            "type": "string",
            "value": "[replace(parameters('testString'),'1234', 'xxxx')]"
        }
    }
}

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
firstOutputfirstOutput StringString 12312312341231231234
secodeOutputsecodeOutput StringString 123-123-xxxx123-123-xxxx

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

skipskip

skip(originalValue, numberToSkip)

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

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.

esempiExamples

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

splitsplit

split(inputString, delimiter)

Restituisce una matrice di stringhe che contiene le sottostringhe della stringa di input delimitate dai delimitatori specificati.Returns an array of strings that contains the substrings of the input string that are delimited by the specified delimiters.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
inputStringinputString Yes stringstring Stringa da dividere.The string to split.
delimiterdelimiter Yes Stringa o matrice di stringhestring or array of strings Il delimitatore da usare per dividere la stringa.The delimiter to use for splitting the string.

Valore restituitoReturn value

Matrice di stringhe.An array of strings.

esempiExamples

Il modello di esempio seguente mostra come suddividere la stringa di input usando una virgola, oppure una virgola o un punto e virgola.The following example template splits the input string with a comma, and with either a comma or a semi-colon.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "firstString": {
            "type": "string",
            "defaultValue": "one,two,three"
        },
        "secondString": {
            "type": "string",
            "defaultValue": "one;two,three"
        }
    },
    "variables": {
        "delimiters": [ ",", ";" ]
    },
    "resources": [],
    "outputs": {
        "firstOutput": {
            "type": "array",
            "value": "[split(parameters('firstString'),',')]"
        },
        "secondOutput": {
            "type": "array",
            "value": "[split(parameters('secondString'),variables('delimiters'))]"
        }
    }
}

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
firstOutputfirstOutput ArrayArray ["one", "two", "three"]["one", "two", "three"]
secondOutputsecondOutput 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/split.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/split.json

startsWithstartsWith

startsWith(stringToSearch, stringToFind)

Determina se una stringa inizia con un valore.Determines whether a string starts with a value. Il confronto non fa distinzione tra maiuscole e minuscole.The comparison is case-insensitive.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToSearchstringToSearch Yes stringstring Valore che contiene l'elemento da cercare.The value that contains the item to find.
stringToFindstringToFind Yes stringstring Valore da trovare.The value to find.

Valore restituitoReturn value

True se il primo carattere o i caratteri della stringa corrispondono al valore; in caso contrario, restituisce False.True if the first character or characters of the string match the value; otherwise, False.

esempiExamples

Il modello di esempio seguente mostra come usare le funzioni startsWith ed endsWith:The following example template shows how to use the startsWith and endsWith functions:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "startsTrue": {
            "value": "[startsWith('abcdef', 'ab')]",
            "type" : "bool"
        },
        "startsCapTrue": {
            "value": "[startsWith('abcdef', 'A')]",
            "type" : "bool"
        },
        "startsFalse": {
            "value": "[startsWith('abcdef', 'e')]",
            "type" : "bool"
        },
        "endsTrue": {
            "value": "[endsWith('abcdef', 'ef')]",
            "type" : "bool"
        },
        "endsCapTrue": {
            "value": "[endsWith('abcdef', 'F')]",
            "type" : "bool"
        },
        "endsFalse": {
            "value": "[endsWith('abcdef', 'e')]",
            "type" : "bool"
        }
    }
}

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
startsTruestartsTrue BooleanoBool True True
startsCapTruestartsCapTrue BooleanoBool True True
startsFalsestartsFalse BooleanoBool FalseFalse
endsTrueendsTrue BooleanoBool True True
endsCapTrueendsCapTrue BooleanoBool True True
endsFalseendsFalse 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/startsendswith.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/startsendswith.json

stringstring

string(valueToConvert)

Converte il valore specificato in una stringa.Converts the specified value to a string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
valueToConvertvalueToConvert Yes QualsiasiAny Valore da convertire in stringa.The value to convert to string. È possibile convertire qualsiasi tipo di valore, inclusi gli oggetti e le matrici.Any type of value can be converted, including objects and arrays.

Valore restituitoReturn value

Stringa del valore convertito.A string of the converted value.

esempiExamples

Il modello di esempio seguente mostra come convertire diversi tipi di valori di stringa:The following example template shows how to convert different types of values to strings:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testObject": {
            "type": "object",
            "defaultValue": {
                "valueA": 10,
                "valueB": "Example Text"
            }
        },
        "testArray": {
            "type": "array",
            "defaultValue": [
                "a",
                "b",
                "c"
            ]
        },
        "testInt": {
            "type": "int",
            "defaultValue": 5
        }
    },
    "resources": [],
    "outputs": {
        "objectOutput": {
            "type": "string",
            "value": "[string(parameters('testObject'))]"
        },
        "arrayOutput": {
            "type": "string",
            "value": "[string(parameters('testArray'))]"
        },
        "intOutput": {
            "type": "string",
            "value": "[string(parameters('testInt'))]"
        }
    }
}

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 StringString {"valueA":10,"valueB":"Example Text"}{"valueA":10,"valueB":"Example Text"}
arrayOutputarrayOutput StringString ["a","b","c"]["a","b","c"]
intOutputintOutput StringString 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/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/string.json

substringsubstring

substring(stringToParse, startIndex, length)

Restituisce una sottostringa che inizia nella posizione del carattere specificato e contiene il numero di caratteri specificato.Returns a substring that starts at the specified character position and contains the specified number of characters.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToParsestringToParse Yes stringstring La stringa originale da cui estrarre la sottostringa.The original string from which the substring is extracted.
startIndexstartIndex NoNo intint La posizione del carattere iniziale in base zero della sottostringa.The zero-based starting character position for the substring.
lengthlength NoNo intint Il numero di caratteri della sottostringa.The number of characters for the substring. Deve fare riferimento a una posizione nella stringa.Must refer to a location within the string.

Valore restituitoReturn value

La sottostringa.The substring.

OsservazioniRemarks

La funzione ha esito negativo se la sottostringa si estende oltre la fine della stringa.The function fails when the substring extends beyond the end of the string. L'esempio seguente ha esito negativo e visualizza l'errore "I parametri index e length devono fare riferimento a una posizione all'interno della stringa.The following example fails with the error "The index and length parameters must refer to a location within the string. Parametro index: '0', parametro length: '11', lunghezza del parametro string: '10'.".The index parameter: '0', the length parameter: '11', the length of the string parameter: '10'.".

"parameters": {
    "inputString": { "type": "string", "value": "1234567890" }
},
"variables": { 
    "prefix": "[substring(parameters('inputString'), 0, 11)]"
}

esempiExamples

Il modello di esempio seguente estrae una sottostringa da un parametro.The following example template extracts a substring from a parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "one two three"
        }
    },
    "resources": [],
    "outputs": {
        "substringOutput": {
            "value": "[substring(parameters('testString'), 4, 3)]",
            "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
substringOutputsubstringOutput StringString twotwo

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

taketake

take(originalValue, numberToTake)

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

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.

esempiExamples

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

toLowertoLower

toLower(stringToChange)

Converte la stringa specificata in caratteri minuscoli.Converts the specified string to lower case.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToChangestringToChange Yes stringstring Il valore da convertire in lettere minuscole.The value to convert to lower case.

Valore restituitoReturn value

La stringa convertita in lettere minuscole.The string converted to lower case.

esempiExamples

Il modello di esempio seguente converte il valore del parametro in lettere maiuscole e minuscole.The following example template converts a parameter value to lower case and to upper case.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "One Two Three"
        }
    },
    "resources": [],
    "outputs": {
        "toLowerOutput": {
            "value": "[toLower(parameters('testString'))]",
            "type": "string"
        },
        "toUpperOutput": {
            "type": "string",
            "value": "[toUpper(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
toLowerOutputtoLowerOutput StringString one two threeone two three
toUpperOutputtoUpperOutput StringString ONE TWO THREEONE 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/tolower.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/tolower.json

toUppertoUpper

toUpper(stringToChange)

Converte la stringa specificata in lettere maiuscole.Converts the specified string to upper case.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToChangestringToChange Yes stringstring Il valore da convertire in lettere maiuscole.The value to convert to upper case.

Valore restituitoReturn value

La stringa convertita in lettere maiuscole.The string converted to upper case.

esempiExamples

Il modello di esempio seguente converte il valore del parametro in lettere maiuscole e minuscole.The following example template converts a parameter value to lower case and to upper case.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "One Two Three"
        }
    },
    "resources": [],
    "outputs": {
        "toLowerOutput": {
            "value": "[toLower(parameters('testString'))]",
            "type": "string"
        },
        "toUpperOutput": {
            "type": "string",
            "value": "[toUpper(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
toLowerOutputtoLowerOutput StringString one two threeone two three
toUpperOutputtoUpperOutput StringString ONE TWO THREEONE 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/tolower.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/tolower.json

Trimtrim

trim (stringToTrim)

Rimuove tutti i caratteri di spazi vuoti iniziali e finali dalla stringa specificata.Removes all leading and trailing white-space characters from the specified string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToTrimstringToTrim Yes stringstring Il valore da tagliare.The value to trim.

Valore restituitoReturn value

La stringa senza spazi vuoti iniziali e finali.The string without leading and trailing white-space characters.

esempiExamples

Il modello di esempio seguente elimina i caratteri spazi vuoti dal parametro.The following example template trims the white-space characters from the parameter.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "testString": {
            "type": "string",
            "defaultValue": "    one two three   "
        }
    },
    "resources": [],
    "outputs": {
        "return": {
            "type": "string",
            "value": "[trim(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
returnreturn StringString one two threeone 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/trim.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/trim.json

uniqueStringuniqueString

uniqueString (baseString, ...)

Crea una stringa hash deterministica in base ai valori forniti come parametri.Creates a deterministic hash string based on the values provided as parameters.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
baseStringbaseString Yes stringstring Il valore usato nella funzione hash per creare una stringa univoca.The value used in the hash function to create a unique string.
parametri aggiuntivi in base alle esigenzeadditional parameters as needed NoNo stringstring È possibile aggiungere tutte le stringhe necessarie per creare il valore che specifica il livello di univocità.You can add as many strings as needed to create the value that specifies the level of uniqueness.

OsservazioniRemarks

Questa funzione è utile quando è necessario creare un nome univoco per una risorsa.This function is helpful when you need to create a unique name for a resource. È possibile specificare i valori dei parametri che limitano l'ambito di univocità per il risultato.You provide parameter values that limit the scope of uniqueness for the result. È possibile specificare se il nome è univoco nella sottoscrizione, nel gruppo di risorse o nella distribuzione.You can specify whether the name is unique down to subscription, resource group, or deployment.

Il valore restituito non è una stringa casuale, ma il risultato di una funzione hash.The returned value is not a random string, but rather the result of a hash function. Il valore restituito ha una lunghezza di 13 caratteri.The returned value is 13 characters long. Non è globalmente univoco.It is not globally unique. È possibile combinare il valore con un prefisso dalla convenzione di denominazione scelta per creare un nome significativo.You may want to combine the value with a prefix from your naming convention to create a name that is meaningful. L'esempio seguente illustra il formato del valore restituito.The following example shows the format of the returned value. Il valore effettivo varia in base ai parametri forniti.The actual value varies by the provided parameters.

tcvhiyu5h2o5o

Gli esempi seguenti mostrano come usare uniqueString per creare un valore univoco per livelli di uso comune.The following examples show how to use uniqueString to create a unique value for commonly used levels.

Con ambito univoco nella sottoscrizioneUnique scoped to subscription

"[uniqueString(subscription().subscriptionId)]"

Con ambito univoco nel gruppo di risorseUnique scoped to resource group

"[uniqueString(resourceGroup().id)]"

Con ambito univoco nella distribuzione per un gruppo di risorseUnique scoped to deployment for a resource group

"[uniqueString(resourceGroup().id, deployment().name)]"

Nell'esempio seguente viene illustrato come creare un nome univoco per un account di archiviazione in base al gruppo di risorse.The following example shows how to create a unique name for a storage account based on your resource group. All'interno del gruppo di risorse, il nome non è univoco se costruito allo stesso modo.Inside the resource group, the name is not unique if constructed the same way.

"resources": [{ 
    "name": "[concat('storage', uniqueString(resourceGroup().id))]", 
    "type": "Microsoft.Storage/storageAccounts", 
    ...

Valore restituitoReturn value

Stringa contenente 13 caratteri.A string containing 13 characters.

esempiExamples

Il modello di esempio seguente restituisce risultati da uniqueString:The following example template returns results from uniquestring:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [],
    "outputs": {
        "uniqueRG": {
            "value": "[uniqueString(resourceGroup().id)]",
            "type" : "string"
        },
        "uniqueDeploy": {
            "value": "[uniqueString(resourceGroup().id, deployment().name)]",
            "type" : "string"
        }
    }
}

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

Uriuri

uri (baseUri, relativeUri)

Crea un URI assoluto combinando la baseUri e la stringa relativeUri.Creates an absolute URI by combining the baseUri and the relativeUri string.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
baseUribaseUri Yes stringstring La stringa URI di base.The base uri string.
relativeUrirelativeUri Yes stringstring La stringa URI relativa da aggiungere alla stringa di URI di base.The relative uri string to add to the base uri string.

Il valore per il parametro baseUri può includere un file specifico, ma solo il percorso di base viene usato per costruire l'URI.The value for the baseUri parameter can include a specific file, but only the base path is used when constructing the URI. Ad esempio, se si trasmette http://contoso.com/resources/azuredeploy.json come parametro baseUri, viene restituito l'URI di base http://contoso.com/resources/.For example, passing http://contoso.com/resources/azuredeploy.json as the baseUri parameter results in a base URI of http://contoso.com/resources/.

Valore restituitoReturn value

Stringa che rappresenta l'URI assoluto dei valori di base e relativi.A string representing the absolute URI for the base and relative values.

esempiExamples

Nell'esempio seguente viene illustrato come costruire un collegamento a un modello annidato in base al valore del modello padre.The following example shows how to construct a link to a nested template based on the value of the parent template.

"templateLink": "[uri(deployment().properties.templateLink.uri, 'nested/azuredeploy.json')]"

Il modello di esempio seguente mostra come usare uri, uriComponent e uriComponentToString:The following example template shows how to use uri, uriComponent, and uriComponentToString:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "variables": {
        "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
        "uriEncoded": "[uriComponent(variables('uriFormat'))]" 
    },
    "resources": [
    ],
    "outputs": {
        "uriOutput": {
            "type": "string",
            "value": "[variables('uriFormat')]"
        },
        "componentOutput": {
            "type": "string",
            "value": "[variables('uriEncoded')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[uriComponentToString(variables('uriEncoded'))]"
        }
    }
}

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
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput StringString http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.jsonhttp%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutputtoStringOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json

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

uriComponenturiComponent

uricomponent(stringToEncode)

Codifica un URI.Encodes a URI.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
stringToEncodestringToEncode Yes stringstring Valore da codificare.The value to encode.

Valore restituitoReturn value

Stringa del valore URI codificato.A string of the URI encoded value.

esempiExamples

Il modello di esempio seguente mostra come usare uri, uriComponent e uriComponentToString:The following example template shows how to use uri, uriComponent, and uriComponentToString:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "variables": {
        "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
        "uriEncoded": "[uriComponent(variables('uriFormat'))]" 
    },
    "resources": [
    ],
    "outputs": {
        "uriOutput": {
            "type": "string",
            "value": "[variables('uriFormat')]"
        },
        "componentOutput": {
            "type": "string",
            "value": "[variables('uriEncoded')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[uriComponentToString(variables('uriEncoded'))]"
        }
    }
}

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
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput StringString http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.jsonhttp%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutputtoStringOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json

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

uriComponentToStringuriComponentToString

uriComponentToString(uriEncodedString)

Restituisce una stringa di un valore URI codificato.Returns a string of a URI encoded value.

ParametriParameters

ParametroParameter ObbligatorioRequired TipoType DescrizioneDescription
uriEncodedStringuriEncodedString Yes stringstring Valore URI codificato da convertire in stringa.The URI encoded value to convert to a string.

Valore restituitoReturn value

Stringa decodificata del valore URI codificato.A decoded string of URI encoded value.

esempiExamples

Il modello di esempio seguente mostra come usare uri, uriComponent e uriComponentToString:The following example template shows how to use uri, uriComponent, and uriComponentToString:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "variables": {
        "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
        "uriEncoded": "[uriComponent(variables('uriFormat'))]" 
    },
    "resources": [
    ],
    "outputs": {
        "uriOutput": {
            "type": "string",
            "value": "[variables('uriFormat')]"
        },
        "componentOutput": {
            "type": "string",
            "value": "[variables('uriEncoded')]"
        },
        "toStringOutput": {
            "type": "string",
            "value": "[uriComponentToString(variables('uriEncoded'))]"
        }
    }
}

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
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput StringString http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.jsonhttp%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json
toStringOutputtoStringOutput StringString http://contoso.com/resources/nested/azuredeploy.jsonhttp://contoso.com/resources/nested/azuredeploy.json

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

Passaggi successiviNext steps