Azure REST API Reference

Introduction to Azure REST APIs

The Azure REST APIs provide a programmatic interface for interacting with Azure services. You can use these APIs to create, manage, and monitor your Azure resources. This documentation covers the core REST API endpoints for various Azure services.

All Azure REST APIs are HTTPS endpoints. Requests must be authenticated. Responses are typically in JSON format.

For a comprehensive list of all available APIs, please refer to the Azure API Browser.

Authentication

Azure REST APIs use Azure Active Directory (Azure AD) for authentication and authorization. You can obtain an access token by using one of the following methods:

  • Service Principal authentication
  • Managed Identities
  • User authentication with OAuth 2.0

The access token must be included in the Authorization header of your requests as a Bearer token: 

Authorization: Bearer <your-access-token>

For more detailed information on authentication, please visit the Azure Identity documentation.

Azure Resource Manager (ARM) APIs

The Azure Resource Manager (ARM) API allows you to deploy, manage, and organize your Azure resources. It provides a unified management layer for all Azure services.

Subscriptions

APIs for managing Azure subscriptions.

List Subscriptions

GET /subscriptions

Retrieves a list of all subscriptions available to the authenticated principal.

Response:
[
    {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000",
        "subscriptionId": "00000000-0000-0000-0000-000000000000",
        "displayName": "My Azure Subscription",
        "state": "Enabled"
    }
]

Resource Groups

APIs for managing resource groups.

Create or Update Resource Group

PUT /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

Creates or updates a resource group.

Request Body:
{
    "location": "eastus",
    "tags": {
        "environment": "production"
    }
}
Response:
{
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup",
    "name": "myResourceGroup",
    "location": "eastus",
    "properties": {
        "provisioningState": "Succeeded"
    },
    "tags": {
        "environment": "production"
    }
}

Delete Resource Group

DELETE /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

Deletes a resource group and all of its resources.

Resources

APIs for managing individual Azure resources.

List Resources by Resource Group

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources

Gets a list of resources within a resource group.

Deployments

APIs for deploying resources using ARM templates.

Create or Update Deployment

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}

Initiates a deployment of resources using an ARM template.

Compute APIs

APIs for managing compute resources like virtual machines and scale sets.

Virtual Machines

Get Virtual Machine

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}

Retrieves information about a virtual machine.

Create or Update Virtual Machine

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}

Creates or updates a virtual machine.

Delete Virtual Machine

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}

Deletes a virtual machine.

Virtual Machine Scale Sets

APIs for managing virtual machine scale sets.

Disks

APIs for managing Azure managed disks.

Networking APIs

APIs for managing network resources.

Virtual Networks

Get Virtual Network

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}

Retrieves information about a virtual network.

Load Balancers

APIs for managing Azure Load Balancers.

Public IP Addresses

APIs for managing Azure Public IP Addresses.

Storage APIs

APIs for interacting with Azure Storage services.

Blob Storage

APIs for managing blobs, containers, and storage accounts.

File Storage

APIs for managing Azure Files shares and file data.

Table Storage

APIs for managing Azure Table Storage entities.

Database APIs

APIs for managing Azure database services.

SQL Databases

Get SQL Database

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}

Retrieves information about a SQL database.

Create or Update SQL Database

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}

Creates or updates a SQL database.

Cosmos DB

APIs for managing Azure Cosmos DB accounts, databases, and collections.

Azure Service Management APIs

This section covers APIs for managing specific Azure services not detailed above, such as Azure Functions, App Services, and more. Refer to the individual service documentation for detailed API endpoints.