Skip to content

Commit a91e56c

Browse files
authored
Merge pull request #208172 from sheisanchez/0815-add-outputs
first round of edits for add outputs template tutorial
2 parents e7bf230 + 5340552 commit a91e56c

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

articles/azure-resource-manager/templates/template-tutorial-add-outputs.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,33 @@
22
title: Tutorial - add outputs to template
33
description: Add outputs to your Azure Resource Manager template (ARM template) to simplify the syntax.
44
author: mumian
5-
ms.date: 03/27/2020
5+
ms.date: 08/17/2022
66
ms.topic: tutorial
77
ms.author: jgao
88
ms.custom:
99
---
1010

1111
# Tutorial: Add outputs to your ARM template
1212

13-
In this tutorial, you learn how to return a value from your Azure Resource Manager template (ARM template). You use outputs when you need a value from a deployed resource. This tutorial takes **7 minutes** to complete.
13+
In this tutorial, you learn how to return a value from your Azure Resource Manager template (ARM template). You use outputs when you need a value for a resource you deploy. This tutorial takes **7 minutes** to complete.
1414

1515
## Prerequisites
1616

1717
We recommend that you complete the [tutorial about variables](template-tutorial-add-variables.md), but it's not required.
1818

19-
You must have Visual Studio Code with the Resource Manager Tools extension, and either Azure PowerShell or Azure CLI. For more information, see [template tools](template-tutorial-create-first-template.md#get-tools).
19+
You need to have Visual Studio Code with the Resource Manager Tools extension, and either Azure PowerShell or Azure Command-Line Interface (CLI). For more information, see [template tools](template-tutorial-create-first-template.md#get-tools).
2020

2121
## Review template
2222

2323
At the end of the previous tutorial, your template had the following JSON:
2424

2525
:::code language="json" source="~/resourcemanager-templates/get-started-with-templates/add-variable/azuredeploy.json":::
2626

27-
It deploys a storage account, but it doesn't return any information about the storage account. You might need to capture properties from a new resource so they're available later for reference.
27+
It deploys a storage account, but it doesn't return any information about it. You might need to capture properties from your new resource so they're available later for reference.
2828

2929
## Add outputs
3030

31-
You can use outputs to return values from the template. For example, it might be helpful to get the endpoints for your new storage account.
31+
You can use outputs to return values from the template. It might be helpful, for example, to get the endpoints for your new storage account.
3232

3333
The following example highlights the change to your template to add an output value. Copy the whole file and replace your template with its contents.
3434

@@ -38,7 +38,7 @@ There are some important items to note about the output value you added.
3838

3939
The type of returned value is set to `object`, which means it returns a JSON object.
4040

41-
It uses the [reference](template-functions-resource.md#reference) function to get the runtime state of the storage account. To get the runtime state of a resource, you pass in the name or ID of a resource. In this case, you use the same variable you used to create the name of the storage account.
41+
It uses the [reference](template-functions-resource.md#reference) function to get the runtime state of the storage account. To get the runtime state of a resource, pass the name or ID of a resource. In this case, you use the same variable you used to create the name of the storage account.
4242

4343
Finally, it returns the `primaryEndpoints` property from the storage account.
4444

@@ -61,7 +61,7 @@ New-AzResourceGroupDeployment `
6161

6262
# [Azure CLI](#tab/azure-cli)
6363

64-
To run this deployment command, you must have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
64+
To run this deployment command, you need to have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
6565

6666
```azurecli
6767
az deployment group create \
@@ -73,7 +73,7 @@ az deployment group create \
7373

7474
---
7575

76-
In the output for the deployment command, you'll see an object similar to the following example only if the output is in JSON format:
76+
In the output for the deployment command, you see an object similar to the following example only if the output is in JSON format:
7777

7878
```json
7979
{
@@ -87,11 +87,11 @@ In the output for the deployment command, you'll see an object similar to the fo
8787
```
8888

8989
> [!NOTE]
90-
> If the deployment failed, use the `verbose` switch to get information about the resources being created. Use the `debug` switch to get more information for debugging.
90+
> If the deployment fails, use the `verbose` switch to get information about the resources being created. Use the `debug` switch to get more information for debugging.
9191
9292
## Review your work
9393

94-
You've done a lot in the last six tutorials. Let's take a moment to review what you have done. You created a template with parameters that are easy to provide. The template is reusable in different environments because it allows for customization and dynamically creates needed values. It also returns information about the storage account that you could use in your script.
94+
You've done a lot in the last six tutorials. Let's take a moment to review what you've done. You created a template with parameters that are easy to provide. The template is reusable in different environments because it allows for customization and dynamically creates needed values. It also returns information about the storage account that you could use in your script.
9595

9696
Now, let's look at the resource group and deployment history.
9797

@@ -123,16 +123,16 @@ Now, let's look at the resource group and deployment history.
123123

124124
If you're moving on to the next tutorial, you don't need to delete the resource group.
125125

126-
If you're stopping now, you might want to clean up the resources you deployed by deleting the resource group.
126+
If you're stopping now, you might want to delete the resource group.
127127

128-
1. From the Azure portal, select **Resource group** from the left menu.
129-
2. Enter the resource group name in the **Filter by name** field.
130-
3. Select the resource group name.
128+
1. From the Azure portal, select **Resource groups** from the left menu.
129+
2. Type the resource group name in the **Filter for any field...** text field.
130+
3. Check the box next to **myResourceGroup** and select **myResourceGroup** or your resource group name.
131131
4. Select **Delete resource group** from the top menu.
132132

133133
## Next steps
134134

135-
In this tutorial, you added a return value to the template. In the next tutorial, you'll learn how to export a template and use parts of that exported template in your template.
135+
In this tutorial, you added a return value to the template. In the next tutorial, you learn how to export a template and use parts of that exported template in your template.
136136

137137
> [!div class="nextstepaction"]
138138
> [Use exported template](template-tutorial-export-template.md)

0 commit comments

Comments
 (0)