Azure Resource Manager 템플릿용 문자열 함수String functions for Azure Resource Manager templates

Resource Manager는 문자열 작업을 위한 다음 함수를 제공합니다.Resource Manager provides the following functions for working with strings:

base64base64

base64(inputString)

입력 문자열의 base64 표현을 반환합니다.Returns the base64 representation of the input string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
inputStringinputString Yes stringstring base64 표현으로 반환할 값입니다.The value to return as a base64 representation.

반환 값Return value

Base64 표현을 포함하는 문자열입니다.A string containing the base64 representation.

Examples

다음 예제 템플릿에서는 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
base64Outputbase64Output 문자열String b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput 문자열String one, two, threeone, two, three
toJsonOutputtoJsonOutput ObjectObject {“one”: “a”, “two”: “b”}{"one": "a", "two": "b"}

base64ToJsonbase64ToJson

base64tojson

base64 표현을 JSON 개체로 변환합니다.Converts a base64 representation to a JSON object.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
base64Valuebase64Value Yes stringstring JSON 개체로 변환할 base64 표현입니다.The base64 representation to convert to a JSON object.

반환 값Return value

JSON 개체입니다.A JSON object.

Examples

다음 예제 템플릿에서는 base64ToJson 함수를 사용하여 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
base64Outputbase64Output 문자열String b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput 문자열String one, two, threeone, two, three
toJsonOutputtoJsonOutput ObjectObject {“one”: “a”, “two”: “b”}{"one": "a", "two": "b"}

base64ToStringbase64ToString

base64ToString(base64Value)

base64 표현을 문자열로 변환합니다.Converts a base64 representation to a string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
base64Valuebase64Value Yes stringstring 문자열로 변환할 base64 표현입니다.The base64 representation to convert to a string.

반환 값Return value

변환된 base64 값의 문자열입니다.A string of the converted base64 value.

Examples

다음 예제 템플릿에서는 base64ToString 함수를 사용하여 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
base64Outputbase64Output 문자열String b25lLCB0d28sIHRocmVlb25lLCB0d28sIHRocmVl
toStringOutputtoStringOutput 문자열String one, two, threeone, two, three
toJsonOutputtoJsonOutput ObjectObject {“one”: “a”, “two”: “b”}{"one": "a", "two": "b"}

concatconcat

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

여러 문자열 값을 결합하고 연결된 문자열을 반환하거나 여러 배열을 결합하고 연결된 배열을 반환합니다.Combines multiple string values and returns the concatenated string, or combines multiple arrays and returns the concatenated array.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
arg1arg1 Yes 문자열 또는 배열string or array 연결할 첫 번째 값입니다.The first value for concatenation.
추가 인수additional arguments 아니요No stringstring 연결할 추가 값(순서대로)입니다.Additional values in sequential order for concatenation.

반환 값Return value

연결된 값의 문자열 또는 배열입니다.A string or array of concatenated values.

Examples

다음 예제 템플릿에서는 2개의 문자열 값을 결합하고 연결된 문자열을 반환하는 방법을 보여줍니다.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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
concatOutputconcatOutput 문자열String prefix-5yj4yjf5mbg72prefix-5yj4yjf5mbg72

