| title | Quickstart - Create an Azure Stream Analytics job by Azure Resource Manager template |
|---|---|
| description | This quickstart shows how to use the Azure Resource Manager template to create an Azure Stream Analytics job. |
| ms.service | azure-stream-analytics |
| author | ahartoon |
| ms.author | anboisve |
| ms.topic | quickstart |
| ms.custom | mvc, subject-armqs, mode-arm, devx-track-arm-template |
| ms.date | 08/07/2023 |
In this quickstart, you use an Azure Resource Manager template (ARM template) to create an Azure Stream Analytics job. Once the job is created, you validate the deployment.
[!INCLUDE About Azure Resource Manager]
If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. The template opens in the Azure portal.
:::image type="content" source="~/reusable-content/ce-skilling/azure/media/template-deployments/deploy-to-azure-button.svg" alt-text="Button to deploy the Resource Manager template to Azure." border="false" link="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.streamanalytics%2Fstreamanalytics-create%2Fazuredeploy.json":::
To complete this article, you need to:
- Have an Azure subscription - create one for free.
The template used in this quickstart is from Azure Quickstart Templates.
:::code language="json" source="~/quickstart-templates/quickstarts/microsoft.streamanalytics/streamanalytics-create/azuredeploy.json":::
The Azure resource defined in the template is Microsoft.StreamAnalytics/StreamingJobs: creates an Azure Stream Analytics job.
In this section, you create an Azure Stream Analytics job using the ARM template.
-
Select the following image to sign in to Azure and open a template. The template creates an Azure Stream Analytics job.
:::image type="content" source="~/reusable-content/ce-skilling/azure/media/template-deployments/deploy-to-azure-button.svg" alt-text="Button to deploy the Resource Manager template to Azure." border="false" link="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.streamanalytics%2Fstreamanalytics-create%2Fazuredeploy.json":::
-
Provide the required values to create your Azure Stream Analytics job.
Provide the following values:
Property Description Subscription From the drop-down, select your Azure subscription. Resource group Specify whether you want to create a new resource group or use an existing one. A resource group is a container that holds related resources for an Azure solution. For more information, see Azure Resource Group overview. Region Select East US. For other available regions, see Azure services available by region. Stream Analytics Job Name Provide a name for your Stream Analytics job. Number of Streaming Units Choose the number of streaming units you need. For more information, see Understand and adjust Streaming Units. -
Select Review + Create, then Create.
You can either use the Azure portal to check the Azure Stream Analytics job or use Azure CLI or Azure PowerShell script to list the resource.
After the deployment completes, select Go to resource to navigate to the Stream Analytics Job page for the job.
Use the az stream-analytics job show command to get details about the job you created. Replace placeholders with your Azure subscription ID, resource group name, and Stream Analytics job name.
az stream-analytics job show -s SUBSCRIPTIONID -g RESOURCEGROUPNAME -n ASAJOBNAME
Use the Get-AzStreamAnalyticsJob command to get details about the job you created. Replace placeholders with your Azure subscription ID, resource group name, and Stream Analytics job name.
Get-AzStreamAnalyticsJob -SubscriptionID $subscriptionID -ResourceGroupName $resourceGroupName -Name $streamAnalyticsJobName
If you plan to continue on to subsequent tutorials, you may wish to leave these resources in place. When no longer needed, delete the resource group, which deletes the Azure Stream Analytics job. To delete the resource group by using Azure CLI or Azure PowerShell:
az group delete --name RESOURCEGROUPNAME
Remove-AzResourceGroup -Name RESOURCEGROUPNAME
In this quickstart, you created an Azure Stream Analytics job by using an ARM template and validated the deployment. Advance to the next article to learn how to export an ARM template for an existing job using VS Code.
[!div class="nextstepaction"] Export an Azure Stream Analytics job ARM template