Criar Azure Backup cofre com a API REST

Artigo
06/01/2023

A nova plataforma de Proteção de Dados da Azure Backup fornece capacidades melhoradas para cópia de segurança e restauro para cargas de trabalho mais recentes, como blobs em contas de armazenamento, disco gerido e plataforma PaaS do servidor PostgreSQL. Tem como objetivo minimizar a sobrecarga de gestão, facilitando a organização de cópias de segurança. Um "Cofre de cópias de segurança" é a pedra angular da plataforma de proteção de dados e isto é diferente do cofre dos "Serviços de Recuperação".

Os passos para criar um cofre de Azure Backup com a API REST estão descritos na documentação da API REST do cofre. Vamos utilizar este documento como referência para criar um cofre chamado "testBkpVault" em "E.U.A. Oeste" e no grupo de recursos "TestBkpVaultRG".

Para criar ou atualizar um cofre de Azure Backup, utilize 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 o pedido PUT , é necessário o {subscription-id} parâmetro. Se tiver várias subscrições, consulte Trabalhar com várias subscrições. Define um {resourceGroupName} e {vaultName} para os seus recursos, juntamente com o api-version parâmetro . Este artigo utiliza api-version=2021-01-01.

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

Cabeçalho do pedido	Descrição
Content-Type:	Necessário. Definido como `application/json`.
Authorization:	Necessário. Defina como um token de acesso válido`Bearer`.

Para obter mais informações sobre como criar o pedido, veja Componentes de um pedido/resposta da API REST.

Criar o corpo do pedido

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

Name	Necessário	Tipo	Descrição
eTag		String	ETag opcional
localização	true	String	Localização do recurso
propriedades	true	BackupVault	Propriedades do cofre
Identidade		DPPIdentityDetails	Identifica o identificador de sistema exclusivo para cada recurso do Azure
etiquetas		Objeto	Etiquetas de recursos

Tenha em atenção que o nome do cofre e o nome do grupo de recursos são fornecidos no URI PUT. O corpo do pedido define a localização.

Corpo do pedido de exemplo

O corpo de exemplo seguinte é utilizado para criar um cofre em "E.U.A. Oeste". Especifique a localização.

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

Se quiser criar um cofre de cópias de segurança e também gerar uma identidade atribuída pelo sistema, deve ser fornecido o seguinte corpo do pedido.

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

Respostas

A criação de um cofre de cópias de segurança é uma operação assíncrona. Significa que esta operação cria outra operação que tem de ser controlada separadamente. Existem duas respostas bem-sucedidas para a operação criar ou atualizar um cofre de Cópia de Segurança:

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

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

Resposta de exemplo

Uma resposta 201 criada condensada a partir do corpo do pedido de exemplo anterior mostra que foi atribuído um ID e o provisioningState foi 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"
  }

Passos seguintes

Crie uma política de cópia de segurança para fazer cópias de segurança de blobs neste cofre.

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