다음 예제 템플릿에서는 두 개의 배열을 결합하는 방법을 보여줍니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
returnreturn 배열Array ["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]

containscontains

contains (container, itemToFind)

배열에 값이 포함되는지, 개체에 키가 포함되는지 또는 문자열에 하위 문자열이 포함되는지를 확인합니다.Checks whether an array contains a value, an object contains a key, or a string contains a substring. 문자열 비교에서는 대/소문자를 구분합니다.The string comparison is case-sensitive. 그러나 개체에 키가 포함되어 있는지를 테스트할 때는 비교에서 대/소문자를 구분하지 않습니다.However, when testing if an object contains a key, the comparison is case-insensitive.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
containercontainer Yes 배열, 개체 또는 문자열array, object, or string 찾을 값을 포함하는 값입니다.The value that contains the value to find.
itemToFinditemToFind Yes 문자열 또는 intstring or int 찾을 값입니다.The value to find.

반환 값Return value

항목이 있으면 True이고, 항목이 없으면 False입니다.True if the item is found; otherwise, False.

Examples

다음 예제 템플릿에서는 여러 다른 형식의 contains를 사용하는 방법을 보여줍니다.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')]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
stringTruestringTrue BoolBool TrueTrue
stringFalsestringFalse BoolBool FalseFalse
objectTrueobjectTrue BoolBool TrueTrue
objectFalseobjectFalse BoolBool FalseFalse
arrayTruearrayTrue BoolBool TrueTrue
arrayFalsearrayFalse BoolBool 거짓False

dataUridataUri

dataUri(stringToConvert)

값을 데이터 URI로 변환합니다.Converts a value to a data URI.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToConvertstringToConvert Yes stringstring 데이터 URI로 변환할 값입니다.The value to convert to a data URI.

반환 값Return value

데이터 URI로 형식이 지정된 문자열입니다.A string formatted as a data URI.

Examples

다음 예제 템플릿에서는 값을 데이터 URI로 변환하고 데이터 URI를 문자열로 변환합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
dataUriOutputdataUriOutput 문자열String data:text/plain;charset=utf8;base64,SGVsbG8=data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutputtoStringOutput 문자열String Hello, World!Hello, World!

dataUriToStringdataUriToString

dataUriToString(dataUriToConvert)

데이터 URI로 형식이 지정된 값을 문자열로 변환합니다.Converts a data URI formatted value to a string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
dataUriToConvertdataUriToConvert Yes stringstring 변환할 데이터 URI 값입니다.The data URI value to convert.

반환 값Return value

변환된 값을 포함하는 문자열입니다.A string containing the converted value.

Examples

다음 예제 템플릿에서는 값을 데이터 URI로 변환하고 데이터 URI를 문자열로 변환합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
dataUriOutputdataUriOutput 문자열String data:text/plain;charset=utf8;base64,SGVsbG8=data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutputtoStringOutput 문자열String Hello, World!Hello, World!

emptyempty

empty(itemToTest)

배열, 개체 또는 문자열이 비어 있는지를 확인합니다.Determines if an array, object, or string is empty.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
itemToTestitemToTest Yes 배열, 개체 또는 문자열array, object, or string 비어 있는지 확인할 값입니다.The value to check if it's empty.

반환 값Return value

값이 비어 있으면 True를 반환하고 비어 있지 않으면 False를 반환합니다.Returns True if the value is empty; otherwise, False.

Examples

다음 예제 템플릿에서는 배열, 개체 및 문자열이 비어 있는지 여부를 확인합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayEmptyarrayEmpty BoolBool TrueTrue
objectEmptyobjectEmpty BoolBool TrueTrue
stringEmptystringEmpty BoolBool True True

endsWithendsWith

endsWith(stringToSearch, stringToFind)

문자열이 값으로 끝나는지 여부를 결정합니다.Determines whether a string ends with a value. 비교는 대/소문자를 구분합니다.The comparison is case-insensitive.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToSearchstringToSearch Yes stringstring 찾을 값을 포함하는 값입니다.The value that contains the item to find.
stringToFindstringToFind Yes stringstring 찾을 값입니다.The value to find.

반환 값Return value

마지막 문자 또는 문자열의 문자가 값과 일치하면 True이고, 일치하지 않으면 False입니다.True if the last character or characters of the string match the value; otherwise, False.

Examples

다음 예제 템플릿에서는 startsWith 및 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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
startsTruestartsTrue BoolBool TrueTrue
startsCapTruestartsCapTrue BoolBool TrueTrue
startsFalsestartsFalse BoolBool FalseFalse
endsTrueendsTrue BoolBool TrueTrue
endsCapTrueendsCapTrue BoolBool TrueTrue
endsFalseendsFalse BoolBool 거짓False

firstfirst

first(arg1)

문자열의 첫 번째 문자 또는 배열의 첫 번째 요소를 반환합니다.Returns the first character of the string, or first element of the array.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
arg1arg1 Yes 배열 또는 문자열array or string 첫 번째 요소 또는 문자를 검색할 값입니다.The value to retrieve the first element or character.

반환 값Return value

배열의 첫 번째 문자의 문자열 또는 첫 번째 요소의 형식(문자열, int, 배열 또는 개체)입니다.A string of the first character, or the type (string, int, array, or object) of the first element in an array.

Examples

다음 예제 템플릿에서는 배열 및 문자열에 첫 번째 함수를 사용하는 방법을 보여줍니다.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')]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayOutputarrayOutput 문자열String oneone
stringOutputstringOutput 문자열String OO

formatformat

format(formatString, arg1, arg2, ...)

입력된 값의 서식이 지정 된 문자열을 만듭니다.Creates a formatted string from input values.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
formatStringformatString Yes 문자열string 합성 형식 문자열입니다.The composite format string.
arg1arg1 Yes 문자열, 정수 또는 부울string, integer, or boolean 서식이 지정 된 문자열에 포함할 값입니다.The value to include in the formatted string.
추가 인수additional arguments 아닙니다.No 문자열, 정수 또는 부울string, integer, or boolean 서식이 지정 된 문자열에 포함할 추가 값입니다.Additional values to include in the formatted string.

설명Remarks

이 함수를 사용 하 여 템플릿에서 문자열의 형식을 지정 합니다.Use this function to format a string in your template. 동일한 서식 지정 옵션을 사용 합니다 System.String.Format .net에서 메서드.It uses the same formatting options as the System.String.Format method in .NET.

Examples

다음 예제 템플릿은 format 함수를 사용 하는 방법을 보여 줍니다.The following example template shows how to use the format function.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "greeting": {
            "type": "string",
            "defaultValue": "Hello"
        },
        "name": {
            "type": "string",
            "defaultValue": "User"
        },
        "numberToFormat": {
            "type": "int",
            "defaultValue": 8175133
        }
    },
    "resources": [
    ],
    "outputs": {
        "formatTest": {
            "type": "string",
            "value": "[format('{0}, {1}. Formatted number: {2:N0}', parameters('greeting'), parameters('name'), parameters('numberToFormat'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
formatTestformatTest StringString Hello, 사용자입니다.Hello, User. 서식이 지정 된 수: 8,175,133Formatted number: 8,175,133

GUIDguid

guid(baseString, ...)

매개 변수로 제공된 값을 기반으로 전역 고유 식별자 형식으로 값을 만듭니다.Creates a value in the format of a globally unique identifier based on the values provided as parameters.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
baseStringbaseString Yes stringstring 해시 함수에서 GUID를 만드는 데 사용되는 값입니다.The value used in the hash function to create the GUID.
필요에 따라 추가하는 매개 변수additional parameters as needed 아니요No stringstring 고유성 수준을 지정하는 값을 만들기 위해 필요한 만큼 문자열을 추가할 수 있습니다.You can add as many strings as needed to create the value that specifies the level of uniqueness.

설명Remarks

이 함수는 전역 고유 식별자 형식으로 값을 만들어야 할 때 유용합니다.This function is helpful when you need to create a value in the format of a globally unique identifier. 결과의 고유성 범위를 제한하는 매개 변수 값을 제공합니다.You provide parameter values that limit the scope of uniqueness for the result. 구독, 리소스 그룹 또는 배포까지 해당 이름이 고유한지 여부를 지정할 수 있습니다.You can specify whether the name is unique down to subscription, resource group, or deployment.

임의 문자열 이지만 매개 변수에 대 한 해시 함수의 결과 대신 반환된 값이 아닙니다.The returned value isn't a random string, but rather the result of a hash function on the parameters. 반환된 값은 36자입니다.The returned value is 36 characters long. 전역적으로 고유 하지 않습니다.It isn't globally unique. 매개 변수를 해시 값에 기반 하지 않는 새 GUID를 만들려면 사용 합니다 newGuid 함수입니다.To create a new GUID that isn't based on that hash value of the parameters, use the newGuid function.

다음 예제에서는 guid를 사용하여 일반적으로 사용하는 수준에 대해 고유한 값을 만드는 방법을 보여 줍니다.The following examples show how to use guid to create a unique value for commonly used levels.

구독에 범위가 지정된 고유함Unique scoped to subscription

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

리소스 그룹에 범위가 지정된 고유함Unique scoped to resource group

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

리소스 그룹의 배포에 범위가 지정된 고유함Unique scoped to deployment for a resource group

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

반환 값Return value

전 세계적으로 고유한 식별자의 형식으로 된 36자를 포함하는 문자열입니다.A string containing 36 characters in the format of a globally unique identifier.

Examples

다음 예제 템플릿은 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"
        }
    }
}

