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 Grundlegendes zur Struktur und Syntax von Bicep-Dateien.
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
CIDR-Funktionen
Die folgenden Funktionen sind für die Arbeit mit CIDR verfügbar. All diese Funktion werden im sys-Namespace definiert.
Datumsfunktionen
Die folgenden Funktionen sind für die Arbeit mit Datumsangaben verfügbar. All diese Funktion werden im sys-Namespace definiert.
Funktionen für Bereitstellungswerte
Die folgenden Funktionen sind zum Abrufen von Werten im Zusammenhang mit der Bereitstellung zur verfügbar: All diese Funktion werden im az-Namespace definiert.
Dateifunktionen
Die folgenden Funktionen stehen zum Laden des Inhalts aus externen Dateien in Ihre Bicep-Datei zur Verfügung. All diese Funktion werden im sys-Namespace definiert.
Lambda-Funktionen
Die folgenden Funktionen sind für die Arbeit mit Lambdaausdrücken verfügbar. All diese Funktion werden im sys-Namespace definiert.
Logische Funktionen
Die folgende Funktion ist für die Arbeit mit logischen Bedingungen verfügbar: Diese Funktion wird im sys-Namespace definiert.
Numerische Funktionen
Die folgenden Funktionen sind für die Arbeit mit ganzen Zahlen verfügbar. All diese Funktion werden im sys-Namespace definiert.
Objektfunktionen
Die folgenden Funktionen sind für die Arbeit mit Objekten verfügbar. All diese Funktion werden im sys-Namespace definiert.
Parameterdateifunktionen
Die folgenden Funktionen sind für die Verwendung in Bicep-Parameterdateien verfügbar. All diese Funktion werden im sys-Namespace definiert.
Ressourcenfunktionen
Die folgenden Funktionen sind zum Abrufen von Ressourcenwerten verfügbar. Die meisten dieser Funktion werden im az-Namespace definiert. Die List-Funktionen und die getSecret-Funktion werden direkt für den Ressourcentyp aufgerufen, sodass sie keinen Namespacequalifizierer haben.
- extensionResourceId
- getSecret
- listAccountSas
- listKeys
- listSecrets
- list*
- managementGroupResourceId
- pickZones
- providers (veraltet)
- Referenz
- resourceId: 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. All diese Funktion werden im az-Namespace definiert.
- managementGroup
- resourceGroup: Kann nur in Bereitstellungen in einer Ressourcengruppe verwendet werden.
- subscription: Kann nur in Bereitstellungen in einer Ressourcengruppe oder einem Abonnement verwendet werden.
- tenant
Zeichenfolgenfunktionen
Bicep stellt die folgenden Funktionen für das Arbeiten mit Zeichenfolgen bereit. All diese Funktion werden im sys-Namespace definiert.
- 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
- Eine Beschreibung der Abschnitte in einer Bicep-Datei finden Sie unter Grundlegendes zur Struktur und Syntax von Bicep-Dateien.
- Wenn Sie beim Erstellen eines Ressourcentyps eine angegebene Anzahl von Wiederholungen durchlaufen möchten, finden Sie weitere Informationen unter Iterative Schleifen in Bicep.
- Informationen zum Bereitstellen der von Ihnen erstellten Bicep-Datei finden Sie unter Bereitstellen von Ressourcen mit Bicep und Azure PowerShell.