Funkcje szablonu usługi ARM

Artykuł
08/05/2023

W tym artykule opisano wszystkie funkcje, których można używać w szablonie usługi Azure Resource Manager (szablon usługi ARM). Aby uzyskać informacje o korzystaniu z funkcji w szablonie, zobacz składnia szablonu.

Aby utworzyć własne funkcje, zobacz Funkcje zdefiniowane przez użytkownika.

Większość funkcji działa tak samo w przypadku wdrożenia w grupie zasobów, subskrypcji, grupie zarządzania lub dzierżawie. Nie można używać kilku funkcji we wszystkich zakresach. Zostały one zanotowe na poniższych listach.

Porada

Zalecamy użycie aplikacji Bicep , ponieważ oferuje te same możliwości co szablony usługi ARM, a składnia jest łatwiejsza. Aby dowiedzieć się więcej, zobacz Funkcje Bicep i operatory Bicep.

Dowolna funkcja

Dowolna funkcja jest dostępna w aplikacji Bicep, aby pomóc w rozwiązywaniu problemów dotyczących ostrzeżeń dotyczących typu danych.

Funkcje tablicy

Resource Manager udostępnia kilka funkcji do pracy z tablicami.

W przypadku plików Bicep użyj funkcji tablicy .

Funkcje CIDR

Poniższe funkcje są dostępne do pracy z funkcją CIDR. Wszystkie te funkcje znajdują się sys w przestrzeni nazw.

Funkcje porównania

Resource Manager udostępnia kilka funkcji do porównywania w szablonach.

W przypadku plików Bicep użyj operatora logicznego łączenie . W przypadku porównań użyj operatorów porównania .

Funkcje daty

Resource Manager udostępnia następujące funkcje do pracy z datami.

W przypadku plików Bicep użyj funkcji daty .

Funkcje wartości wdrożenia

Resource Manager udostępnia następujące funkcje umożliwiające pobieranie wartości z sekcji szablonu i wartości związanych z wdrożeniem:

W przypadku plików Bicep użyj funkcji wdrażania .

Funkcje logiczne

Resource Manager zapewnia następujące funkcje do pracy z warunkami logicznymi:

W przypadku plików Bicep użyj funkcji logicznej bool . W przypadku innych wartości logicznych użyj operatorów logicznych .

Funkcje liczbowe

Resource Manager zapewnia następujące funkcje do pracy z liczbami całkowitymi:

W przypadku plików Bicep, które używają intfunkcji min, i max używają funkcji liczbowych . W przypadku innych wartości liczbowych użyj operatorów liczbowych .

Funkcje obiektów

Resource Manager udostępnia kilka funkcji do pracy z obiektami.

W przypadku plików Bicep użyj funkcji obiektów .

Funkcje zasobów

Resource Manager udostępnia następujące funkcje umożliwiające uzyskiwanie wartości zasobów:

extensionResourceId
listAccountSas
listKeys
listSecrets
Listy*
pickZones
dostawcy (przestarzałe)
Odwołanie
Odwołania
resourceId — może być używany w dowolnym zakresie, ale prawidłowe parametry zmieniają się w zależności od zakresu.
subscriptionResourceId
tenantResourceId

W przypadku plików Bicep użyj funkcji zasobów .

Funkcje zakresu

Resource Manager udostępnia następujące funkcje umożliwiające uzyskanie wartości zakresu wdrożenia:

managementGroup — można jej używać tylko we wdrożeniach w grupie zarządzania.
resourceGroup — można jej używać tylko we wdrożeniach w grupie zasobów.
subskrypcja — można jej używać tylko we wdrożeniach w grupie zasobów lub subskrypcji.
tenant — może służyć do wdrożeń w dowolnym zakresie.

W przypadku plików Bicep użyj funkcji zakresu .

Funkcje ciągów

Resource Manager udostępnia następujące funkcje do pracy z ciągami:

W przypadku plików Bicep użyj funkcji string .

Następne kroki

Opis sekcji w szablonie usługi ARM można znaleźć w temacie Understand the structure and syntax of ARM templates (Omówienie struktury i składni szablonów usługi ARM).
Aby scalić wiele szablonów, zobacz Używanie połączonych i zagnieżdżonych szablonów podczas wdrażania zasobów platformy Azure.
Aby iterować określoną liczbę razy podczas tworzenia typu zasobu, zobacz Iteracja zasobów w szablonach usługi ARM.
Aby zobaczyć, jak wdrożyć utworzony szablon, zobacz Deploy resources with ARM templates and Azure PowerShell (Wdrażanie zasobów przy użyciu szablonów usługi ARM i Azure PowerShell).