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

Artigo
04/10/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.

O cofre dos Serviços de Recuperação é uma entidade de armazenamento no Azure que aloja dados. Os dados são normalmente cópias de dados ou informações de configuração de máquinas virtuais (VMs), cargas de trabalho, servidores ou estações de trabalho. Pode utilizar os cofres dos Serviços de Recuperação para armazenar dados de cópia de segurança de vários serviços do Azure, como VMs IaaS (Linux ou Windows) e SQL Server em VMs do Azure. Os cofres dos Serviços de Recuperação suportam o System Center DPM, o Windows Server, o Servidor de Backup do Azure e muito mais. Os cofres dos Serviços de Recuperação facilitam a organização dos dados de cópia de segurança ao minimizar os custos de gestão.

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 Criar API REST do cofre. Vamos usar este artigo como referência para criar um cofre com o nome testVault de 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 um pedido

Para criar a solicitação PUT , o {subscription-id} parâmetro é necessário. Se tiver várias subscrições, consulte Trabalhar com várias subscrições. Você define um {resourceGroupName} e {vaultName} para seus recursos, juntamente com o api-version parâmetro. Este artigo usa api-version=2016-06-01o .

Os seguintes cabeçalhos são obrigatórios:

Cabeçalho do pedido	Description
Tipo de Conteúdo:	Obrigatório. Definido como `application/json`.
Autorização:	Obrigatório. Definido como um token de acesso `Bearer` válido.

Para obter mais informações sobre como criar a solicitação, consulte Componentes de uma solicitação/resposta da API REST.

Criar o corpo da solicitação

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

Nome	Obrigatório	Type	Description
eTag		String	eTag opcional
localização	verdadeiro	String	Localização do recurso
propriedades		VaultProperties	Propriedades do cofre
sku		Sku	Identifica o identificador exclusivo do sistema para cada recurso do Azure
etiquetas		Object	Etiquetas de recursos

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

Exemplo de corpo da solicitação

O corpo do exemplo a seguir é usado para criar um cofre no 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 de criação ou atualização de um cofre dos Serviços de Recuperação:

Nome	Tipo	Description
200 OK	Cofre	OK
201 Criado	Cofre	Criado

Para obter mais informações sobre respostas da API REST, consulte Processar a mensagem de resposta.

Resposta de exemplo

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

{
  "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óximos passos

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

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

Partilhar via