Criar o cofre dos Serviços de Recuperação do Azure usando a API REST para Backup do Azure

Este artigo descreve como criar o cofre dos Serviços de Recuperação do Azure usando a API REST. Para criar o cofre usando o portal do Azure, consulte este artigo.

Um cofre de Serviços de Recuperação é uma entidade de armazenamento no Azure que hospeda dados. Os dados normalmente são cópias de dados ou informações de configuração de VMs (máquinas virtuais), cargas de trabalho, servidores ou estações de trabalho. É possível usar cofres dos Serviços de Recuperação para armazenar dados de backup para vários serviços do Azure, como VMs de IaaS (Windows ou Linux) e o SQL Server em VMs do Azure. Os cofres de Serviços de Recuperação dão suporte a System Center DPM, Windows Server, Servidor de Backup do Azure e outros. Os cofres dos Serviços de Recuperação facilitam a organização dos dados de backup, minimizando a sobrecarga de gerenciamento.

Antes de começar

A criação de um cofre dos Serviços de Recuperação do Azure usando a API REST é descrita no artigo criação da API REST do cofre. Vamos usar este artigo como referência para criar um cofre chamado testVault no West US.

Para criar ou atualizar um cofre dos Serviços de Recuperação do Azure, use a seguinte operação PUT:

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

Criar uma solicitação

Para criar a solicitação PUT, o parâmetro {subscription-id} é obrigatório. Se você tiver várias assinaturas, consulte Trabalhando com várias assinaturas. Defina {resourceGroupName} e {vaultName} para seus recursos, junto com o parâmetro api-version. Este artigo usa api-version=2016-06-01.

Os cabeçalhos a seguir são necessários:

Para saber mais sobre como criar a solicitação, confira Componentes de uma solicitação/resposta de API REST.

Criar o corpo da solicitação

As definições comuns a seguir são usadas para criar um corpo de solicitação:

Observe que o nome do vault e o nome do grupo de recursos são fornecidos no PUT URI. O corpo da solicitação define o local.

Exemplo do corpo de solicitação

O corpo de exemplo a seguir é usado para criar um cofre em West US. Especifique o local. O SKU é sempre Standard.

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "West US"
}

Respostas

Há duas respostas bem-sucedidas para a operação para criar ou atualizar um cofre do Recovery Services:

Para saber mais sobre as respostas da API REST, veja Processar a mensagem de resposta.

Exemplo de resposta

Uma resposta condensada 201 Criado do corpo da solicitação de exemplo anterior mostra uma ID que foi atribuída e o provisioningState é bem-sucedido:

{
  "location": "westus",
  "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"
  }
}

Próximas etapas

Crie uma política de backup para fazer backup de uma VM do Azure neste Vault.

Para obter mais informações sobre as APIs REST do Azure, consulte os seguintes documentos:

• API REST do provedor de serviços de recuperação do Azure
• Iniciar com a API REST do Azure