Criar cofre do Backup do Azure usando a API REST

Artigo
07/18/2024

A nova plataforma de Proteção de Dados do Backup do Azure fornece recursos aprimorados para backup e restauração para cargas de trabalho mais recentes, como blobs em contas de armazenamento, disco gerenciado e plataforma PaaS do servidor PostgreSQL. O objetivo é minimizar a sobrecarga de gerenciamento e, ao mesmo tempo, facilitar a organização de backups. Um "cofre de backup" é a pedra angular da plataforma de proteção de dados e isso é diferente do cofre de "Serviços de recuperação".

As etapas para criar um cofre do Backup do Azure usando a API REST são descritas na documentação da API REST de criação do cofre. Vamos usar este documento como uma referência para criar um cofre chamado "testBkpVault" em "West US" e no grupo de recursos 'TestBkpVaultRG'.

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-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=2021-01-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	verdadeiro	BackupVault	Propriedades do cofre
Identidade		DPPIdentityDetails	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 de exemplo a seguir é usado para criar um cofre em "West US". 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 ao sistema, o seguinte corpo de solicitação deve 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 de criação ou atualização de um cofre de backup:

Nome	Tipo	Description
200 OK	BackupVaultResource	OK
201 Criado	BackupVaultResource	Criado
Outros códigos de status	CloudError

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:

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

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:

Partilhar via