Atualizar as configurações do cofre dos Serviços de Recuperação do Azure usando a API REST

Artigo
10/20/2024

Este artigo descreve como atualizar configurações relacionadas a backup no cofre dos Serviços de Recuperação do Azure usando a API REST.

Estado de exclusão temporária

Excluir backups de um item protegido é uma operação significativa que deve ser monitorada. Para proteger contra exclusões acidentais, o cofre dos Serviços de Recuperação do Azure tem uma funcionalidade de exclusão temporária. Essa funcionalidade permite que você restaure backups excluídos, se necessário, dentro de um período após a exclusão.

No entanto, há cenários em que esse recurso não é necessário. Um cofre dos Serviços de Recuperação do Azure não poderá ser excluído se houver itens de backup dentro dele, mesmo os excluídos temporariamente. Isso pode representar um problema se o cofre precisar ser excluído imediatamente. Por exemplo: as operações de implantação geralmente limpam os recursos criados no mesmo fluxo de trabalho. Uma implantação pode criar um cofre, configurar backups para um item, fazer uma restauração de teste e, em seguida, continuar a excluir os itens de backup e o cofre. Se a exclusão do cofre falhar, a implantação inteira poderá falhar. Desabilitar a exclusão temporária é a única maneira de garantir a exclusão imediata.

Portanto, você precisa escolher cuidadosamente a desabilitação do recurso de exclusão temporária para um determinado cofre, dependendo do cenário. Saiba mais sobre a exclusão temporária.

Efetuar fetch do estado de exclusão temporária usando a API REST

Por padrão, o estado de exclusão temporária será habilitado para qualquer cofre dos Serviços de Recuperação recém-criado. Para efetuar fetch/atualizar o estado de exclusão automática para um cofre, use o documento da API REST relacionada à configuração do cofre de backup

Para buscar o estado atual de exclusão temporária para um cofre, use a seguinte operação GET

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

O URI GET tem os parâmetros {subscriptionId}, {vaultName} e {vaultresourceGroupName}. Neste exemplo, {vaultName} é "testVault" e {vaultresourceGroupName} é "testVaultRG". Assim como todos os parâmetros necessários são fornecidos na URI, não é necessário ter o corpo da solicitação separado.

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Respostas

A resposta bem-sucedida para a operação “GET” é mostrada abaixo:

Nome	Tipo	Descrição
200 OK	BackupResourceVaultConfig	OK

Exemplo de resposta

Após uma solicitação “GET” ser enviada, uma resposta 200 (bem-sucedido) será retornada.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Atualizar o estado de exclusão temporária usando a API REST

Para atualizar o estado de exclusão temporária do cofre dos Serviços de Recuperação usando a API REST, use a seguinte operação PUT

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

O URI PUT tem os parâmetros {subscriptionId}, {vaultName} e {vaultresourceGroupName}. Neste exemplo, {vaultName} é "testVault" e {vaultresourceGroupName} é "testVaultRG". Se substituirmos o URI pelos valores acima, o URI terá a seguinte aparência.

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Criar o corpo da solicitação

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

Para obter mais detalhes, confira a documentação da API REST

Nome	Obrigatória	Type	Descrição
eTag		String	eTag Opcional
local	true	String	Localização do recurso
properties		VaultProperties	Propriedades do cofre
marcas		Objeto	Marcações de recursos

Exemplo do corpo de solicitação

Use o exemplo a seguir para atualizar o estado de exclusão temporária para “desabilitado”.

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Respostas para a operação PATCH

A resposta bem-sucedida para a operação “PATCH” é mostrada abaixo:

Nome	Tipo	Descrição
200 OK	BackupResourceVaultConfig	OK

Exemplo de resposta para a operação PATCH

Após uma solicitação “PATCH” ser enviada, uma resposta 200 (bem-sucedido) será retornada.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Próximas etapas

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

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

Compartilhar via