Create Azure Recovery Services vault using REST API for Azure Backup

This article describes how to create Azure Recovery Services vault using REST API. To create the vault using the Azure portal, see this article.

A Recovery Services vault is a storage entity in Azure that houses data. The data is typically copies of data, or configuration information for virtual machines (VMs), workloads, servers, or workstations. You can use Recovery Services vaults to hold backup data for various Azure services such as IaaS VMs (Linux or Windows) and SQL Server in Azure VMs. Recovery Services vaults support System Center DPM, Windows Server, Azure Backup Server, and more. Recovery Services vaults make it easy to organize your backup data, while minimizing management overhead.

Before you start

The creation of an Azure Recovery Services vault using REST API is outlined in create vault REST API article. Let's use this article as a reference to create a vault named testVault in China North.

To create or update an Azure Recovery Services vault, use the following PUT operation:

PUT https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01

Create a request

To create the PUT request, the {subscription-id} parameter is required. If you have multiple subscriptions, see Working with multiple subscriptions. You define a {resourceGroupName} and {vaultName} for your resources, along with the api-version parameter. This article uses api-version=2016-06-01.

The following headers are required:

For more information about how to create the request, see Components of a REST API request/response.

Create the request body

The following common definitions are used to build a request body:

Note that vault name and resource group name are provided in the PUT URI. The request body defines the location.

Example request body

The following example body is used to create a vault in "China East". Specify the location. The SKU is always "Standard".

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "China East"
}

Responses

There are two successful responses for the operation to create or update a Recovery Services vault:

For more information about REST API responses, see Process the response message.

Example response

A condensed 201 Created response from the previous example request body shows an ID has been assigned and the provisioningState is Succeeded:

{
  "location": "chinaeast",
  "name": "testVault",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
  "type": "Microsoft.RecoveryServices/vaults",
  "sku": {
    "name": "Standard"
  }
}

Next steps

Create a backup policy for backing up an Azure VM in this vault.

For more information on the Azure REST APIs, see the following documents:

• Azure Recovery Services provider REST API
• Get started with Azure REST API