indexofindexOf

indexOf(stringToSearch, stringToFind)

문자열 내 값의 첫 번째 위치를 반환합니다.Returns the first position of a value within a string. 비교는 대/소문자를 구분합니다.The comparison is case-insensitive.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToSearchstringToSearch Yes stringstring 찾을 값을 포함하는 값입니다.The value that contains the item to find.
stringToFindstringToFind Yes stringstring 찾을 값입니다.The value to find.

반환 값Return value

찾을 항목의 위치를 나타내는 정수입니다.An integer that represents the position of the item to find. 값은 0부터 시작합니다.The value is zero-based. 항목을 찾을 수 없으면-1이 반환 됩니다.If the item isn't found, -1 is returned.

Examples

다음 예제 템플릿에서는 indexOf 및 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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
firstTfirstT intInt 00
lastTlastT intInt 33
firstStringfirstString intInt 22
lastStringlastString intInt 00
notFoundnotFound intInt -1-1

lastlast

last (arg1)

문자열의 마지막 문자 또는 배열의 마지막 요소를 반환합니다.Returns last character of the string, or the last element of the array.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
arg1arg1 Yes 배열 또는 문자열array or string 마지막 요소 또는 문자를 검색할 값입니다.The value to retrieve the last element or character.

반환 값Return value

배열의 마지막 문자의 문자열 또는 마지막 요소의 형식(문자열, int, 배열 또는 개체)입니다.A string of the last character, or the type (string, int, array, or object) of the last element in an array.

Examples

다음 예제 템플릿에서는 배열 및 문자열에 최근 함수를 사용하는 방법을 보여줍니다.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')]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayOutputarrayOutput 문자열String threethree
stringOutputstringOutput 문자열String ee

lastindexoflastIndexOf

lastIndexOf(stringToSearch, stringToFind)

문자열 내 값의 마지막 위치를 반환합니다.Returns the last position of a value within a string. 비교는 대/소문자를 구분합니다.The comparison is case-insensitive.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToSearchstringToSearch Yes stringstring 찾을 값을 포함하는 값입니다.The value that contains the item to find.
stringToFindstringToFind Yes stringstring 찾을 값입니다.The value to find.

반환 값Return value

찾을 항목의 마지막 위치를 나타내는 정수입니다.An integer that represents the last position of the item to find. 값은 0부터 시작합니다.The value is zero-based. 항목을 찾을 수 없으면-1이 반환 됩니다.If the item isn't found, -1 is returned.

Examples

다음 예제 템플릿에서는 indexOf 및 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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
firstTfirstT intInt 00
lastTlastT intInt 33
firstStringfirstString intInt 22
lastStringlastString intInt 00
notFoundnotFound intInt -1-1

lengthlength

length(string)

문자열의 문자 수 또는 배열의 요소 수를 반환합니다.Returns the number of characters in a string, or elements in an array.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
arg1arg1 Yes 배열 또는 문자열array or string 요소 수를 가져오는 데 사용할 배열 또는 문자 수를 가져오는 데 사용할 문자열입니다.The array to use for getting the number of elements, or the string to use for getting the number of characters.

반환 값Return value

int입니다.An int.

Examples

다음 예제 템플릿에서는 배열 및 문자열에 length를 사용하는 방법을 보여줍니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayLengtharrayLength intInt 33
stringLengthstringLength intInt 1313

newGuidnewGuid

newGuid()

