Sztringfüggvények ARM-sablonokhoz
A Resource Manager az alábbi függvényeket biztosítja az Azure Resource Manager-sablonban (ARM-sablonban) található sztringek kezeléséhez:
- base64
- base64ToJson
- base64ToString
- összefűzés
- Tartalmaz
- dataUri
- dataUriToString
- üres
- endsWith
- első
- format
- Guid
- indexOf
- csatlakozás
- json
- utolsó
- lastIndexOf
- length (hossz)
- newGuid
- padLeft
- helyettesít
- átugrik
- hasít
- startsWith
- húr
- Substring
- vesz
- toLower
- toUpper
- nyír
- uniqueString
- Uri
- uriComponent
- uriComponentToString
Tipp.
A Bicep használatát javasoljuk, mert ugyanazokkal a képességekkel rendelkezik, mint az ARM-sablonok, és a szintaxis használata egyszerűbb. További információ: sztringfüggvények.
base64
base64(inputString)
A bemeneti sztring base64-ábrázolását adja vissza.
A Bicepben használja a base64 függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
inputString | Igen | húr | A base64-ábrázolásként visszaadandó érték. |
Visszaadott érték
A base64-ábrázolást tartalmazó sztring.
Példák
Az alábbi példa a függvény használatát base64
mutatja be.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
base64Output | Sztring | b25lLCB0d28sIHRocmVl |
toStringOutput | Sztring | egy két há' |
toJsonOutput | Objektum | {"one": "a", "two": "b"} |
base64ToJson
base64ToJson(base64Value)
A base64-ábrázolás JSON-objektummá alakít át.
A Bicepben használja a base64ToJson függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
base64Value | Igen | húr | A JSON-objektummá alakítandó base64-ábrázolás. |
Visszaadott érték
JSON-objektum.
Példák
Az alábbi példa a függvényt használja egy base64ToJson
base64-érték konvertálásához:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
base64Output | Sztring | b25lLCB0d28sIHRocmVl |
toStringOutput | Sztring | egy két há' |
toJsonOutput | Objektum | {"one": "a", "two": "b"} |
base64ToString
base64ToString(base64Value)
Egy base64-ábrázolás sztringgé alakít át.
A Bicepben használja a base64ToString függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
base64Value | Igen | húr | A sztringgé alakítandó base64-ábrázolás. |
Visszaadott érték
A konvertált base64 érték sztringje.
Példák
Az alábbi példa a függvényt használja egy base64ToString
base64-érték konvertálásához:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
base64Output | Sztring | b25lLCB0d28sIHRocmVl |
toStringOutput | Sztring | egy két há' |
toJsonOutput | Objektum | {"one": "a", "two": "b"} |
összefűzés
concat(arg1, arg2, arg3, ...)
Több sztringértéket egyesít, és visszaadja az összefűzött sztringet, vagy több tömböt egyesít, és visszaadja az összefűzött tömböt.
A Bicepben a függvény helyett sztringinterpolációt használjon az concat()
olvashatóság javítása érdekében. Bizonyos esetekben azonban, például a többsoros sztringek sztringcseréje esetén előfordulhat, hogy vissza kell esnie a függvény vagy areplace()
concat()
függvény használatára.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
arg1 | Igen | sztring vagy tömb | Az összefűzés első sztringje vagy tömbje. |
további argumentumok | Nem | sztring vagy tömb | További sztringek vagy tömbök szekvenciális sorrendben az összefűzéshez. |
Ez a függvény tetszőleges számú argumentumot tartalmazhat, és sztringeket vagy tömböket is elfogadhat a paraméterekhez. A paraméterekhez azonban nem adhat meg tömböket és sztringeket. A sztringek csak más sztringekkel vannak összefűzve.
Visszaadott érték
Összefűzött értékek sztringje vagy tömbje.
Példák
Az alábbi példa bemutatja, hogyan kombinálhat két sztringértéket, és hogyan ad vissza egy összefűzött sztringet.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"prefix": {
"type": "string",
"defaultValue": "prefix"
}
},
"resources": [],
"outputs": {
"concatOutput": {
"type": "string",
"value": "[concat(parameters('prefix'), '-', uniqueString(resourceGroup().id))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
concatOutput | Sztring | előtag-5yj4yjf5mbg72 |
Az alábbi példa bemutatja, hogyan kombinálhat két tömböt.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
vissza | Tömb | ["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"] |
contains
contains(container, itemToFind)
Ellenőrzi, hogy egy tömb tartalmaz-e értéket, egy objektum tartalmaz-e kulcsot, vagy egy sztring tartalmaz-e részsztringet. A sztringek összehasonlítása megkülönbözteti a kis- és nagybetűk értékét. Ha azonban egy objektum tartalmaz kulcsot, az összehasonlítás érzéketlen.
A Bicepben használja a contains függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
tároló | Igen | tömb, objektum vagy sztring | A keresendő értéket tartalmazó érték. |
itemToFind | Igen | sztring vagy int | A keresendő érték. |
Visszaadott érték
True
ha az elem megtalálható; egyéb esetben. False
Példák
Az alábbi példa bemutatja, hogyan használható különböző típusú:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
stringTrue | Bool | Igaz |
stringFalse | Bool | Hamis |
objectTrue | Bool | Igaz |
objectFalse | Bool | Hamis |
arrayTrue | Bool | Igaz |
arrayFalse | Bool | Hamis |
dataUri
dataUri(stringToConvert)
Egy értéket adat URI-vá alakít át.
A Bicepben használja a dataUri függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToConvert | Igen | húr | Az adat URI-vá konvertálandó érték. |
Visszaadott érték
Adat URI-ként formázott sztring.
Példák
Az alábbi példa egy értéket adat URI-vá konvertál, és egy adat URI-t sztringgé alakít át.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
dataUriOutput | Sztring | data:text/plain; charset=utf8; base64,SGVsbG8= |
toStringOutput | Sztring | Helló világ! |
dataUriToString
dataUriToString(dataUriToConvert)
Az adat URI formátumú értékét sztringgé alakítja át.
A Bicepben használja a dataUriToString függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
dataUriToConvert | Igen | húr | Az átalakítandó adat URI-értéke. |
Visszaadott érték
A konvertált értéket tartalmazó sztring.
Példák
Az alábbi példasablon adat URI-vá konvertálja az értéket, és sztringgé alakítja az adat URI-t.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
dataUriOutput | Sztring | data:text/plain; charset=utf8; base64,SGVsbG8= |
toStringOutput | Sztring | Helló világ! |
üres
empty(itemToTest)
Meghatározza, hogy egy tömb, objektum vagy sztring üres-e.
A Bicepben használja az üres függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
itemToTest | Igen | tömb, objektum vagy sztring | Az az érték, amely ellenőrzi, hogy üres-e. |
Visszaadott érték
Akkor adja True
vissza, ha az érték üres; False
ellenkező esetben.
Példák
Az alábbi példa azt ellenőrzi, hogy egy tömb, objektum és sztring üres-e.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayEmpty | Bool | Igaz |
objectEmpty | Bool | Igaz |
stringEmpty | Bool | Igaz |
endsWith
endsWith(stringToSearch, stringToFind)
Meghatározza, hogy egy sztring értéke végződik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.
A Bicepben használja a endsWith függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToSearch | Igen | húr | A keresendő elemet tartalmazó érték. |
stringToFind | Igen | húr | A keresendő érték. |
Visszaadott érték
True
ha a sztring utolsó karaktere vagy karaktere megegyezik az értékkel; egyéb esetben. False
Példák
Az alábbi példa a függvények és endsWith
a startsWith
függvények használatát mutatja be:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"startsTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'ab')]"
},
"startsCapTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'A')]"
},
"startsFalse": {
"type": "bool",
"value": "[startsWith('abcdef', 'e')]"
},
"endsTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'ef')]"
},
"endsCapTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'F')]"
},
"endsFalse": {
"type": "bool",
"value": "[endsWith('abcdef', 'e')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
startsTrue | Bool | Igaz |
startsCapTrue | Bool | Igaz |
startsFalse | Bool | Hamis |
endsTrue | Bool | Igaz |
endsCapTrue | Bool | Igaz |
endsFalse | Bool | Hamis |
első
first(arg1)
A sztring első karakterét vagy a tömb első elemét adja vissza. Ha üres sztringet ad meg, a függvény üres sztringet eredményez. Üres tömb esetén a függvény visszaadja a függvényt null
.
A Bicepben használja az első függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
arg1 | Igen | tömb vagy sztring | Az első elem vagy karakter beolvasásának értéke. |
Visszaadott érték
A tömb első elemének karakterlánca, vagy a tömb első elemének típusa (sztring, int, tömb vagy objektum).
Példák
Az alábbi példa bemutatja, hogyan használható az első függvény tömbökkel és sztringekkel.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayOutput | Sztring | egy |
stringOutput | Sztring | O |
format
format(formatString, arg1, arg2, ...)
Formázott sztringet hoz létre a bemeneti értékekből.
A Bicepben használja a formátumfüggvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
formatString | Igen | húr | Az összetett formátum sztringje. |
arg1 | Igen | sztring, egész szám vagy logikai érték | A formázott sztringben szerepeltetni kívánt érték. |
további argumentumok | Nem | sztring, egész szám vagy logikai érték | További értékek a formázott sztringben. |
Megjegyzések
Ezzel a függvénnyel formázhat egy sztringet a sablonban. Ugyanazokat a formázási beállításokat használja, mint a System.String.Format metódus a .NET-ben.
Példák
Az alábbi példa a formátumfüggvény használatát mutatja be.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
formatTest | Sztring | Üdv, Felhasználó. Formázott szám: 8 175 133 |
guid
guid(baseString, ...)
A paraméterként megadott értékek alapján globálisan egyedi azonosító formájában hoz létre értéket.
A Bicepben használja a guid függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
baseString | Igen | húr | A KIVONAT függvényben a GUID létrehozásához használt érték. |
szükség szerint további paraméterek | Nem | húr | Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá. |
Megjegyzések
Ez a függvény akkor hasznos, ha globálisan egyedi azonosító formátumú értéket kell létrehoznia. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.
A visszaadott érték nem véletlenszerű sztring, hanem a paraméterek kivonatfüggvényének eredménye. A visszaadott érték 36 karakter hosszú. Ez nem globálisan egyedi. Ha olyan új GUID-t szeretne létrehozni, amely nem a paraméterek kivonatértékén alapul, használja a newGuid függvényt .
Az alábbi példák bemutatják, hogyan hozhat létre egyedi értéket a gyakran használt szintek guidjaival.
Előfizetésre vonatkozó egyedi hatókör
"[guid(subscription().subscriptionId)]"
Erőforráscsoportra vonatkozó egyedi hatókör
"[guid(resourceGroup().id)]"
Erőforráscsoport üzembe helyezésének egyedi hatóköre
"[guid(resourceGroup().id, deployment().name)]"
A guid
függvény implementálja az algoritmust az RFC 4122 §4.3-ából. Az eredeti forrás néhány módosítással megtalálható a GuidUtility-ben.
Visszaadott érték
Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.
Példák
Az alábbi példa a következő eredményből ad guid
vissza eredményeket:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"variables": {},
"resources": [],
"outputs": {
"guidPerSubscription": {
"type": "string",
"value": "[guid(subscription().subscriptionId)]"
},
"guidPerResourceGroup": {
"type": "string",
"value": "[guid(resourceGroup().id)]"
},
"guidPerDeployment": {
"type": "string",
"value": "[guid(resourceGroup().id, deployment().name)]"
}
}
}
indexOf
indexOf(stringToSearch, stringToFind)
Egy érték első pozícióját adja vissza egy sztringen belül. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.
A Bicepben használja az IndexOf függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToSearch | Igen | húr | A keresendő elemet tartalmazó érték. |
stringToFind | Igen | húr | A keresendő érték. |
Visszaadott érték
Egy egész szám, amely a keresendő elem pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.
Példák
Az alábbi példa a függvények és lastIndexOf
a indexOf
függvények használatát mutatja be:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"firstT": {
"type": "int",
"value": "[indexOf('test', 't')]"
},
"lastT": {
"type": "int",
"value": "[lastIndexOf('test', 't')]"
},
"firstString": {
"type": "int",
"value": "[indexOf('abcdef', 'CD')]"
},
"lastString": {
"type": "int",
"value": "[lastIndexOf('abcdef', 'AB')]"
},
"notFound": {
"type": "int",
"value": "[indexOf('abcdef', 'z')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
firstT | Int | 0 |
lastT | Int | 3 |
firstString | Int | 2 |
lastString | Int | 0 |
notFound | Int | 1- |
Csatlakozás
join(inputArray, delimiter)
Egy sztringtömböt egyetlen sztringbe illeszt, elválasztójellel elválasztva.
A Bicepben használja az illesztés függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
inputArray | Igen | sztringek tömbje | Összekapcsolandó sztringtömb. |
Határoló | Igen | A sztring felosztásához használandó elválasztó. |
Visszaadott érték
Egy sztring.
Példák
Az alábbi példa a bemeneti sztringtömböt különböző elválasztójelekkel tagolt sztringekké alakítja.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"variables": {
"arrayString": [
"one",
"two",
"three"
]
},
"resources": [],
"outputs": {
"firstOutput": {
"type": "string",
"value": "[join(variables('arrayString'), ',')]"
},
"secondOutput": {
"type": "string",
"value": "[join(variables('arrayString'), ';')]"
}
}
}
Az előző példa kimenete a következő:
Név | Típus | Érték |
---|---|---|
firstOutput | Sztring | "egy,kettő,három" |
secondOutput | Sztring | "egy; Kettő; három" |
json
json(arg1)
Egy érvényes JSON-sztringet JSON-adattípussá alakít át. További információ: json függvény.
A Bicepben használja a json függvényt.
utolsó
last(arg1)
A sztring utolsó karakterét vagy a tömb utolsó elemét adja vissza.
A Bicepben használja az utolsó függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
arg1 | Igen | tömb vagy sztring | Az utolsó elem vagy karakter beolvasásának értéke. |
Visszaadott érték
Egy tömb utolsó elemének utolsó karakterének vagy típusának (sztring, int, tömb vagy objektum) karakterlánca.
Példák
Az alábbi példa bemutatja, hogyan használhatja a last
függvényt tömbökkel és sztringekkel.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayOutput | Sztring | három |
stringOutput | Sztring | e |
lastIndexOf
lastIndexOf(stringToSearch, stringToFind)
Egy karakterláncon belüli érték utolsó pozícióját adja vissza. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.
A Bicepben használja az utolsóIndexOf függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToSearch | Igen | húr | A keresendő elemet tartalmazó érték. |
stringToFind | Igen | húr | A keresendő érték. |
Visszaadott érték
Egy egész szám, amely a megkeresendő elem utolsó pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.
Példák
Az alábbi példa a függvények és lastIndexOf
a indexOf
függvények használatát mutatja be:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"firstT": {
"type": "int",
"value": "[indexOf('test', 't')]"
},
"lastT": {
"type": "int",
"value": "[lastIndexOf('test', 't')]"
},
"firstString": {
"type": "int",
"value": "[indexOf('abcdef', 'CD')]"
},
"lastString": {
"type": "int",
"value": "[lastIndexOf('abcdef', 'AB')]"
},
"notFound": {
"type": "int",
"value": "[indexOf('abcdef', 'z')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
firstT | Int | 0 |
lastT | Int | 3 |
firstString | Int | 2 |
lastString | Int | 0 |
notFound | Int | 1- |
length (hossz)
length(string)
Visszaadja egy sztring karaktereinek számát, egy tömb elemeit vagy egy objektum gyökérszintű tulajdonságait.
A Bicepben használja a hosszfüggvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
arg1 | Igen | tömb, sztring vagy objektum | Az elemek számának lekéréséhez használandó tömb, a karakterek számának lekéréséhez használandó sztring vagy a gyökérszintű tulajdonságok számának lekéréséhez használni kívánt objektum. |
Visszaadott érték
Egy int.
Példák
Az alábbi példa bemutatja, hogyan használható a length
függvény tömbökkel és sztringekkel:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"arrayToTest": {
"type": "array",
"defaultValue": [
"one",
"two",
"three"
]
},
"stringToTest": {
"type": "string",
"defaultValue": "One Two Three"
},
"objectToTest": {
"type": "object",
"defaultValue": {
"propA": "one",
"propB": "two",
"propC": "three",
"propD": {
"propD-1": "sub",
"propD-2": "sub"
}
}
}
},
"resources": [],
"outputs": {
"arrayLength": {
"type": "int",
"value": "[length(parameters('arrayToTest'))]"
},
"stringLength": {
"type": "int",
"value": "[length(parameters('stringToTest'))]"
},
"objectLength": {
"type": "int",
"value": "[length(parameters('objectToTest'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayLength | Int | 3 |
stringLength | Int | 13 |
objectLength | Int | 4 |
newGuid
newGuid()
Globálisan egyedi azonosító formátumú értéket ad vissza. Ez a függvény csak egy paraméter alapértelmezett értékében használható.
A Bicepben használja a newGuid függvényt .
Megjegyzések
Ezt a függvényt csak egy paraméter alapértelmezett értékének kifejezésén belül használhatja. Ha ezt a függvényt bárhol máshol használja egy sablonban, hibát ad vissza. A függvény nem engedélyezett a sablon más részeiben, mert minden híváskor más értéket ad vissza. Ha ugyanazt a sablont ugyanazokkal a paraméterekkel helyezi üzembe, az nem eredményezne megbízhatóan ugyanazokat az eredményeket.
A newGuid függvény eltér a guid függvénytől, mert nem vesz fel paramétereket. Ha ugyanazzal a paraméterrel hívja meg a GUID azonosítót, az minden alkalommal ugyanazt az azonosítót adja vissza. Akkor használja a GUID-t, ha megbízhatóan kell létrehoznia ugyanazt a GUID-t egy adott környezethez. Használja a newGuid-t, ha minden alkalommal más azonosítóra van szüksége, például erőforrásokat helyez üzembe egy tesztkörnyezetben.
A newGuid függvény a .NET-keretrendszer Guid struktúráját használja a globálisan egyedi azonosító létrehozásához.
Ha egy korábbi sikeres üzembe helyezés ismételt üzembe helyezésének lehetőségét használja, és a korábbi üzembe helyezés tartalmaz egy újGuid-t használó paramétert, a paraméter nem lesz újraértékelve. Ehelyett a rendszer automatikusan újra felhasználja a korábbi üzembe helyezés paraméterértékét a visszaállítási üzembe helyezés során.
Tesztkörnyezetben előfordulhat, hogy ismétlődően kell üzembe helyeznie azokat az erőforrásokat, amelyek csak rövid ideig élnek. Az egyedi nevek létrehozása helyett a newGuid és az uniqueString használatával egyedi neveket hozhat létre.
Ügyeljen arra, hogy újra üzembe helyezzen egy sablont, amely az újGuid függvényre támaszkodik egy alapértelmezett értékhez. Amikor újra üzembe helyezi a paramétert, és nem ad meg értéket, a függvény újraértékelódik. Ha egy meglévő erőforrást szeretne frissíteni ahelyett, hogy újat hozna létre, adja meg a paraméter értékét a korábbi üzembe helyezésből.
Visszaadott érték
Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.
Példák
Az alábbi példa egy új azonosítóval rendelkező paramétert mutat be.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"guidValue": {
"type": "string",
"defaultValue": "[newGuid()]"
}
},
"resources": [
],
"outputs": {
"guidOutput": {
"type": "string",
"value": "[parameters('guidValue')]"
}
}
}
Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:
Név | Típus | Érték |
---|---|---|
guidOutput | húr | b76a51fc-bd72-4a77-b9a2-3c29e7d2e551 |
Az alábbi példa a newGuid
függvényt használja egy tárfiók egyedi nevének létrehozásához. Ez a sablon olyan tesztkörnyezetekben használható, ahol a tárfiók rövid ideig létezik, és nem kerül újra üzembe.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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",
"apiVersion": "2021-04-01",
"name": "[variables('storageName')]",
"location": "West US",
"sku": {
"name": "Standard_LRS"
},
"kind": "StorageV2",
"properties": {}
}
],
"outputs": {
"nameOutput": {
"type": "string",
"value": "[variables('storageName')]"
}
}
}
Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:
Név | Típus | Érték |
---|---|---|
nameOutput | húr | storagenziwvyru7uxie |
padLeft
padLeft(valueToPad, totalLength, paddingCharacter)
Egy jobbra igazított sztringet ad vissza úgy, hogy karaktereket ad hozzá balra, amíg el nem éri a megadott teljes hosszt.
A Bicepben használja a padLeft függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
valueToPad | Igen | sztring vagy int | A jobbra igazított érték. |
totalLength | Igen | egész | A visszaadott sztringben szereplő karakterek teljes száma. |
paddingCharacter | Nem | egyetlen karakter | A bal oldali kitöltéshez használandó karakter, amíg el nem éri a teljes hosszt. Az alapértelmezett érték egy szóköz. |
Ha az eredeti sztring hosszabb, mint a beszúrandó karakterek száma, a rendszer nem ad hozzá karaktereket.
Visszaadott érték
Legalább a megadott karakterszámmal rendelkező sztring.
Példák
Az alábbi példa bemutatja, hogyan lehet a felhasználó által megadott paraméter értékét a nulla karakter hozzáadásával beszedni, amíg el nem éri a karakterek teljes számát.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
stringOutput | Sztring | 0000000123 |
helyettesít
replace(originalString, oldString, newString)
Egy új sztringet ad vissza, amely az egyik sztring összes példányát lecseréli egy másik sztringre.
A Bicepben használja a cserefüggvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
originalString | Igen | húr | Az az érték, amely egy sztring összes példányát lecseréli egy másik sztringre. |
oldString | Igen | húr | Az eredeti sztringből eltávolítandó sztring. |
newString | Igen | húr | Az eltávolított sztring helyett hozzáadni kívánt sztring. |
Visszaadott érték
Sztring a lecserélt karakterekkel.
Példák
Az alábbi példa bemutatja, hogyan távolíthatja el az összes kötőjelet a felhasználó által megadott sztringből, és hogyan cserélheti le a sztring egy részét egy másik sztringre.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'),'-', '')]"
},
"secondOutput": {
"type": "string",
"value": "[replace(parameters('testString'),'1234', 'xxxx')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
firstOutput | Sztring | 1231231234 |
secondOutput | Sztring | 123-123-xxxx |
Kihagyás
skip(originalValue, numberToSkip)
A megadott számú karakter után az összes karaktert tartalmazó sztringet, vagy egy tömböt ad vissza, amely a megadott számú elem után az összes elemet tartalmazza.
A Bicepben használja a kihagyó függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
originalValue | Igen | tömb vagy sztring | A kihagyáshoz használandó tömb vagy sztring. |
numberToSkip | Igen | egész | Az kihagyandó elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a rendszer az érték összes elemét vagy karakterét visszaadja. Ha nagyobb, mint a tömb vagy a sztring hossza, a függvény üres tömböt vagy sztringet ad vissza. |
Visszaadott érték
Tömb vagy sztring.
Példák
Az alábbi példa kihagyja a tömb megadott számú elemét és a sztringben megadott számú karaktert.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayOutput | Tömb | ["három"] |
stringOutput | Sztring | két három |
hasít
split(inputString, delimiter)
A megadott elválasztójelekkel tagolt bemeneti sztring részsztringeit tartalmazó karakterlánctömböt ad vissza.
A Bicepben használja az osztott függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
inputString | Igen | húr | A felosztandó sztring. |
Határoló | Igen | sztring vagy sztringtömb | A sztring felosztásához használandó elválasztó. |
Visszaadott érték
Sztringek tömbje.
Példák
Az alábbi példa vesszővel és pontosvesszővel osztja fel a bemeneti sztringet.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
firstOutput | Tömb | ["one", "two", "three"] |
secondOutput | Tömb | ["one", "two", "three"] |
startsWith
startsWith(stringToSearch, stringToFind)
Meghatározza, hogy egy sztring egy értékkel kezdődik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.
A Bicepben használja a startsWith függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToSearch | Igen | húr | A keresendő elemet tartalmazó érték. |
stringToFind | Igen | húr | A keresendő érték. |
Visszaadott érték
True
ha a sztring első karaktere vagy karaktere megegyezik az értékkel; egyéb esetben. False
Példák
Az alábbi példa a függvények és endsWith
a startsWith
függvények használatát mutatja be:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"startsTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'ab')]"
},
"startsCapTrue": {
"type": "bool",
"value": "[startsWith('abcdef', 'A')]"
},
"startsFalse": {
"type": "bool",
"value": "[startsWith('abcdef', 'e')]"
},
"endsTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'ef')]"
},
"endsCapTrue": {
"type": "bool",
"value": "[endsWith('abcdef', 'F')]"
},
"endsFalse": {
"type": "bool",
"value": "[endsWith('abcdef', 'e')]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
startsTrue | Bool | Igaz |
startsCapTrue | Bool | Igaz |
startsFalse | Bool | Hamis |
endsTrue | Bool | Igaz |
endsCapTrue | Bool | Igaz |
endsFalse | Bool | Hamis |
húr
string(valueToConvert)
A megadott értéket sztringgé alakítja.
A Bicepben használja a sztringfüggvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
valueToConvert | Igen | Bármely | A sztringgé konvertálandó érték. Bármilyen típusú érték konvertálható, beleértve az objektumokat és a tömböket is. |
Visszaadott érték
A konvertált érték sztringje.
Példák
Az alábbi példa bemutatja, hogyan konvertálhat különböző típusú értékeket sztringekké.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
objectOutput | Sztring | {"valueA":10;"valueB":"Example Text"} |
arrayOutput | Sztring | ["a","b";"c"] |
intOutput | Sztring | 5 |
Substring
substring(stringToParse, startIndex, length)
Egy alsztringet ad vissza, amely a megadott karakterhelyzetben kezdődik, és a megadott számú karaktert tartalmazza.
A Bicepben használja az összevonási függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToParse | Igen | húr | Az eredeti sztring, amelyből az alsztring ki lesz nyerve. |
startIndex | Nem | egész | Az alsztring nulla alapú kezdő karakterpozíciója. |
length (hossz) | Nem | egész | Az alsztring karaktereinek száma. A sztringen belüli helyre kell hivatkoznia. Nullának vagy nagyobbnak kell lennie. Ha nincs megadva, a rendszer a sztring fennmaradó részét adja vissza a kezdő pozícióból. |
Visszaadott érték
Az alászúrás. Vagy üres sztring, ha a hossz nulla.
Megjegyzések
A függvény meghiúsul, ha az alsztring a sztring végén túlnyúlik, vagy ha a hossz kisebb, mint nulla. Az alábbi példa a következő hibaüzenettel meghiúsul: "Az index- és hosszparamétereknek a sztring egy helyére kell hivatkoznia. Az indexparaméter: "0", a hosszparaméter: "11", a sztringparaméter hossza: "10".
"parameters": {
"inputString": {
"type": "string",
"value": "1234567890"
}
}, "variables": {
"prefix": "[substring(parameters('inputString'), 0, 11)]"
}
Példák
Az alábbi példa egy paraméterből nyer ki egy részszúrást.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "one two three"
}
},
"resources": [],
"outputs": {
"substringOutput": {
"type": "string",
"value": "[substring(parameters('testString'), 4, 3)]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
substringOutput | Sztring | kettő |
Elvétel
take(originalValue, numberToTake)
Tömböt vagy sztringet ad vissza. A tömbök a tömb kezdetétől megadott számú elemet tartalmaznak. A sztringek a sztring elejétől megadott számú karaktert tartalmaznak.
A Bicepben használja a take függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
originalValue | Igen | tömb vagy sztring | Az elemeket átvenni kívánt tömb vagy sztring. |
numberToTake | Igen | egész | A felvenni kívánt elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a függvény egy üres tömböt vagy sztringet ad vissza. Ha nagyobb, mint az adott tömb vagy sztring hossza, a rendszer visszaadja a tömb vagy sztring összes elemét. |
Visszaadott érték
Tömb vagy sztring.
Példák
Az alábbi példa a tömb megadott számú elemét és egy sztringből származó karaktereket veszi fel.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
arrayOutput | Tömb | ["egy", "kettő"] |
stringOutput | Sztring | ekkor |
toLower
toLower(stringToChange)
A megadott sztringet kisbetűssé alakítja.
A Bicepben használja a toLower függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToChange | Igen | húr | A kisbetűssé konvertálandó érték. |
Visszaadott érték
A kisbetűssé konvertált sztring.
Példák
Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "One Two Three"
}
},
"resources": [],
"outputs": {
"toLowerOutput": {
"type": "string",
"value": "[toLower(parameters('testString'))]"
},
"toUpperOutput": {
"type": "string",
"value": "[toUpper(parameters('testString'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
toLowerOutput | Sztring | egy két há' |
toUpperOutput | Sztring | EGY KÉT HÁ' |
toUpper
toUpper(stringToChange)
A megadott sztringet nagybetűssé alakítja.
A Bicepben használja a toUpper függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToChange | Igen | húr | A nagybetűssé konvertálandó érték. |
Visszaadott érték
A nagybetűssé konvertált sztring.
Példák
Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"testString": {
"type": "string",
"defaultValue": "One Two Three"
}
},
"resources": [],
"outputs": {
"toLowerOutput": {
"type": "string",
"value": "[toLower(parameters('testString'))]"
},
"toUpperOutput": {
"type": "string",
"value": "[toUpper(parameters('testString'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
toLowerOutput | Sztring | egy két há' |
toUpperOutput | Sztring | EGY KÉT HÁ' |
nyír
trim(stringToTrim)
Eltávolítja az összes kezdő és záró szóköz karaktert a megadott sztringből.
A Bicepben használja a vágási függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToTrim | Igen | húr | A levágandó érték. |
Visszaadott érték
A sztring bevezető és záró szóköz karakterek nélkül.
Példák
Az alábbi példa levágja a szóköz karaktereket a paraméterből.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
vissza | Sztring | egy két há' |
uniqueString
uniqueString(baseString, ...)
A paraméterekként megadott értékek alapján létrehoz egy determinisztikus kivonatsztringet.
A Bicepben használja az uniqueString függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
baseString | Igen | húr | A kivonatoló függvényben egy egyedi sztring létrehozásához használt érték. |
szükség szerint további paraméterek | Nem | húr | Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá. |
Megjegyzések
Ez a függvény akkor hasznos, ha egyedi nevet kell létrehoznia egy erőforráshoz. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.
A visszaadott érték nem véletlenszerű sztring, hanem kivonatfüggvény eredménye. A visszaadott érték 13 karakter hosszú. Ez nem globálisan egyedi. Érdemes lehet kombinálni az értéket az elnevezési konvencióból származó előtaggal, hogy értelmes nevet hozzon létre. Az alábbi példa a visszaadott érték formátumát mutatja be. A tényleges érték a megadott paraméterektől függ.
tcvhiyu5h2o5o
Az alábbi példák bemutatják, hogyan hozhat uniqueString
létre egyedi értéket a gyakran használt szintekhez.
Előfizetésre vonatkozó egyedi hatókör
"[uniqueString(subscription().subscriptionId)]"
Erőforráscsoportra vonatkozó egyedi hatókör
"[uniqueString(resourceGroup().id)]"
Erőforráscsoport üzembe helyezésének egyedi hatóköre
"[uniqueString(resourceGroup().id, deployment().name)]"
Az alábbi példa bemutatja, hogyan hozhat létre egyedi nevet egy tárfióknak az erőforráscsoport alapján. Az erőforráscsoporton belül a név nem egyedi, ha ugyanúgy épül fel.
"resources": [{
"name": "[concat('storage', uniqueString(resourceGroup().id))]",
"type": "Microsoft.Storage/storageAccounts",
...
Ha minden sablon üzembe helyezésekor létre kell hoznia egy új egyedi nevet, és nem kívánja frissíteni az erőforrást, használhatja az utcNow függvényt a következőveluniqueString
: . Ezt a megközelítést tesztkörnyezetben is használhatja. Példa: utcNow.
Visszaadott érték
Egy 13 karakterből álló sztring.
Példák
Az alábbi példa a következő eredményből ad uniquestring
vissza eredményeket:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"uniqueRG": {
"type": "string",
"value": "[uniqueString(resourceGroup().id)]"
},
"uniqueDeploy": {
"type": "string",
"value": "[uniqueString(resourceGroup().id, deployment().name)]"
}
}
}
Uri
uri(baseUri, relativeUri)
Abszolút URI-t hoz létre a baseUri és a relativeUri sztring kombinálásával.
A Bicepben használja az uri függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
baseUri | Igen | húr | Az alap uri sztring. Ügyeljen arra, hogy megfigyelje a záró perjel (/ ) kezelésével kapcsolatos viselkedést az alábbi táblázat szerint. |
relativeUri | Igen | húr | Az alap URI-sztringhez hozzáadandó relatív URI-sztring. |
Ha
baseUri
záró perjellel végződik, az eredményt egyszerűenbaseUri
arelativeUri
következő követi: . HarelativeUri
a kezdő perjellel is kezdődik, a záró perjel és a vezető perjel egybe lesz kombinálva.Ha
baseUri
nem végződik záró perjellel, két dolog egyike történik.Ha
baseUri
egyáltalán nincsenek perjelek (az//
elöl lévőtől eltekintve), azbaseUri
eredményt a következő követirelativeUri
: .Ha
baseUri
vannak perjelei, de nem végződik perjellel, az utolsó perjeltőlbaseUri
kezdve minden el lesz távolítva, és az eredménytbaseUri
arelativeUri
program követi.
Íme néhány példa:
uri('http://contoso.org/firstpath', 'myscript.sh') -> http://contoso.org/myscript.sh
uri('http://contoso.org/firstpath/', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/', '/myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json/', 'myscript.sh') -> http://contoso.org/firstpath/azuredeploy.json/myscript.sh
A részletekért a rendszer az baseUri
relativeUri
RFC 3986 5. szakaszában megadott módon oldja fel a paramétereket és a paramétereket.
Visszaadott érték
Az alap- és relatív értékek abszolút URI-jának sztringje.
Példák
Az alábbi példa bemutatja, hogyan hozhat létre beágyazott sablonra mutató hivatkozást a szülősablon értéke alapján.
"templateLink": "[uri(deployment().properties.templateLink.uri, 'nested/azuredeploy.json')]"
Az alábbi példasablon bemutatja, hogyan használható uri
, uriComponent
és uriComponentToString
hogyan.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
uriOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
componentOutput | Sztring | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
toStringOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
uriComponent
uricomponent(stringToEncode)
Kódolja az URI-t.
A Bicepben használja az uriComponent függvényt .
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
stringToEncode | Igen | húr | A kódolandó érték. |
Visszaadott érték
Az URI kódolt értékének sztringje.
Példák
Az alábbi példasablon bemutatja, hogyan használható uri
, uriComponent
és uriComponentToString
hogyan.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
uriOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
componentOutput | Sztring | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
toStringOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
uriComponentToString
uriComponentToString(uriEncodedString)
Egy URI kódolt érték sztringét adja vissza.
A Bicepben használja az uriComponentToString függvényt.
Paraméterek
Paraméter | Kötelező | Típus | Leírás |
---|---|---|---|
uriEncodedString | Igen | húr | Az URI kódolt értéke, amely sztringgé konvertálható. |
Visszaadott érték
URI kódolt érték dekódolt sztringje.
Példák
Az alábbi példa bemutatja, hogyan használható uri
, uriComponent
és uriComponentToString
hogyan.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-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'))]"
}
}
}
Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:
Név | Típus | Érték |
---|---|---|
uriOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
componentOutput | Sztring | http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json |
toStringOutput | Sztring | http://contoso.com/resources/nested/azuredeploy.json |
Következő lépések
- Az ARM-sablonok szakaszainak leírását az ARM-sablonok szerkezetének és szintaxisának ismertetése című témakörben találja.
- Ha több sablont szeretne egyesíteni, olvassa el a Csatolt és beágyazott sablonok használata Azure-erőforrások üzembe helyezésekor című témakört.
- Ha adott számú alkalommal szeretne iterálni egy erőforrástípus létrehozásakor, tekintse meg az erőforrás-iterációt ARM-sablonokban.
- A létrehozott sablon üzembe helyezéséről az Erőforrások üzembe helyezése ARM-sablonokkal és az Azure PowerShell-lel című témakörben olvashat.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: