Criar cofre de Backup do Azure usando a API REST

Artigo
07/18/2024

A nova plataforma de Proteção de Dados do Backup do Azure fornece funcionalidades aprimoradas para backup e restauração de cargas de trabalho mais recentes, como blobs em contas de armazenamento, disco gerenciado e plataforma PaaS do servidor PostGre SQL. Ela tem como objetivo minimizar a sobrecarga de gerenciamento e, ao mesmo tempo, facilitar a organização de backups. Um "Cofre de Backup" é a base da plataforma de proteção de dados e é diferente do cofre de "Serviços de Recuperação".

As etapas para criar um cofre de Backup do Azure usando a API REST são descritas na documentação de Criação cofre com a API REST. Vamos usar este documento como referência para criar um cofre chamado "testBkpVault" na região "Oeste dos EUA", sob o grupo de recursos "TestBkpVaultRG".

Para criar ou atualizar um cofre de Backup do Azure, use a operação PUT a seguir.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-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=2021-01-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 token de acesso `Bearer` 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	true	BackupVault	Propriedades do cofre
Identidade		DPPIdentityDetails	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 do exemplo a seguir é usado para criar um cofre no "Oeste dos EUA". Especifique o local.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Se você quiser criar um cofre de backup e também gerar uma identidade atribuída pelo sistema, o corpo da solicitação a seguir deverá ser fornecido.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Respostas

A criação de um cofre de backup é uma operação assíncrona. Isso significa que essa operação cria outra operação que precisa ser rastreada separadamente. Há duas respostas bem-sucedidas para a operação criar ou atualizar um cofre de Backup:

Nome	Tipo	Descrição
200 OK	BackupVaultResource	OK
201 Criado	BackupVaultResource	Criado
Outros códigos de status	CloudError

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

Exemplo de resposta

Uma resposta condensada 201 criada do corpo da solicitação de exemplo anterior mostra um id foi atribuído e o provisioningState é bem-sucedido:

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

Próximas etapas

Crie uma política de backup para fazer backup de blobs neste cofre.

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

Compartilhar via