Funciones de cadena para plantillas de ARM

Artículo
07/02/2024

Resource Manager ofrece las siguientes funciones para trabajar con cadenas en la plantilla de Azure Resource Manager:

base64
base64ToJson
base64ToString
concat
contains
dataUri
dataUriToString
empty
endsWith
first
format
guid
indexOf
join
json
last
lastIndexOf
length
newGuid
padLeft
replace
skip
split
startsWith
string
substring
take
toLower
toUpper
trim
uniqueString
uri
uriComponent
uriComponentToString

Sugerencia

Se recomienda Bicep porque ofrece las mismas funcionalidades que las plantillas de ARM, y la sintaxis es más fácil de usar. Para más información, consulte funciones de cadena.

base64

base64(inputString)

Devuelve la representación de base64 de la cadena de entrada.

En Bicep, use la función base64.

Parámetros

Parámetro	Obligatorio	Type	Descripción
inputString	Sí	string	Valor que se va a devolver como una representación de base64.

Valor devuelto

Una cadena que contiene la representación en base64.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la función base64.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	one, two, three
toJsonOutput	Object	{"one": "a", "two": "b"}

base64ToJson

base64ToJson(base64Value)

Convierte una representación en base64 a un objeto JSON.

En Bicep, use la función base64ToJson.

Parámetros

Parámetro	Obligatorio	Type	Descripción
base64Value	Sí	string	La representación en base64 para convertir en un objeto JSON.

Valor devuelto

Un objeto JSON.

Ejemplos

En el ejemplo siguiente se utiliza la función base64ToJson para convertir un valor base64:

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	one, two, three
toJsonOutput	Object	{"one": "a", "two": "b"}

base64ToString

base64ToString(base64Value)

Convierte una representación en base64 en una cadena.

En Bicep, use la función base64ToString.

Parámetros

Parámetro	Obligatorio	Type	Descripción
base64Value	Sí	string	La representación en base64 para convertir en una cadena.

Valor devuelto

Una cadena del valor convertido de base64.

Ejemplos

En el ejemplo siguiente se utiliza la función base64ToString para convertir un valor base64:

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
base64Output	String	b25lLCB0d28sIHRocmVl
toStringOutput	String	one, two, three
toJsonOutput	Object	{"one": "a", "two": "b"}

concat

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

Combina varios valores de cadena y devuelve la cadena concatenada, o combina varias matrices y devuelve la matriz concatenada.

En Bicep, use la interpolación de cadenas en lugar de la función concat() para mejorar la legibilidad. Sin embargo, en algunos casos, como el reemplazo de cadenas en cadenas multilínea, es posible que tenga que recurrir al uso de la función concat() o la funciónreplace().

Parámetros

Parámetro	Obligatorio	Type	Descripción
arg1	Sí	cadena o matriz	La primera cadena o matriz para la concatenación.
más argumentos	No	cadena o matriz	Más matrices o cadenas en orden secuencial para la concatenación.

Esta función puede tomar cualquier número de argumentos y puede aceptar cadenas o matrices para los parámetros. Sin embargo, no puede proporcionar ambas a la vez para los parámetros. Las cadenas solo se concatenan con otras cadenas.

Valor devuelto

Una cadena o matriz de valores concatenados.

Ejemplos

En el ejemplo siguiente se muestra cómo combinar dos valores de cadena y devolver una cadena concatenada.

{
  "$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))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
concatOutput	String	prefix-5yj4yjf5mbg72

En el ejemplo siguiente se muestra cómo combinar dos matrices.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
return	Array	["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]

contains

contains(container, itemToFind)

Comprueba si una matriz contiene un valor, un objeto contiene una clave o una cadena contiene una subcadena. La comparación de cadena distingue mayúsculas de minúsculas. Pero, cuando se prueba si un objeto contiene una clave, la comparación no distingue mayúsculas de minúsculas.

En Bicep, use la función contains.

Parámetros

Parámetro	Obligatorio	Type	Descripción
contenedor	Sí	matriz, objeto o cadena	El valor que contiene el valor para buscar.
itemToFind	Sí	cadena o entero	El valor para buscar.

Valor devuelto

True si se encuentra el elemento; de lo contrario, False.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar contains con diferentes tipos:

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
stringTrue	Bool	True
stringFalse	Bool	False
objectTrue	Bool	True
objectFalse	Bool	False
arrayTrue	Bool	True
arrayFalse	Bool	False

dataUri

dataUri(stringToConvert)

Convierte un valor en un identificador URI de datos.

En Bicep, use la función dataUri.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToConvert	Sí	string	El valor para convertir en un identificador URI de datos.

Valor devuelto

Una cadena con formato de identificador URI de datos.

Ejemplos

En el ejemplo siguiente se convierte un valor en un identificador URI de datos, y se convierte un identificador URI de datos en una cadena.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
dataUriOutput	String	data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutput	String	Hola mundo.

dataUriToString

dataUriToString(dataUriToConvert)

Convierte un valor con formato de identificador URI de datos en una cadena.

En Bicep, use la función dataUriToString.

Parámetros

Parámetro	Obligatorio	Type	Descripción
dataUriToConvert	Sí	string	El valor del identificador URI para convertir.

Valor devuelto

Una cadena que contiene el valor convertido.

Ejemplos

En la plantilla de ejemplo siguiente se convierte un valor en un identificador URI de datos, y se convierte un identificador URI de datos en una cadena.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
dataUriOutput	String	data:text/plain;charset=utf8;base64,SGVsbG8=
toStringOutput	String	Hola mundo.

empty

empty(itemToTest)

Determina si una matriz, un objeto o una cadena están vacíos.

En Bicep, use la función empty.

Parámetros

Parámetro	Obligatorio	Type	Descripción
itemToTest	Sí	matriz, objeto o cadena	El valor para comprobar si está vacío.

Valor devuelto

Devuelve True si el valor está vacío; de lo contrario, False.

Ejemplos

En el ejemplo siguiente se comprueba si una matriz, un objeto y una cadena están vacíos.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayEmpty	Bool	True
objectEmpty	Bool	True
stringEmpty	Bool	True

endsWith

endsWith(stringToSearch, stringToFind)

Determina si una cadena termina con un valor. La comparación distingue entre mayúsculas y minúsculas.

En Bicep, use la función endsWith.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToSearch	Sí	string	El valor que contiene el elemento para buscar.
stringToFind	Sí	string	El valor para buscar.

Valor devuelto

True si el último carácter o caracteres de la cadena coinciden con el valor; de lo contrario, False.

Ejemplos

En el ejemplo siguiente se muestra cómo usar las funciones startsWith y endsWith:

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
startsTrue	Bool	True
startsCapTrue	Bool	True
startsFalse	Bool	False
endsTrue	Bool	True
endsCapTrue	Bool	True
endsFalse	Bool	False

first

first(arg1)

Devuelve el primer carácter de la cadena o el primer elemento de la matriz. Si se proporciona una cadena vacía, la función da como resultado una cadena vacía. En el caso de una matriz vacía, la función devuelve null.

En Bicep, use la función first.

Parámetros

Parámetro	Obligatorio	Type	Descripción
arg1	Sí	matriz o cadena	El valor para recuperar el primer elemento o carácter.

Valor devuelto

Una cadena del primer carácter, o el tipo (cadena, entero, matriz u objeto) del primer elemento en una matriz.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar la primera función con una matriz y una cadena.

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayOutput	String	one
stringOutput	String	O

format

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

Crea una cadena con formato a partir de valores de entrada.

En Bicep, use la función format.

Parámetros

Parámetro	Obligatorio	Type	Descripción
formatString	Sí	string	La cadena de formato compuesta.
arg1	Sí	valor booleano, entero o cadena	El valor que se va a incluir en la cadena con formato.
más argumentos	No	valor booleano, entero o cadena	Más valores para incluir en la cadena con formato.

Observaciones

Utilice esta función para dar formato a una cadena en la plantilla. Usa las mismas opciones de formato que el método System.String.Format en. NET.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la función format.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
formatTest	String	Hola, usuario. Número con formato: 8 175 133

guid

guid(baseString, ...)

Crea un valor en el formato de un identificador único global en función de los valores proporcionados como parámetros.

En Bicep, use la función guid.

Parámetros

Parámetro	Obligatorio	Type	Descripción
baseString	Sí	string	El valor utilizado en la función hash para crear el GUID.
más parámetros, según sea necesario	No	string	Puede agregar tantas cadenas como necesite para crear el valor que especifica el nivel de unicidad.

Observaciones

Esta función es útil cuando se necesita crear un valor en el formato de un identificador único global. Proporciona valores de parámetros que limitan el ámbito de unicidad del resultado. Puede especificar si el nombre es único para la suscripción, el grupo de recursos o la implementación.

El valor devuelto no es una cadena aleatoria, sino que es el resultado de una función hash en los parámetros. El valor devuelto tiene 36 caracteres. No es único globalmente. Para crear un nuevo GUID que no se base en el valor hash de los parámetros, use la función newGuid.

En los ejemplos siguientes se muestra cómo utilizar un GUID para crear un valor único para niveles de uso común.

Único basado en la suscripción

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

Único basado en el grupo de recursos

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

Único basado en la implementación de un grupo de recursos

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

La función guid implementa el algoritmo de RFC 4122 §4.3. El origen original se puede encontrar en GuidUtility con algunas modificaciones.

Valor devuelto

Una cadena que contiene 36 caracteres en el formato de un identificador único global.

Ejemplos

En el ejemplo siguiente se devuelven los resultados de guid:

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

Devuelve la primera posición de un valor dentro de una cadena. La comparación distingue entre mayúsculas y minúsculas.

En Bicep, use la función indexOf.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToSearch	Sí	string	El valor que contiene el elemento para buscar.
stringToFind	Sí	string	El valor para buscar.

Valor devuelto

Un entero que representa la posición del elemento que se va a buscar. El valor está basado en cero. Si no se encuentra el elemento, se devuelve -1.

Ejemplos

En el ejemplo siguiente se muestra cómo usar las funciones indexOf y lastIndexOf:

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	-1

join

join(inputArray, delimiter)

Combina una matriz de cadenas en una sola cadena, separadas mediante un delimitador.

En Bicep, use la función join.

Parámetros

Parámetro	Obligatorio	Type	Descripción
inputArray	Yes	matriz de cadena	Matriz de cadenas que se van a combinar.
delimiter	Sí	Delimitador que se utilizará para dividir la cadena.

Valor devuelto

Una cadena.

Ejemplos

En el ejemplo siguiente se combina la matriz de cadenas de entrada en cadenas delimitadas mediante delimitadores diferentes.

{
  "$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'), ';')]"
    }
  }
}

El resultado del ejemplo anterior es:

Nombre	Tipo	Value
firstOutput	String	"una,dos,tres"
secondOutput	String	"una;dos;tres"

json

json(arg1)

Convierte una cadena JSON válida en un tipo de datos JSON. Para más información, consulte función de json.

En Bicep, use la función json.

last

last(arg1)

Devuelve el último carácter de la cadena, o el último elemento de la matriz.

En Bicep, use la función last.

Parámetros

Parámetro	Obligatorio	Type	Descripción
arg1	Sí	matriz o cadena	El valor para recuperar el último elemento o carácter.

Valor devuelto

Una cadena del último carácter, o el tipo (cadena, entero, matriz u objeto) del último elemento de una matriz.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar la función last con una matriz y una cadena.

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayOutput	String	three
stringOutput	String	e

lastIndexOf

lastIndexOf(stringToSearch, stringToFind)

Devuelve la última posición de un valor dentro de una cadena. La comparación distingue entre mayúsculas y minúsculas.

En Bicep, use la función lastIndexOf.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToSearch	Sí	string	El valor que contiene el elemento para buscar.
stringToFind	Sí	string	El valor para buscar.

Valor devuelto

Un entero que representa la última posición del elemento que se va a buscar. El valor está basado en cero. Si no se encuentra el elemento, se devuelve -1.

Ejemplos

En el ejemplo siguiente se muestra cómo usar las funciones indexOf y lastIndexOf:

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	-1

length

length(string)

Devuelve el número de caracteres en una cadena, elementos en una matriz o propiedades de nivel raíz en un objeto.

En Bicep, use la función length.

Parámetros

Parámetro	Obligatorio	Type	Descripción
arg1	Sí	matriz, cadena u objeto	La matriz que se usará para obtener el número de elementos, la cadena que se usará para obtener el número de caracteres o el objeto que se usará para obtener el número de propiedades del nivel raíz.

Valor devuelto

Un entero.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la función length con una matriz y una cadena:

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayLength	Int	3
stringLength	Int	13
objectLength	Int	4

newGuid

newGuid()

Devuelve un valor en el formato de un identificador único global. Esta función solo puede utilizarse en el valor predeterminado para un parámetro.

En Bicep, use la función newGuid.

Observaciones

Solo puede usar esta función dentro de una expresión para el valor predeterminado de un parámetro. El uso de esta función en cualquier otro lugar de una plantilla genera un error. La función no se permite en otras partes de la plantilla porque devuelve un valor diferente cada vez que se le llama. La implementación de la misma plantilla con los mismos parámetros no produciría de forma confiable los mismos resultados.

La función newGuid difiere de la función guid en que no toma ningún parámetro. Cuando se llama a guid con el mismo parámetro, devuelve el mismo identificador cada vez. Use guid cuando necesite generar de forma confiable el mismo GUID para un entorno específico. Use newGuid cuando necesite un identificador diferente cada vez, como en la implementación de recursos en un entorno de prueba.

La función newGuid usa la estructura de GUID en .NET Framework para generar el identificador único global.

Si usa la opción de volver a implementar una implementación que se completó correctamente en un momento anterior y esa implementación anterior incluye un parámetro que usa newGuid, el parámetro no se vuelve a evaluar. En su lugar, el valor del parámetro de la implementación anterior se reutiliza automáticamente en la implementación de reversión.

En un entorno de prueba, es posible que deba implementar repetidamente recursos que solo duran un corto tiempo. En lugar de construir nombres únicos, puede usar newGuid con uniqueString para crear nombres únicos.

Tenga cuidado al volver a implementar una plantilla que se base en la función newGuid para un valor predeterminado. Si vuelve a implementar y no proporciona un valor para el parámetro, la función se vuelve a evaluar. Si desea actualizar un recurso existente en lugar de crear uno nuevo, pase el valor de parámetro de la implementación anterior.

Valor devuelto

Una cadena que contiene 36 caracteres en el formato de un identificador único global.

Ejemplos

En el ejemplo siguiente se muestra un parámetro con un nuevo identificador.

{
  "$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')]"
    }
  }
}

El resultado del ejemplo anterior varía para cada implementación, pero será similar a:

Nombre	Tipo	Value
guidOutput	string	b76a51fc-bd72-4a77-b9a2-3c29e7d2e551

En el ejemplo siguiente se usa la función newGuid para crear un nombre único para una cuenta de almacenamiento. Esta plantilla puede funcionar en el entorno de prueba donde la cuenta de almacenamiento existe durante un breve tiempo y no se vuelve a implementar.

{
  "$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')]"
    }
  }
}

El resultado del ejemplo anterior varía para cada implementación, pero será similar a:

Nombre	Tipo	Value
nameOutput	string	storagenziwvyru7uxie

padLeft

padLeft(valueToPad, totalLength, paddingCharacter)

Devuelve una cadena alineada a la derecha agregando caracteres a la izquierda hasta alcanzar la longitud total especificada.

En Bicep, use la función padLeft.

Parámetros

Parámetro	Obligatorio	Type	Descripción
valueToPad	Sí	cadena o entero	Valor que se va a alinear a la derecha.
totalLength	Sí	int	El número total de caracteres de la cadena devuelta.
paddingCharacter	No	carácter individual	El carácter que se va a usar para el relleno a la izquierda hasta alcanza la longitud total. El valor predeterminado es un espacio.

Si la cadena original es mayor que el número de caracteres que se va a rellenar, no se agrega ningún carácter.

Valor devuelto

Una cadena con al menos el número de caracteres especificados.

Ejemplos

En el ejemplo siguiente se muestra cómo rellenar el valor del parámetro proporcionado por el usuario agregando el carácter cero hasta que alcance el número total de caracteres.

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
stringOutput	String	0000000123

replace

replace(originalString, oldString, newString)

Devuelve una nueva cadena con todas las instancias de una cadena reemplazadas por otra cadena.

En Bicep, use la función replace.

Parámetros

Parámetro	Obligatorio	Type	Descripción
originalString	Sí	string	Valor que tiene todas las instancias de una cadena reemplazadas por otra cadena.
oldString	Sí	string	Cadena que se va a quitar de la cadena original.
newString	Sí	string	La cadena que se va a agregar en lugar de la cadena eliminada.

Valor devuelto

Una cadena con los caracteres reemplazados.

Ejemplos

El ejemplo siguiente muestra cómo quitar todos los guiones de la cadena proporcionada por el usuario y cómo reemplazar parte de la cadena por otra cadena.

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
firstOutput	String	1231231234
secondOutput	String	123-123-xxxx

