Samouczek: korzystanie z dokumentacji szablonu usługi ARM

Dowiedz się, jak znaleźć informacje o schemacie szablonu i używać tych informacji do tworzenia szablonów usługi Azure Resource Manager (szablonów usługi ARM).

W tym samouczku użyjesz szablonu podstawowego z szablonów szybkiego startu platformy Azure. Korzystając z dokumentacji referencyjnej szablonu, należy zweryfikować szablon.

Ten samouczek obejmuje następujące zadania:

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Wymagania wstępne

Aby ukończyć ten artykuł, potrzebujesz programu Visual Studio Code.

Otwieranie szablonu szybkiego startu

Szablony szybkiego startu platformy Azure to repozytorium szablonów usługi ARM. Zamiast tworzyć szablon od podstaw, możesz znaleźć szablon przykładowy i zmodyfikować go. Szablon używany w tym przewodniku Szybki start ma nazwę Create a standard storage account (Tworzenie standardowego konta magazynu). Szablon definiuje zasób konta usługi Azure Storage.

1. W programie Visual Studio Code wybierz pozycję File (Plik)>Open File (Otwórz plik).

2. W polu File name (Nazwa pliku) wklej następujący adres URL:

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. Wybierz pozycję Open (Otwórz), aby otworzyć plik.

4. Wybierz pozycję File (Plik)>Save As (Zapisz jako), aby zapisać plik jako azuredeploy.json na komputerze lokalnym.

Informacje o schemacie

1. W programie Visual Studio Code zwiń szablon na poziom główny. Masz najprostszą strukturę z następującymi elementami:

   

   • $schema: określ lokalizację pliku schematu JSON opisującego wersję języka szablonu.
   • contentVersion: określ dowolną wartość dla tego elementu, aby udokumentować istotne zmiany w szablonie.
   • metadata: określ metadane szablonu.
   • parameters: określ wartości, które są udostępniane podczas wdrażania w celu dostosowania wdrożenia zasobów.
   • variables: określ wartości, które są używane jako fragmenty JSON w szablonie, aby uprościć wyrażenia języka szablonu. Ten szablon nie zawiera tego elementu.
   • resources: określ typy zasobów, które są wdrażane lub aktualizowane w grupie zasobów.
   • outputs: określ wartości zwracane po wdrożeniu.

2. Rozwiń węzeł resources. Microsoft.Storage/storageAccounts Istnieje zdefiniowany zasób. Wersja interfejsu API na powyższym zrzucie ekranu to 2022-09-01. Nazwa jednostki SKU używa wartości parametru. Parametr nosi nazwę storageAccountType.

   

3. Rozwiń, parameters aby zobaczyć sposób storageAccountType definiowania. Parametr ma osiem dozwolonych wartości.

Korzystając z dokumentacji szablonu, możesz dowiedzieć się, czy używasz najnowszej wersji interfejsu API, oraz czy definicja parametru zawiera wszystkie dozwolone wartości.

Znajdowanie dokumentacji szablonu

1. Przejdź do dokumentacji szablonu platformy Azure.

2. W menu po lewej stronie znajdź pozycję Przechowywanie, rozwiń węzeł Przechowywanie, a następnie wybierz pozycję Konta przechowywania

3. Wybierz pozycję Szablon usługi ARM.

4. Typ zasobu zwykle ma kilka wersji interfejsu API. Na tej stronie domyślnie jest wyświetlana najnowsza wersja schematu szablonu. Wybierz pole rozwijane Najnowsze, aby wyświetlić wersje. Najnowsza wersja to 2025-06-01. Wybierz pozycję Najnowszy lub wersję bezpośrednio poniżej pozycji Najnowsze , aby wyświetlić najnowszą wersję. Upewnij się, że ta wersja jest zgodna z wersją używaną dla zasobu konta magazynu w szablonie. Jeśli zaktualizujesz wersję interfejsu API, sprawdź, czy definicja zasobu jest zgodna z odwołaniem do szablonu.

   

5. Na tej stronie wymieniono szczegóły typu zasobu storageAccount. Na przykład wyświetla listę dozwolonych wartości dla obiektu Sku . Istnieją 14 SKU dla wersji API 2025-06-01.

   

Wdrażanie szablonu

1. Zaloguj się do usługi Azure Cloud Shell.

2. Wybierz preferowane środowisko, wybierając pozycję PowerShell lub Bash (dla interfejsu wiersza polecenia) w lewym górnym rogu. Po przełączeniu należy ponownie uruchomić powłokę.

   

3. Wybierz pozycję Przekaż/pobierz pliki, a następnie wybierz pozycję Przekaż. Zobacz powyższy zrzut ekranu. Wybierz plik, który został zapisany w poprzedniej sekcji. Po przekazaniu pliku użyj ls polecenia i cat polecenia , aby sprawdzić, czy plik został pomyślnie przekazany.

4. W usłudze Cloud Shell uruchom następujące polecenia. Wybierz kartę, aby wyświetlić kod programu PowerShell lub kod interfejsu wiersza polecenia.

   Podczas wdrażania szablonu określ storageAccountType parametr z nowo dodaną wartością, na przykład Standard_RAGRS. Wdrożenie zakończy się niepowodzeniem, jeśli używasz oryginalnego szablonu szybkiego startu, ponieważ Standard_RAGRS nie jest dozwoloną wartością.

   • Interfejs wiersza polecenia
   • Program PowerShell

   echo "Enter a project name that is used to generate resource group name:" &&
   read projectName &&
   echo "Enter the location (i.e. centralus):" &&
   read location &&
   resourceGroupName="${projectName}rg" &&
   az group create --name $resourceGroupName --location "$location" &&
   az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
   

Czyszczenie zasobów

Gdy zasoby platformy Azure nie będą już potrzebne, wyczyść wdrożone zasoby, usuwając grupę zasobów.

1. W witrynie Azure Portal wybierz pozycję Grupa zasobów z menu po lewej stronie.
2. Wprowadź nazwę grupy zasobów w polu Filtruj według nazwy.
3. Wybierz nazwę grupy zasobów. W grupie zasobów zostanie wyświetlonych łącznie sześć zasobów.
4. Wybierz pozycję Usuń grupę zasobów z górnego menu.

Następne kroki

W tym samouczku przedstawiono sposób użycia dokumentacji szablonu w celu dostosowania istniejącego szablonu. Aby dowiedzieć się, jak utworzyć wiele wystąpień konta magazynu, zobacz: