[metadata]
adobe-target: true
asset_id: azure-resource-manager/management/manage-resources-rest
author: Xelu86
breadcrumb_path: /azure/bread/toc.json
cmProducts: https://authoring-docs-microsoft.poolparty.biz/devrel/4e834929-0ce1-4c1d-9c81-fcb14721edfb
cmProducts: https://authoring-docs-microsoft.poolparty.biz/devrel/68ec7f3a-2bc6-459f-b959-19beb729907d
color-scheme: light dark
depot_name: Azure.azure-documents
description: Use REST operations with Azure Resource Manager to manage your resources. Shows how to read, deploy, and delete resources.
document_id: 8f842552-68bc-cb48-958c-6a3ed06bc72b
document_version_independent_id: cba555dc-54b5-72a0-2a71-13a4097d0a2e
feedback_help_link_type: get-help-at-qna
feedback_help_link_url: https://learn.microsoft.com/answers/tags/133/azure
feedback_product_url: https://feedback.azure.com/d365community/forum/9a0ece70-ff24-ec11-b6e6-000d3a4f07b8
feedback_system: Standard
git_commit_id: 2f4c9eccb70cfac81f3ad68f5480199c5d0122c1
gitcommit: https://github.com/MicrosoftDocs/azure-docs-pr/blob/2f4c9eccb70cfac81f3ad68f5480199c5d0122c1/articles/azure-resource-manager/management/manage-resources-rest.md
github_feedback_content_git_url: https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-resource-manager/management/manage-resources-rest.md
interactive_type: azurecli,azurepowershell
item_type: Content
learn_banner_products: azure
locale: en-us
markdown_url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/manage-resources-rest?accept=text/markdown
ms.author: jgao
ms.custom: devx-track-arm-template
ms.date: 2026-02-27T00:00:00Z
ms.service: azure-resource-manager
ms.subservice: management
ms.suite: office
ms.topic: article
ms.update-cycle: 365-days
og:description: Use REST operations with Azure Resource Manager to manage your resources. Shows how to read, deploy, and delete resources.
og:image: https://learn.microsoft.com/en-us/media/open-graph-image.png
og:image:alt: Microsoft Learn
og:title: Manage resources - REST - Azure Resource Manager
og:type: website
og:url: https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/manage-resources-rest
original_content_git_url: https://github.com/MicrosoftDocs/azure-docs-pr/blob/live/articles/azure-resource-manager/management/manage-resources-rest.md
page_type: conceptual
pdf_url_template: https://learn.microsoft.com/pdfstore/en-us/Azure.azure-documents/{branchName}{pdfName}
permissioned-type: public
platform_id: 52bb725f-1967-3a19-ba10-4149baea92aa
previous_tlsh_hash: 71EA0181CB1CC201FE932FD60617394147F5424C6AB827CB086117BFC1C93EB9536D3E657F13420A4638D37A12F3BE065182BB72906DD2B9221DDCBA92AC22B37D9572B998
recommendation_types: Certification
recommendation_types: Training
recommendations: true
schema: Conceptual
scope: Azure,Azure management service
site_name: Docs
source_path: articles/azure-resource-manager/management/manage-resources-rest.md
spProducts: https://authoring-docs-microsoft.poolparty.biz/devrel/75670257-a3f0-4627-9981-8046f99219e6
spProducts: https://authoring-docs-microsoft.poolparty.biz/devrel/90370425-aca4-4a39-9533-d52e5e002a5d
toc_rel: toc.json
twitter:card: summary_large_image
twitter:site: @MicrosoftLearn
uhfHeaderId: azure
updated_at: 2026-02-27T18:31:00Z
viewport: width=device-width, initial-scale=1.0
word_count: 730

[canonical-links]
https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/manage-resources-rest