전역적으로 고유 식별자 형식의 값을 반환 합니다.Returns a value in the format of a globally unique identifier. 이 함수는 매개 변수에 대 한 기본값인 에서만 사용 수 있습니다.This function can only be used in the default value for a parameter.

설명Remarks

매개 변수의 기본값만 식 내에서이 함수를 사용할 수 있습니다.You can only use this function within an expression for the default value of a parameter. 템플릿에서 다른 곳에이 함수를 사용 하 여 오류를 반환 합니다.Using this function anywhere else in a template returns an error. 함수를 호출할 때마다 다른 값을 반환 하기 때문에 템플릿의 다른 부분에서 허용 되지 않습니다.The function isn't allowed in other parts of the template because it returns a different value each time it's called. 동일한 매개 변수를 사용 하 여 동일한 템플릿에 배포 같은 결과 안정적으로 생성 하지 않습니다.Deploying the same template with the same parameters wouldn't reliably produce the same results.

NewGuid 함수에서 다른 합니다 guid 매개 변수를 사용 하지 때문에 작동 합니다.The newGuid function differs from the guid function because it doesn't take any parameters. 동일한 매개 변수를 사용 하 여 guid를 호출할 때마다 동일한 식별자를 반환 됩니다.When you call guid with the same parameter, it returns the same identifier each time. 특정 환경에 동일한 GUID를 안정적으로 생성 해야 하는 경우에 guid를 사용 합니다.Use guid when you need to reliably generate the same GUID for a specific environment. 매번 테스트 환경에 리소스 배포와 같은 다른 식별자가 필요한 경우 newGuid를 사용 합니다.Use newGuid when you need a different identifier each time, such as deploying resources to a test environment.

사용 하는 경우는 이전 성공적인 배포를 다시 배포 하는 옵션, newGuid를 사용 하는 매개 변수를 포함 하는 이전 배포를 매개 변수 다시 평가 되지 않습니다.If you use the option to redeploy an earlier successful deployment, and the earlier deployment includes a parameter that uses newGuid, the parameter isn't reevaluated. 대신 이전 배포에서 매개 변수 값을 롤백 배포에서 자동으로 재사용 됩니다.Instead, the parameter value from the earlier deployment is automatically reused in the rollback deployment.

테스트 환경에서 반복적으로 짧은 시간 동안에 존재 하는 리소스를 배포 해야 할 수 있습니다.In a test environment, you may need to repeatedly deploy resources that only live for a short time. 고유한 이름을 생성 하는 대신 사용 하 여 newGuid를 사용할 수 있습니다 uniqueString 고유 이름을 만듭니다.Rather than constructing unique names, you can use newGuid with uniqueString to create unique names.

기본값에 대 한 newGuid 함수에 의존 하는 템플릿을 다시 배포 주의 해야 합니다.Be careful redeploying a template that relies on the newGuid function for a default value. 다시 배포 하 고 매개 변수 값을 제공 하지는 다시 평가 됩니다.When you redeploy and don't provide a value for the parameter, the function is reevaluated. 새로 만들어야 하는 것이 아니라 기존 리소스를 업데이트 하려는 경우 이전 배포에서 매개 변수 값에 전달 합니다.If you want to update an existing resource rather than create a new one, pass in the parameter value from the earlier deployment.

반환 값Return value

전 세계적으로 고유한 식별자의 형식으로 된 36자를 포함하는 문자열입니다.A string containing 36 characters in the format of a globally unique identifier.

Examples

다음 예제 템플릿은 새 식별자를 사용 하 여 매개 변수를 표시 합니다.The following example template shows a parameter with a new identifier.

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

출력 앞의 예제에서 각 배포에 대 한 다르지만 비슷합니다.The output from the preceding example varies for each deployment but will be similar to:

이름Name typeType Value
guidOutputguidOutput 문자열string b76a51fc-bd72-4a77-b9a2-3c29e7d2e551b76a51fc-bd72-4a77-b9a2-3c29e7d2e551

다음 예제에서는 저장소 계정에 대 한 고유한 이름을 만들기 위해 newGuid 함수를 사용 합니다.The following example uses the newGuid function to create a unique name for a storage account. 이 템플릿은 저장소 계정 짧은 시간 동안 존재 및 다시 배포 하지는 테스트 환경용 적합할 수 있습니다.This template might work for test environment where the storage account exists for a short time and isn't redeployed.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "guidValue": {
            "type": "string",
            "defaultValue": "[newGuid()]"
        }
    },
    "variables": {
        "storageName": "[concat('storage', uniqueString(parameters('guidValue')))]"
    },
    "resources": [
        {
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[variables('storageName')]",
            "location": "West US",
            "apiVersion": "2018-07-01",
            "sku":{
                "name": "Standard_LRS"
            },
            "kind": "StorageV2",
            "properties": {}
        }
    ],
    "outputs": {
        "nameOutput": {
            "type": "string",
            "value": "[variables('storageName')]"
        }
    }
}

출력 앞의 예제에서 각 배포에 대 한 다르지만 비슷합니다.The output from the preceding example varies for each deployment but will be similar to:

이름Name typeType Value
nameOutputnameOutput 문자열string storagenziwvyru7uxiestoragenziwvyru7uxie

padLeftpadLeft

padLeft(valueToPad, totalLength, paddingCharacter)

지정된 총 길이에 도달할 때까지 왼쪽에 문자를 추가하여 오른쪽 맞추어진 문자열을 반환합니다.Returns a right-aligned string by adding characters to the left until reaching the total specified length.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
valueToPadvalueToPad Yes 문자열 또는 intstring or int 오른쪽으로 맞출 값입니다.The value to right-align.
totalLengthtotalLength Yes intint 반환된 문자열에서 문자의 총수입니다.The total number of characters in the returned string.
paddingCharacterpaddingCharacter 아니요No 단일 문자single character 총 길이에 도달할 때까지 왼쪽 여백에 사용되는 문자입니다.The character to use for left-padding until the total length is reached. 기본값은 공백입니다.The default value is a space.

원래 문자열이 채울 문자 수보다 긴 경우 문자가 추가되지 않습니다.If the original string is longer than the number of characters to pad, no characters are added.

반환 값Return value

최소한 지정된 문자의 수를 포함하는 문자열입니다.A string with at least the number of specified characters.

Examples

다음 예제 템플릿에서는 문자열이 총 문자 수에 도달할 때까지 0 문자를 추가하여 사용자가 제공한 매개 변수 값을 채우는 방법을 보여줍니다.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')]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
stringOutputstringOutput 문자열String 00000001230000000123

바꾸기replace

replace(originalString, oldString, newString)

다른 문자열로 대체한 어떤 문자열의 인스턴스를 포함한 새 문자열을 반환합니다.Returns a new string with all instances of one string replaced by another string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
originalStringoriginalString Yes stringstring 다른 문자열로 대체한 어떤 문자열의 인스턴스를 포함하는 값입니다.The value that has all instances of one string replaced by another string.
oldStringoldString Yes stringstring 원래 문자열에서 제거할 문자열입니다.The string to be removed from the original string.
newStringnewString Yes stringstring 제거된 문자열 대신 추가할 문자열입니다.The string to add in place of the removed string.

반환 값Return value

문자가 대체된 문자열입니다.A string with the replaced characters.

Examples

다음 예제 템플릿에서는 사용자가 제공한 문자열에서 모든 대시를 제거하는 방법 및 문자열의 일부를 다른 문자열로 대체하는 방법을 보여줍니다.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')]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
firstOutputfirstOutput 문자열String 12312312341231231234
secodeOutputsecodeOutput 문자열String 123-123-xxxx123-123-xxxx

skipskip

skip(originalValue, numberToSkip)

지정된 문자 수 이후의 모든 문자를 포함하는 문자열 또는 지정된 요소 수 이후의 모든 요소를 포함하는 배열을 반환합니다.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.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
originalValueoriginalValue Yes 배열 또는 문자열array or string 건너뛰는 데 사용할 배열 또는 문자열입니다.The array or string to use for skipping.
numberToSkipnumberToSkip Yes intint 건너뛸 요소 또는 문자 수입니다.The number of elements or characters to skip. 이 값이 0 이하이면 값의 모든 요소 또는 문자가 반환됩니다.If this value is 0 or less, all the elements or characters in the value are returned. 배열 또는 문자열의 길이 보다 클 경우 빈 배열 또는 문자열이 반환 됩니다.If it's larger than the length of the array or string, an empty array or string is returned.

반환 값Return value

배열 또는 문자열입니다.An array or string.

Examples

다음 예제 템플릿에서는 배열에서 지정된 요소 수 및 문자열에서 지정된 수의 문자를 건너뜁니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayOutputarrayOutput 배열Array ["three"]["three"]
stringOutputstringOutput 문자열String two threetwo three

splitsplit

split(inputString, delimiter)

지정된 구분 기호로 구분되는 입력 문자열의 부분 문자열을 포함하는 문자열의 배열을 반환합니다.Returns an array of strings that contains the substrings of the input string that are delimited by the specified delimiters.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
inputStringinputString Yes stringstring 분할할 문자열입니다.The string to split.
구분 기호delimiter Yes 문자열 또는 문자열 배열string or array of strings 문자열 분할에 사용할 구분 기호입니다.The delimiter to use for splitting the string.

반환 값Return value

문자열 배열입니다.An array of strings.

Examples

다음 예제 템플릿에서는 쉼표를 사용하여 또는 쉼표 또는 세미콜론을 사용하여 입력 문자열을 분할합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
firstOutputfirstOutput 배열Array [“one”, “two”, “three”]["one", "two", "three"]
secondOutputsecondOutput 배열Array [“one”, “two”, “three”]["one", "two", "three"]

startswithstartsWith

startsWith(stringToSearch, stringToFind)

문자열이 값으로 시작하는지 여부를 결정합니다.Determines whether a string starts with a value. 비교는 대/소문자를 구분합니다.The comparison is case-insensitive.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToSearchstringToSearch Yes stringstring 찾을 값을 포함하는 값입니다.The value that contains the item to find.
stringToFindstringToFind Yes stringstring 찾을 값입니다.The value to find.

반환 값Return value

첫 번째 문자 또는 문자열의 문자가 값과 일치하면 True이고, 일치하지 않으면 False입니다.True if the first character or characters of the string match the value; otherwise, False.

Examples

다음 예제 템플릿에서는 startsWith 및 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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
startsTruestartsTrue BoolBool TrueTrue
startsCapTruestartsCapTrue BoolBool TrueTrue
startsFalsestartsFalse BoolBool FalseFalse
endsTrueendsTrue BoolBool TrueTrue
endsCapTrueendsCapTrue BoolBool TrueTrue
endsFalseendsFalse BoolBool 거짓False

