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

Artigo
04/14/2024

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:

Cabeçalho da solicitação	Descrição
Tipo de Conteúdo:	Obrigatórios. Defina como `application/json`.
Autorização:	Obrigatórios. Defina como um `Bearer`token de acesso válido.

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:

Nome	Obrigatória	Type	Descrição
eTag		String	eTag Opcional
local	true	String	Localização do recurso
properties		VaultProperties	Propriedades do cofre
sku		Sku	Identifica o identificador exclusivo do sistema para cada recurso do Azure
marcas		Objeto	Marcações de recursos

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:

Nome	Tipo	Descrição
200 OK	Cofre	OK
201 Criado	Cofre	Criado

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: