Übersicht über Bicep-Funktionen
In diesem Artikel werden alle Funktionen beschrieben, die Sie in einer Bicep-Datei verwenden können. Informationen zum Definieren benutzerdefinierter Funktionen finden Sie unter "Benutzerdefinierte Funktionen". Eine Beschreibung der Abschnitte in einer Bicep-Datei finden Sie unter Bicep-Dateistruktur und -syntax.
Die meisten Funktionen funktionieren auf die gleiche Weise, wenn sie in einer Ressourcengruppe, einem Abonnement, einer Verwaltungsgruppe oder einem Mandanten bereitgestellt werden. Einige Funktionen können nicht in allen Bereichen verwendet werden. Diese sind in den folgenden Listen aufgeführt.
Namespaces für Funktionen
Alle Bicep-Funktionen sind in zwei Namespaces enthalten: az und sys. In der Regel müssen Sie den Namespace nicht angeben, wenn Sie die Funktion verwenden. Sie geben den Namespace nur an, wenn der Funktionsname mit einem anderen Element identisch ist, das Sie in der Bicep-Datei definiert haben. Wenn Sie beispielsweise einen Parameter mit dem Namen range erstellen, müssen Sie die Funktion range unterscheiden, indem Sie den Namespace sys hinzufügen.
// Parameter contains the same name as a function
param range int
// Must use sys namespace to call the function.
// The second use of range refers to the parameter.
output result array = sys.range(1, range)
Der az-Namespace enthält Funktionen, die für eine Azure-Bereitstellung spezifisch sind. Der sys-Namespace enthält Funktionen, die zum Erstellen von Werten genutzt werden. Der sys-Namespace enthält auch Decorators für Parameter und Ressourcenschleifen. Die Namespaces sind in diesem Artikel beschrieben.
Beliebige Funktion
Die any-Funktion wird in Bicep zur Unterstützung bei der Lösung von Problemen in Zusammenhang mit Datentypwarnungen bereitgestellt. Diese Funktion wird im sys-Namespace definiert.
Arrayfunktionen
Die folgenden Funktionen sind für die Arbeit mit Arrays verfügbar. All diese Funktion werden im sys-Namespace definiert.
- array
- concat
- contains
- empty
- indexOf
- first
- flatten
- intersection
- last
- lastIndexOf
- length
- min
- max
- range
- skip
- take
- union
Klassenlose Domänenfunktionen (CIDR)
Die folgenden Funktionen sind für die Arbeit mit CIDR verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Datumsfunktionen
Die folgenden Funktionen sind für die Arbeit mit Datumsangaben verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Funktionen für Bereitstellungswerte
Die folgenden Funktionen sind zum Abrufen von Werten im Zusammenhang mit der Bereitstellung zur verfügbar: Alle diese Funktionen befinden sich im az Namespace:
Dateifunktionen
Die folgenden Funktionen stehen zum Laden des Inhalts aus externen Dateien in Ihre Bicep-Datei zur Verfügung. Alle diese Funktionen befinden sich im sys Namespace:
Lambda-Funktionen
Die folgenden Funktionen sind für die Arbeit mit Lambdaausdrücken verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Logische Funktion
Die folgende Funktion ist für die Arbeit mit logischen Bedingungen verfügbar: Diese Funktion befindet sich im sys Namespace:
Numerische Funktionen
Die folgenden Funktionen sind für die Arbeit mit ganzen Zahlen verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Objektfunktionen
Die folgenden Funktionen sind für die Arbeit mit Objekten verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Parameterdateifunktionen
Die folgenden Funktionen sind für die Verwendung in Bicep-Parameterdateien verfügbar. Alle diese Funktionen befinden sich im sys Namespace:
Ressourcenfunktionen
Die folgenden Funktionen sind zum Abrufen von Ressourcenwerten verfügbar. Die meisten dieser Funktion werden im az-Namespace definiert. Die list Funktionen getSecret verfügen nicht über Namespacequalifizierer, da sie direkt im Ressourcentyp benannt werden:
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (veraltet)
- reference
- resourceId – Dies kann in jedem Bereich verwendet werden, aber die gültigen Parameter ändern sich je nach Bereich.
- subscriptionResourceId
- tenantResourceId
Bereichsfunktionen
Die folgenden Funktionen sind zum Abrufen von Bereichswerten verfügbar. Alle diese Funktionen befinden sich im az Namespace:
- managementGroup
- resourceGroup – Dies kann nur in Bereitstellungen für eine Ressourcengruppe verwendet werden.
- abonnement – Dies kann nur in Bereitstellungen für eine Ressourcengruppe oder ein Abonnement verwendet werden.
- tenant
Zeichenfolgenfunktionen
Bicep stellt die folgenden Funktionen für das Arbeiten mit Zeichenfolgen bereit. Alle diese Funktionen befinden sich im sys Namespace:
- base64
- base64ToJson
- base64ToString
- concat
- contains
- dataUri
- dataUriToString
- empty
- endsWith
- first
- format
- guid
- indexOf
- join
- last
- lastIndexOf
- length
- newGuid
- padLeft
- replace
- skip
- split
- startsWith
- string
- substring
- take
- toLower
- toUpper
- trim
- uniqueString
- uri
- uriComponent
- uriComponentToString
Nächste Schritte
- Informationen zum Durchlaufen einer bestimmten Anzahl von Zeiten beim Erstellen eines Ressourcentyps finden Sie unter Iterative Schleifen in Bicep.
- Informationen zum Bereitstellen der von Ihnen erstellten Bicep-Datei finden Sie unter Bereitstellen von Bicep-Dateien mit der Azure CLI und Azure PowerShell.