문자열string

string(valueToConvert)

지정된 값을 문자열로 변환합니다.Converts the specified value to a string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
valueToConvertvalueToConvert Yes 모두Any 문자열로 변환할 값입니다.The value to convert to string. 개체 및 배열을 비롯하여 모든 값 형식을 변환할 수 있습니다.Any type of value can be converted, including objects and arrays.

반환 값Return value

변환된 값의 문자열입니다.A string of the converted value.

Examples

다음 예제 템플릿에서는 다른 형식의 값을 문자열로 변환하는 방법을 보여 줍니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
objectOutputobjectOutput 문자열String {“valueA”:10,“valueB”:“Example Text”}{"valueA":10,"valueB":"Example Text"}
arrayOutputarrayOutput 문자열String [“a”,“b”,“c”]["a","b","c"]
intOutputintOutput 문자열String 55

substringsubstring

substring(stringToParse, startIndex, length)

지정된 문자 위치에서 시작하고 지정한 개수의 문자를 포함하는 부분 문자열을 반환합니다.Returns a substring that starts at the specified character position and contains the specified number of characters.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToParsestringToParse Yes stringstring 부분 문자열을 추출할 원래 문자열입니다.The original string from which the substring is extracted.
startIndexstartIndex 아니요No intint 부분 문자열의 0부터 시작하는 문자 위치입니다.The zero-based starting character position for the substring.
lengthlength 아니요No intint 부분 문자열에 대한 문자 수입니다.The number of characters for the substring. 문자열 내 위치를 참조해야 합니다.Must refer to a location within the string. 0 이상이어야 합니다.Must be zero or greater.

반환 값Return value

하위 문자열입니다.The substring. 또는 길이가 0인 경우 빈 문자열입니다.Or, an empty string if the length is zero.

설명Remarks

함수는 부분 문자열이 문자열의 끝을 넘어 확장되거나 길이가 0보다 작은 경우 실패합니다.The function fails when the substring extends beyond the end of the string, or when length is less than zero. 다음 예제는 "인덱스 및 길이 매개 변수는 문자열 내 위치를 참조해야 합니다.The following example fails with the error "The index and length parameters must refer to a location within the string. 인덱스 매개 변수: '0', 길이 매개 변수: '11', 문자열 매개 변수의 길이: '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)]"
}

Examples

다음 예제 템플릿에서는 매개 변수에서 하위 문자열을 추출합니다.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"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
substringOutputsubstringOutput 문자열String twotwo

taketake

take(originalValue, numberToTake)

문자열 시작부터 지정된 수의 문자를 포함하는 문자열 또는 배열 시작부터 지정된 수의 요소를 포함하는 배열을 반환합니다.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.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
originalValueoriginalValue Yes 배열 또는 문자열array or string 요소를 가져올 배열 또는 문자열입니다.The array or string to take the elements from.
numberToTakenumberToTake Yes intint 수락할 요소 또는 문자의 수입니다.The number of elements or characters to take. 이 값이 0 이하이면 빈 배열 또는 문자열이 반환됩니다.If this value is 0 or less, an empty array or string is returned. 지정 된 배열 또는 문자열의 길이 보다 큰 경우에 배열 또는 문자열의 모든 요소가 반환 됩니다.If it's larger than the length of the given array or string, all the elements in the array or string are returned.

반환 값Return value

배열 또는 문자열입니다.An array or string.

Examples

다음 예제 템플릿에서는 배열에서 지정된 수의 요소 및 문자열의 문자를 가져옵니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
arrayOutputarrayOutput 배열Array ["one", "two"]["one", "two"]
stringOutputstringOutput 문자열String onon

toLowertoLower

toLower(stringToChange)

지정된 문자열을 소문자로 변환합니다.Converts the specified string to lower case.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToChangestringToChange Yes stringstring 소문자로 변환할 값입니다.The value to convert to lower case.

반환 값Return value

소문자로 변환된 문자열입니다.The string converted to lower case.

Examples

다음 예제 템플릿에서는 매개 변수 값을 소문자 및 대문자로 변환합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
toLowerOutputtoLowerOutput 문자열String one two threeone two three
toUpperOutputtoUpperOutput 문자열String ONE TWO THREEONE TWO THREE

toUppertoUpper

toUpper(stringToChange)

지정된 문자열을 대문자로 변환합니다.Converts the specified string to upper case.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToChangestringToChange Yes stringstring 대문자로 변환할 값입니다.The value to convert to upper case.

반환 값Return value

대문자로 변환된 문자열입니다.The string converted to upper case.

Examples

다음 예제 템플릿에서는 매개 변수 값을 소문자 및 대문자로 변환합니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
toLowerOutputtoLowerOutput 문자열String one two threeone two three
toUpperOutputtoUpperOutput 문자열String ONE TWO THREEONE TWO THREE

trimtrim

trim (stringToTrim)

지정된 문자열에서 모든 선행 및 후행 공백 문자를 제거합니다.Removes all leading and trailing white-space characters from the specified string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToTrimstringToTrim Yes stringstring 자를 값입니다.The value to trim.

반환 값Return value

선행 및 후행 공백 문자가 없는 문자열입니다.The string without leading and trailing white-space characters.

Examples

다음 예제 템플릿에서는 매개 변수에서 공백 문자를 자릅니다.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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
returnreturn 문자열String one two threeone two three

uniqueStringuniqueString

uniqueString (baseString, ...)

매개 변수로 제공된 값을 기반으로 결정 해시 문자열을 만듭니다.Creates a deterministic hash string based on the values provided as parameters.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
baseStringbaseString Yes stringstring 고유한 문자열을 만들기 위해 해시 함수에서 사용되는 값입니다.The value used in the hash function to create a unique string.
필요에 따라 추가하는 매개 변수additional parameters as needed 아니요No stringstring 고유성 수준을 지정하는 값을 만들기 위해 필요한 만큼 문자열을 추가할 수 있습니다.You can add as many strings as needed to create the value that specifies the level of uniqueness.

설명Remarks

이 함수는 리소스의 고유한 이름을 만들어야 할 때 유용합니다.This function is helpful when you need to create a unique name for a resource. 결과의 고유성 범위를 제한하는 매개 변수 값을 제공합니다.You provide parameter values that limit the scope of uniqueness for the result. 구독, 리소스 그룹 또는 배포까지 해당 이름이 고유한지 여부를 지정할 수 있습니다.You can specify whether the name is unique down to subscription, resource group, or deployment.

임의 문자열 이지만 해시 함수의 결과 대신 반환된 값이 아닙니다.The returned value isn't a random string, but rather the result of a hash function. 반환된 값은 13자입니다.The returned value is 13 characters long. 전역적으로 고유 하지 않습니다.It isn't globally unique. 의미있는 이름을 만들기 위해 해당 값과 명명 규칙의 접두사를 결합할 수도 있습니다.You may want to combine the value with a prefix from your naming convention to create a name that is meaningful. 다음 예제에서는 반환된 값의 형식을 보여 줍니다.The following example shows the format of the returned value. 실제 값은 제공된 매개 변수에 따라 달라집니다.The actual value varies by the provided parameters.

tcvhiyu5h2o5o

다음 예제에서는 uniqueString를 사용하여 일반적으로 사용하는 수준에 대해 고유한 값을 만드는 방법을 보여 줍니다.The following examples show how to use uniqueString to create a unique value for commonly used levels.

구독에 범위가 지정된 고유함Unique scoped to subscription

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

리소스 그룹에 범위가 지정된 고유함Unique scoped to resource group

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

리소스 그룹의 배포에 범위가 지정된 고유함Unique scoped to deployment for a resource group

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

다음 예제에서는 리소스 그룹에 따라 저장소 계정에 고유한 이름을 만드는 방법을 보여 줍니다.The following example shows how to create a unique name for a storage account based on your resource group. 리소스 그룹 내에서 이름이 동일한 방식으로 생성 된 경우 고유 아닙니다.Inside the resource group, the name isn't unique if constructed the same way.

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

사용할 수 있습니다, 템플릿을 배포 하 고 리소스를 업데이트 하지 않을 때마다 새 고유 이름을 생성 해야 하는 경우는 utcNow uniqueString 사용 하 여 함수입니다.If you need to create a new unique name each time you deploy a template, and don't intend to update the resource, you can use the utcNow function with uniqueString. 이 방법은 테스트 환경에서 사용할 수 있습니다.You could use this approach in a test environment. 예를 들어 참조 utcNow합니다.For an example, see utcNow.

반환 값Return value

13개의 문자를 포함하는 문자열입니다.A string containing 13 characters.

Examples

다음 예제 템플릿에서는 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"
        }
    }
}

uriuri

uri (baseUri, relativeUri)

baseUri와 relativeUri 문자열을 결합하여 절대 URI를 만듭니다.Creates an absolute URI by combining the baseUri and the relativeUri string.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
baseUribaseUri Yes stringstring 기본 uri 문자열입니다.The base uri string.
relativeUrirelativeUri Yes stringstring 기본 uri 문자열에 추가할 상대 uri 문자열입니다.The relative uri string to add to the base uri string.

baseUri 매개 변수에 대한 값은 특정 파일을 포함할 수 있지만 URI를 생성하는 경우 기본 경로만 사용됩니다.The value for the baseUri parameter can include a specific file, but only the base path is used when constructing the URI. 예를 들어 http://contoso.com/resources/azuredeploy.json을 baseUri 매개 변수로 전달하면 기본 URI는 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/.

반환 값Return value

기본 및 상대 값에 대한 절대 URI를 나타내는 문자열입니다.A string representing the absolute URI for the base and relative values.

Examples

다음 예제에서는 부모 템플릿의 값을 기반으로 중첩된 템플릿에 대한 링크를 생성하는 방법을 보여 줍니다.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')]"

다음 예제 템플릿에서는 uri, uriComponent 및 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput 문자열String 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.json

uriComponenturiComponent

uricomponent(stringToEncode)

URI를 인코딩합니다.Encodes a URI.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
stringToEncodestringToEncode Yes stringstring 인코딩할 값입니다.The value to encode.

반환 값Return value

URI로 인코딩된 값의 문자열입니다.A string of the URI encoded value.

Examples

다음 예제 템플릿에서는 uri, uriComponent 및 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput 문자열String 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.json

uriComponentToStringuriComponentToString

uriComponentToString(uriEncodedString)

URI로 인코딩된 값의 문자열을 반환합니다.Returns a string of a URI encoded value.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
uriEncodedStringuriEncodedString Yes stringstring 문자열로 변환할 URI 인코딩 값입니다.The URI encoded value to convert to a string.