[document-links]
AI Disclaimer: https://learn.microsoft.com/en-us/principles-for-ai-generated-content
Add or remove Azure role assignments using REST: ../../role-based-access-control/role-assignments-rest
Azure Resource Manager REST reference: /en-us/rest/api/resources/
Azure Resource Manager overview: overview
Azure Resource Manager resource group deletion: delete-resource-group
Azure Resource Manager: overview
Azure role-based access control (Azure RBAC): ../../role-based-access-control/overview
Blog: https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog
Consumer Health Privacy: https://go.microsoft.com/fwlink/?linkid=2259814
Contribute: https://learn.microsoft.com/en-us/contribute
Create an Azure Storage account with the REST API: /en-us/rest/api/storagerp/storage-sample-create-account
Create resource group and deploy resources: ../templates/deploy-to-subscription#resource-groups
Deploy Azure resources to multiple subscriptions or resource groups: ../templates/deploy-to-resource-group
Deploy resources with Resource Manager templates and Azure PowerShell: ../templates/deploy-powershell
Deployments - Create Or Update: /en-us/rest/api/resources/deployments/create-or-update
Download Microsoft Edge: https://go.microsoft.com/fwlink/p/?LinkID=2092881
Edit: https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-resource-manager/management/manage-resources-rest.md
Getting Started with REST: /en-us/rest/api/azure/
More info about Internet Explorer and Microsoft Edge: https://learn.microsoft.com/en-us/lifecycle/faq/internet-explorer-microsoft-edge
Previous Versions: https://learn.microsoft.com/en-us/previous-versions/
Privacy: https://go.microsoft.com/fwlink/?LinkId=521839
Quickstart: Create Azure Resource Manager templates by using Visual Studio Code: ../templates/quickstart-create-templates-use-visual-studio-code
Registering your client application with Microsoft Entra ID: /en-us/rest/api/azure/#register-your-client-application-with-azure-ad
Resource Management REST API reference: /en-us/rest/api/resources/
Storage Resource Provider REST API Reference: /en-us/rest/api/storagerp/
Terms of Use: https://learn.microsoft.com/en-us/legal/termsofuse
Trademarks: https://www.microsoft.com/legal/intellectualproperty/Trademarks/
Understand the structure and syntax of Azure Resource Manager templates: ../templates/syntax
Your Privacy Choices: https://aka.ms/yourcaliforniaprivacychoices
step-by-step tutorials: ../
template reference: /en-us/azure/templates/