skip

skip(originalValue, numberToSkip)

Devuelve una cadena con todos los caracteres después del número especificado de caracteres, o una matriz con todos los elementos después del número especificado de elementos.

En Bicep, use la función skip.

Parámetros

Parámetro	Obligatorio	Type	Descripción
originalValue	Sí	matriz o cadena	La matriz o cadena que se usará para la omisión.
numberToSkip	Sí	int	El número de elementos o caracteres que se van a omitir. Si este valor es 0 o un valor inferior, se devuelven todos los elementos o caracteres del valor. Si es mayor que la longitud de la matriz o la cadena, se devuelve una matriz o cadena vacía.

Valor devuelto

Una matriz o cadena.

Ejemplos

En el ejemplo siguiente se omite el número especificado de elementos de la matriz, y el número especificado de caracteres de la cadena.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayOutput	Array	["three"]
stringOutput	String	two three

split

split(inputString, delimiter)

Devuelve una matriz de cadenas que contiene las subcadenas de la cadena de entrada que están delimitadas por los delimitadores especificados.

En Bicep, use la función split.

Parámetros

Parámetro	Obligatorio	Type	Descripción
inputString	Sí	string	La cadena que se va a dividir.
delimiter	Sí	cadena o matriz de cadenas	Delimitador que se utilizará para dividir la cadena.

Valor devuelto

Una matriz de cadenas.

Ejemplos

En el ejemplo siguiente se divide la cadena de entrada con una coma, y con una coma o un punto y coma.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
firstOutput	Array	["one", "two", "three"]
secondOutput	Array	["one", "two", "three"]

startsWith

startsWith(stringToSearch, stringToFind)

Determina si una cadena empieza con un valor. La comparación distingue entre mayúsculas y minúsculas.

En Bicep, use la función startsWith.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToSearch	Sí	string	El valor que contiene el elemento para buscar.
stringToFind	Sí	string	El valor para buscar.

Valor devuelto

True si el primer carácter o caracteres de la cadena coinciden con el valor; de lo contrario, False.

Ejemplos

En el ejemplo siguiente se muestra cómo usar las funciones startsWith y endsWith:

{
  "$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')]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
startsTrue	Bool	True
startsCapTrue	Bool	True
startsFalse	Bool	False
endsTrue	Bool	True
endsCapTrue	Bool	True
endsFalse	Bool	False

string

string(valueToConvert)

Convierte el valor especificado a una cadena.

En Bicep, use la función string.

Parámetros

Parámetro	Obligatorio	Type	Descripción
valueToConvert	Sí	Any	El valor que se convierte en cadena. Se puede convertir cualquier tipo de valor, incluidos objetos y matrices.

Valor devuelto

Cadena del valor convertido.

Ejemplos

En el ejemplo siguiente se muestra cómo convertir distintos tipos de valores en cadenas.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
objectOutput	String	{"valueA":10,"valueB":"Example Text"}
arrayOutput	String	["a","b","c"]
intOutput	String	5

substring

substring(stringToParse, startIndex, length)

Devuelve una subcadena que empieza en la posición de carácter especificada y que contiene el número especificado de caracteres.

En Bicep, use la función substring.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToParse	Sí	string	La cadena original desde la que se extrae la subcadena.
startIndex	No	int	La posición de carácter inicial basado en cero de la subcadena.
length	No	int	El número de caracteres de la subcadena. Debe hacer referencia a una ubicación dentro de la cadena. Debe ser cero o mayor. Si se omite, se devuelve el resto de la cadena desde la posición inicial.

Valor devuelto

Subcadena. O bien, una cadena vacía si la longitud es cero.

Observaciones

La función genera un error cuando la subcadena supera el final de la cadena, o bien cuando la longitud es menor que cero. En el ejemplo siguiente se produce el error "Los parámetros index y length deben hacer referencia a una ubicación dentro de la cadena. El parámetro index: "0", el parámetro length: "11", la longitud del parámetro string: "10".

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

Ejemplos

En el ejemplo siguiente se extrae una subcadena de un parámetro.

{
  "$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)]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
substringOutput	String	two

take

take(originalValue, numberToTake)

Devuelve una matriz o una cadena. Una matriz tiene el número especificado de elementos desde el principio de la matriz. Una cadena tiene el número especificado de caracteres desde el principio de la cadena.

En Bicep, use la función take.

Parámetros

Parámetro	Obligatorio	Type	Descripción
originalValue	Sí	matriz o cadena	La matriz o cadena de la que se van a tomar los elementos.
numberToTake	Sí	int	El número de elementos o caracteres que se van a tomar. Si este valor es 0 o un valor inferior, se devolverá una matriz o cadena vacía. Si es mayor que la longitud de la matriz o cadena especificada, se devuelven todos los elementos de la matriz o cadena.

Valor devuelto

Una matriz o cadena.

Ejemplos

En el ejemplo siguiente se toma el número especificado de elementos de la matriz y de caracteres de la cadena.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
arrayOutput	Array	["one", "two"]
stringOutput	String	en

toLower

toLower(stringToChange)

Convierte la cadena especificada a minúsculas.

En Bicep, use la función toLower.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToChange	Sí	string	Valor que se va a convertir a minúsculas.

Valor devuelto

Cadena convertida a minúsculas.

Ejemplos

En el siguiente ejemplo se convierte un valor de parámetro a minúsculas y a mayúsculas.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
toLowerOutput	String	one two three
toUpperOutput	String	ONE TWO THREE

toUpper

toUpper(stringToChange)

Convierte la cadena especificada a mayúsculas.

En Bicep, use la función toUpper.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToChange	Sí	string	Valor que se va a convertir a mayúsculas.

Valor devuelto

Cadena convertida a mayúsculas.

Ejemplos

En el siguiente ejemplo se convierte un valor de parámetro a minúsculas y a mayúsculas.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
toLowerOutput	String	one two three
toUpperOutput	String	ONE TWO THREE

trim

trim(stringToTrim)

Quita todos los caracteres de espacio en blanco iniciales y finales de la cadena especificada.

En Bicep, use la función trim.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToTrim	Sí	string	Valor que se recortará.

Valor devuelto

Cadena sin caracteres de espacio en blanco iniciales ni finales.

Ejemplos

En el ejemplo siguiente se recortan los caracteres de espacio en blanco del parámetro.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
return	String	one two three

uniqueString

uniqueString(baseString, ...)

Crea una cadena de hash determinista basada en los valores proporcionados como parámetros.

En Bicep, use la función uniqueString.

Parámetros

Parámetro	Obligatorio	Type	Descripción
baseString	Sí	string	Valor utilizado en la función hash para crear una cadena única.
más parámetros, según sea necesario	No	string	Puede agregar tantas cadenas como necesite para crear el valor que especifica el nivel de unicidad.

Observaciones

Esta función es útil cuando se debe crear un nombre único para un recurso. Proporciona valores de parámetros que limitan el ámbito de unicidad del resultado. Puede especificar si el nombre es único para la suscripción, el grupo de recursos o la implementación.

El valor devuelto no es una cadena aleatoria, sino que es el resultado de una función hash. El valor devuelto tiene 13 caracteres. No es único globalmente. Puede que desee combinar el valor con un prefijo de su convención de nomenclatura para crear un nombre que sea más fácil de reconocer. En el ejemplo siguiente se muestra el formato del valor devuelto. El valor real varía según los parámetros proporcionados.

tcvhiyu5h2o5o

En los ejemplos siguientes se muestra cómo utilizar uniqueString para crear un valor único para niveles de uso común.

Único basado en la suscripción

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

Único basado en el grupo de recursos

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

Único basado en la implementación de un grupo de recursos

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

En el ejemplo siguiente se muestra cómo crear un nombre único para una cuenta de almacenamiento basada en el grupo de recursos. Dentro del grupo de recursos, el nombre no es único si se crea de la misma manera.

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

Si necesita crear un nuevo nombre único cada vez que implemente una plantilla y no tiene intención de actualizar el recurso, puede usar la función utcNow con uniqueString. Podría utilizar este enfoque en un entorno de prueba. Para ver un ejemplo, consulte utcNow.

Valor devuelto

Cadena que contiene 13 caracteres.

Ejemplos

En el ejemplo siguiente se devuelven los resultados de uniquestring:

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

Crea un URI absoluto mediante la combinación de la cadena de relativeUri y baseUri.

En Bicep, use la función uri.

Parámetros

Parámetro	Obligatorio	Type	Descripción
baseUri	Sí	string	La cadena de uri base. Preste atención para observar el comportamiento relacionado con el control de la barra diagonal final (`/`), tal y como se describe a continuación en esta tabla.
relativeUri	Sí	string	La cadena de uri relativo que se agregará a la cadena de uri base.

Si baseUri termina con una barra diagonal final, el resultado simplemente va baseUri seguido de relativeUri. Si relativeUri también comienza con una barra diagonal inicial, la barra diagonal final y la barra diagonal inicial se combinarán en una.
Si baseUri no termina en una barra diagonal final se produce una de las dos cosas.
- Si baseUri no tiene barras diagonales en absoluto (aparte de cerca // del frente), el resultado va baseUri seguido de relativeUri.
- Si baseUri tiene algunas barras diagonales, pero no termina con una barra diagonal, todo desde la última barra diagonal se quita de baseUri y el resultado va baseUri seguido de relativeUri.

Estos son algunos ejemplos:

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

Para obtener detalles completos, los baseUri parámetros y relativeUri se resuelven como se especifica en RFC 3986, sección 5.

Valor devuelto

Una cadena que representa el identificador URI absoluto para los valores base y relativos.

Ejemplos

En el ejemplo siguiente se muestra cómo construir un vínculo a una plantilla anidada en función del valor de la plantilla principal.

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

En la plantilla de ejemplo siguiente se muestra cómo usar uri, uriComponent y uriComponentToString.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
uriOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	String	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponent

uricomponent(stringToEncode)

Codifica un identificador URI.

En Bicep, use la función uriComponent.

Parámetros

Parámetro	Obligatorio	Type	Descripción
stringToEncode	Sí	string	El valor para codificar.

Valor devuelto

Una cadena del valor codificado por el identificador URI.

Ejemplos

En la plantilla de ejemplo siguiente se muestra cómo usar uri, uriComponent y uriComponentToString.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
uriOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	String	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponentToString

uriComponentToString(uriEncodedString)

Devuelve una cadena del valor codificado por el identificador URI.

En Bicep, use la función uriComponentToString.

Parámetros

Parámetro	Obligatorio	Type	Descripción
uriEncodedString	Sí	string	El valor codificado por el identificador URI para convertir en una cadena.

Valor devuelto

Una cadena descodificada del valor codificado por el identificador URI.

Ejemplos

En el ejemplo siguiente, se muestra cómo usar uri, uriComponent y uriComponentToString.

{
  "$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'))]"
    }
  }
}

La salida del ejemplo anterior con el valor predeterminado es:

Nombre	Tipo	Value
uriOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	String	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	String	`http://contoso.com/resources/nested/azuredeploy.json`

Pasos siguientes

Puede encontrar una descripción de las secciones de una plantilla de Azure Resource Manager en Nociones sobre la estructura y la sintaxis de las plantillas de Resource Manager.
Para combinar varias plantillas, consulte Uso de plantillas vinculadas y anidadas al implementar recursos de Azure.
Para iterar un número especificado de veces al crear un tipo de recurso, consulte Iteración de recursos en las plantillas de Resource Manager.
Para ver cómo implementar la plantilla que ha creado, consulte Implementación de recursos con plantillas de Resource Manager y Azure PowerShell.

Compartir a través de

Funciones de cadena para plantillas de ARM

base64

Parámetros

Valor devuelto

Ejemplos

base64ToJson

Parámetros

Valor devuelto

Ejemplos

base64ToString

Parámetros

Valor devuelto

Ejemplos

concat

Parámetros

Valor devuelto

Ejemplos

contains

Parámetros

Valor devuelto

Ejemplos

dataUri

Parámetros

Valor devuelto

Ejemplos

dataUriToString

Parámetros

Valor devuelto

Ejemplos

empty

Parámetros

Valor devuelto

Ejemplos

endsWith

Parámetros

Valor devuelto

Ejemplos

first

Parámetros

Valor devuelto

Ejemplos

format

Parámetros

Observaciones

Ejemplos

guid

Parámetros

Observaciones

Valor devuelto

Ejemplos

indexOf

Parámetros

Valor devuelto

Ejemplos

join

Parámetros

Valor devuelto

Ejemplos

json

last

Parámetros

Valor devuelto

Ejemplos

lastIndexOf

Parámetros

Valor devuelto

Ejemplos

length

Parámetros

Valor devuelto

Ejemplos

newGuid

Observaciones

Valor devuelto

Ejemplos

padLeft

Parámetros

Valor devuelto

Ejemplos