Quickstart: Media Services account ARM template
Warning
Azure Media Services will be retired June 30th, 2024. For more information, see the AMS Retirement Guide.
This article shows you how to use an Azure Resource Manager template (ARM template) to create a media services account.
Readers who are experienced with ARM templates can continue to the deployment section.
Prerequisites
If you don't have an Azure subscription, create a trial account before you begin.
If you have never deployed an ARM template before, it is helpful to read about Azure ARM templates and go through the tutorial.
Review the template
The template used in this quickstart is from Azure Quickstart Templates.
Three Azure resource types are defined in the template:
- Microsoft.Storage/storageAccounts: create a storage account
- Microsoft.Media/mediaservices: create a Media Services account
Set the account
az account set --subscription {your subscription name or id}
Create a resource group
az group create --name {the name you want to give your resource group} --location "{pick a location}"
Assign a variable to your deployment file
For convenience, create a variable that stores the path to the template file. This variable makes it easier for you to run the deployment commands because you don't have to retype the path every time you deploy.
templateFile="{provide the path to the template file}"
Deploy the template
You will be prompted to enter the media services account name.
az deployment group create --name {the name you want to give to your deployment} --resource-group {the name of resource group you created} --template-file $templateFile
Review deployed resources
You should see a JSON response similar to the below:
{
"id": "/subscriptions/{subscriptionid}/resourceGroups/amsarmquickstartrg/providers/Microsoft.Resources/deployments/amsarmquickstartdeploy",
"location": null,
"name": "amsarmquickstartdeploy",
"properties": {
"correlationId": "{correlationid}",
"debugSetting": null,
"dependencies": [
{
"dependsOn": [
{
"id": "/subscriptions/{subscriptionid}/resourceGroups/amsarmquickstartrg/providers/Microsoft.Storage/storageAccounts/storagey44cfdmliwatk",
"resourceGroup": "amsarmquickstartrg",
"resourceName": "storagey44cfdmliwatk",
"resourceType": "Microsoft.Storage/storageAccounts"
}
],
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/amsarmquickstartrg/providers/Microsoft.Media/mediaServices/{accountname}",
"resourceGroup": "amsarmquickstartrg",
"resourceName": "{accountname}",
"resourceType": "Microsoft.Media/mediaServices"
}
],
"duration": "PT1M10.8615001S",
"error": null,
"mode": "Incremental",
"onErrorDeployment": null,
"outputResources": [
{
"id": "/subscriptions/{subscriptionid}/resourceGroups/amsarmquickstartrg/providers/Microsoft.Media/mediaServices/{accountname}",
"resourceGroup": "amsarmquickstartrg"
},
{
"id": "/subscriptions/{subscriptionid}/resourceGroups/amsarmquickstartrg/providers/Microsoft.Storage/storageAccounts/storagey44cfdmliwatk",
"resourceGroup": "amsarmquickstartrg"
}
],
"outputs": null,
"parameters": {
"mediaServiceName": {
"type": "String",
"value": "{accountname}"
}
},
"parametersLink": null,
"providers": [
{
"id": null,
"namespace": "Microsoft.Media",
"registrationPolicy": null,
"registrationState": null,
"resourceTypes": [
{
"aliases": null,
"apiVersions": null,
"capabilities": null,
"locations": [
"chinaeast2"
],
"properties": null,
"resourceType": "mediaServices"
}
]
},
{
"id": null,
"namespace": "Microsoft.Storage",
"registrationPolicy": null,
"registrationState": null,
"resourceTypes": [
{
"aliases": null,
"apiVersions": null,
"capabilities": null,
"locations": [
"chinaeast2"
],
"properties": null,
"resourceType": "storageAccounts"
}
]
}
],
"provisioningState": "Succeeded",
"templateHash": "{templatehash}",
"templateLink": null,
"timestamp": "2020-11-24T23:25:52.598184+00:00",
"validatedResources": null
},
"resourceGroup": "amsarmquickstartrg",
"tags": null,
"type": "Microsoft.Resources/deployments"
}
In the Azure portal, confirm that your resources have been created.
Clean up resources
If you aren't planning to use the resources you just created, you can delete the resource group.
az group delete --name {name of the resource group}