[content]
Manage resources - REST - Azure Resource Manager | Microsoft Learn
Skip to main content
Skip to Ask Learn chat experience
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Download Microsoft Edge
More info about Internet Explorer and Microsoft Edge
Table of contents
Exit editor mode
Ask Learn
Ask Learn
Reading mode
Table of contents
Read in English
Add
Add to Plans
Edit
Copy Markdown
Print
Note
Access to this page requires authorization. You can try
signing in
or
changing directories
.
Access to this page requires authorization. You can try
changing directories
.
Manage Azure resources by using the REST API
Feedback
Summarize this article for me
In this article
Learn how to use the REST API for
Azure Resource Manager
to manage your Azure resources. For a comprehensive reference of how to structure Azure REST calls, see
Getting Started with REST
. View the
Resource Management REST API reference
for more details on the available operations.
Obtain an access token
To make a REST API call to Azure, you first need to obtain an access token. Include this access token in the headers of your Azure REST API calls using the
Authorization
header and setting the value to
Bearer {access-token}
.
If you need to programmatically retrieve new tokens as part of your application, you can obtain an access token by
Registering your client application with Microsoft Entra ID
.
To test Azure REST APIs using your individual token, retrieve your current access token with either Azure PowerShell or Azure CLI.
Azure CLI
Azure PowerShell
token=$(az account get-access-token --query accessToken --output tsv)
$token = (Get-AzAccessToken).Token
Operation scope
You can call many Azure Resource Manager operations at different scopes:
Type
Scope
Management group
providers/Microsoft.Management/managementGroups/{managementGroupId}
Subscription
subscriptions/{subscriptionId}
Resource group
subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Resource
subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}
List resources
The following REST operation returns the resources within a provided resource group.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01 HTTP/1.1 Authorization: Bearer <bearer-token> Host: management.azure.com
Here's an example cURL command that you can use to list all resources in a resource group using the Azure Resource Manager API:
curl -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'
With the authentication step, this example looks like:
Azure CLI
Azure PowerShell
token=$(az account get-access-token --query accessToken --output tsv) curl -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'
$token = (Get-AzAccessToken).Token $headers = @{Authorization="Bearer $token"} Invoke-WebRequest -Method GET -Headers $headers -Uri 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'
Deploy resources to an existing resource group
You can deploy Azure resources directly by using the REST API, or deploy a Resource Manager template to create Azure resources.
Deploy a resource
The following REST operation creates a storage account. To see this example in more detail, see
Create an Azure Storage account with the REST API
. Complete reference documentation and samples for the Storage Resource Provider are available in the
Storage Resource Provider REST API Reference
.
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01 HTTP/1.1 Authorization: Bearer <bearer-token> Content-Type: application/json Host: management.azure.com { "sku": { "name": "Standard_GRS" }, "kind": "StorageV2", "location": "eastus2", }
Deploy a template
The following operations deploy a Quickstart template to create a storage account. For more information, see
Quickstart: Create Azure Resource Manager templates by using Visual Studio Code
. For the API reference of this call, see
Deployments - Create Or Update
.
PUT /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01 HTTP/1.1 Authorization: Bearer <bearer-token> Content-Type: application/json Host: management.azure.com { "properties": { "templateLink": { "uri": "https://example.com/azuretemplates/azuredeploy.json" }, "parametersLink": { "uri": "https://example.com/azuretemplates/azuredeploy.parameters.json" }, "mode": "Incremental" } }
For the REST APIs, the value of
uri
can't be a local file or a file that is only available on your local network. Azure Resource Manager must access the template. Provide a URI value that is downloadable as HTTP or HTTPS. For more information, see
Deploy resources with Resource Manager templates and Azure PowerShell
.
Deploy a resource group and resources
You can create a resource group and deploy resources to the group by using a template. For more information, see
Create resource group and deploy resources
.
Deploy resources to multiple subscriptions or resource groups
Typically, you deploy all the resources in your template to a single resource group. However, there are scenarios where you want to deploy a set of resources together but place them in different resource groups or subscriptions. For more information, see
Deploy Azure resources to multiple subscriptions or resource groups
.
Delete resources
The following operation shows how to delete a storage account.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2022-09-01 HTTP/1.1 Authorization: Bearer <bearer-token> Host: management.azure.com
For more information about how Azure Resource Manager orders the deletion of resources, see
Azure Resource Manager resource group deletion
.
Manage access to resources
Azure role-based access control (Azure RBAC)
is the way that you manage access to resources in Azure. For more information, see
Add or remove Azure role assignments using REST
.
Next steps
To learn Azure Resource Manager, see
Azure Resource Manager overview
.
To learn more about Azure Resource Manager's supported REST operations, see
Azure Resource Manager REST reference
.
To learn the Resource Manager template syntax, see
Understand the structure and syntax of Azure Resource Manager templates
.
To learn how to develop templates, see the
step-by-step tutorials
.
To view the Azure Resource Manager template schemas, see
template reference
.
Feedback
Was this page helpful?
Yes
No
No
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?
Ask Learn
Ask Learn
Suggest a fix?
Additional resources
Last updated on
2026-02-27
In this article
Was this page helpful?
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?
Ask Learn
Ask Learn
Suggest a fix?
en-us
Your Privacy Choices
Theme
Light
Dark
High contrast
AI Disclaimer
Previous Versions
Blog
Contribute
Privacy
Consumer Health Privacy
Terms of Use
Trademarks
© Microsoft 2026
