Compartilhar via

Criar cofre de Backup do Azure usando a API REST

Este artigo descreve como criar um cofre de Backup usando a API REST. Você também pode criar um cofre de Backup usando o portal do Azure.

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 em West US sob 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 Bearertoken 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ório Tipo Descrição
eTag fio eTag Opcional
local verdadeiro fio Localização do recurso
properties verdadeiro 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 OKEY
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:

  • Last updated on