반환 값Return value

URI로 인코딩된 값의 디코딩된 문자열입니다.A decoded string of URI encoded value.

Examples

다음 예제 템플릿에서는 uri, uriComponent 및 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'))]"
        }
    }
}

기본 값을 사용한 이전 예제의 출력은 다음과 같습니다.The output from the preceding example with the default values is:

이름Name typeType Value
uriOutputuriOutput StringString http://contoso.com/resources/nested/azuredeploy.json
componentOutputcomponentOutput 문자열String 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.json

utcNowutcNow

utcNow(format)

지정 된 형식의 현재 UTC 날짜/시간 값을 반환합니다.Returns the current (UTC) datetime value in the specified format. 서식을 제공 하는 경우 ISO 8601 (yyyyMMddTHHmmssZ) 형식으로 사용 됩니다.If no format is provided, the ISO 8601 (yyyyMMddTHHmmssZ) format is used. 이 함수는 매개 변수에 대 한 기본값인 에서만 사용 수 있습니다.This function can only be used in the default value for a parameter.

매개 변수Parameters

매개 변수를 포함해야 합니다.Parameter 필수Required 형식Type 설명Description
formatformat 아닙니다.No 문자열string 문자열로 변환할 URI 인코딩 값입니다.The URI encoded value to convert to a string. 사용 하 여 표준 형식 문자열 하거나 사용자 지정 형식 문자열합니다.Use either standard format strings or custom format strings.

설명Remarks

매개 변수의 기본값만 식 내에서이 함수를 사용할 수 있습니다.You can only use this function within an expression for the default value of a parameter. 템플릿에서 다른 곳에이 함수를 사용 하 여 오류를 반환 합니다.Using this function anywhere else in a template returns an error. 함수를 호출할 때마다 다른 값을 반환 하기 때문에 템플릿의 다른 부분에서 허용 되지 않습니다.The function isn't allowed in other parts of the template because it returns a different value each time it's called. 동일한 매개 변수를 사용 하 여 동일한 템플릿에 배포 같은 결과 안정적으로 생성 하지 않습니다.Deploying the same template with the same parameters wouldn't reliably produce the same results.

사용 하는 경우는 이전 성공적인 배포를 다시 배포 하는 옵션, utcNow를 사용 하는 매개 변수를 포함 하는 이전 배포를 매개 변수 다시 평가 되지 않습니다.If you use the option to redeploy an earlier successful deployment, and the earlier deployment includes a parameter that uses utcNow, the parameter isn't reevaluated. 대신 이전 배포에서 매개 변수 값을 롤백 배포에서 자동으로 재사용 됩니다.Instead, the parameter value from the earlier deployment is automatically reused in the rollback deployment.

UtcNow 함수에 대 한 기본값을 사용 하는 템플릿을 다시 배포 주의 해야 합니다.Be careful redeploying a template that relies on the utcNow function for a default value. 다시 배포 하 고 매개 변수 값을 제공 하지는 다시 평가 됩니다.When you redeploy and don't provide a value for the parameter, the function is reevaluated. 새로 만들어야 하는 것이 아니라 기존 리소스를 업데이트 하려는 경우 이전 배포에서 매개 변수 값에 전달 합니다.If you want to update an existing resource rather than create a new one, pass in the parameter value from the earlier deployment.

반환 값Return value

현재 UTC 날짜/시간 값입니다.The current UTC datetime value.

Examples

다음 예제에서는 서식 파일에는 날짜/시간 값에 대 한 다양 한 형식을 보여 줍니다.The following example template shows different formats for the datetime value.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "utcValue": {
            "type": "string",
            "defaultValue": "[utcNow()]"
        },
        "utcShortValue": {
            "type": "string",
            "defaultValue": "[utcNow('d')]"
        },
        "utcCustomValue": {
            "type": "string",
            "defaultValue": "[utcNow('M d')]"
        }
    },
    "resources": [
    ],
    "outputs": {
        "utcOutput": {
            "type": "string",
            "value": "[parameters('utcValue')]"
        },
        "utcShortOutput": {
            "type": "string",
            "value": "[parameters('utcShortValue')]"
        },
        "utcCustomOutput": {
            "type": "string",
            "value": "[parameters('utcCustomValue')]"
        }
    }
}

출력 앞의 예제에서 각 배포에 대 한 다르지만 비슷합니다.The output from the preceding example varies for each deployment but will be similar to:

이름Name typeType Value
utcOutpututcOutput 문자열string 20190305T175318Z20190305T175318Z
utcShortOutpututcShortOutput 문자열string 03/05/201903/05/2019
utcCustomOutpututcCustomOutput 문자열string 3 53 5

다음 예제에서는 태그 값을 설정 하는 경우 함수에서 값을 사용 하는 방법을 보여 줍니다.The next example shows how to use a value from the function when setting a tag value.

{
    "$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "utcShort": {
            "type": "string",
            "defaultValue": "[utcNow('d')]"
        },
        "rgName": {
            "type": "string"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Resources/resourceGroups",
            "apiVersion": "2018-05-01",
            "name": "[parameters('rgName')]",
            "location": "westeurope",
            "tags":{
                "createdDate": "[parameters('utcShort')]"
            },
            "properties":{}
        }
    ],
    "outputs": {
        "utcShort": {
            "type": "string",
            "value": "[parameters('utcShort')]"
        }
    }
}

다음 단계Next steps