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

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

Gerenciar operações de exclusão suave no cofre dos Serviços de Recuperação

A exclusão de backups de um item protegido é uma operação significativa que precisa ser monitorada. Para proteger contra exclusões acidentais, o Azure Recovery Services vault tem um recurso de eliminação reversível. Esse recurso permite que você restaure backups excluídos, se necessário, dentro de um período de tempo após a exclusão.

Mas há cenários em que essa capacidade não é necessária. Um cofre dos Serviços de Recuperação do Azure não pode ser excluído se houver itens de backup nele, mesmo os excluídos suavemente. Isso pode representar um problema se o cofre precisar ser eliminado imediatamente. Por exemplo: as operações de implantação geralmente limpam os recursos criados no mesmo fluxo de trabalho. Uma implementação pode criar um cofre, configurar backups para um item, realizar uma restauração de teste e, em seguida, proceder à exclusão dos itens de backup e do cofre. Se a exclusão do cofre falhar, toda a implantação poderá falhar. Desativar o soft-delete é a única maneira de garantir a exclusão imediata.

É necessário decidir cuidadosamente sobre desativar a funcionalidade de eliminação suave para um cofre em particular, dependendo do cenário. Saiba mais sobre a exclusão suave.

Buscar o estado de exclusão suave usando a API REST

Por padrão, o estado de eliminação temporária será ativado para qualquer cofre de Serviços de Recuperação que seja recém-criado. Para buscar/atualizar o estado de exclusão suave de um cofre, use o documento da API REST relacionado à configuração do cofre de backup

Para buscar o estado atual da exclusão suave 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 GET URI tem {subscriptionId}, {vaultName}, {vaultresourceGroupName} parâmetros. Neste exemplo, {vaultName} é "testVault" e {vaultresourceGroupName} é "testVaultRG". Como todos os parâmetros necessários são fornecidos no URI, não há necessidade de um corpo de 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:

Resposta de exemplo

Uma vez que a solicitação 'GET' é enviada, uma resposta 200 (bem-sucedida) é 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 suave usando a API REST

Para atualizar o estado de eliminação suave do cofre dos Serviços de Recuperação usando a API REST, utilize 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 {subscriptionId}, {vaultName}, {vaultresourceGroupName} parâmetros. Neste exemplo, {vaultName} é "testVault" e {vaultresourceGroupName} é "testVaultRG". Se substituirmos o URI pelos valores acima, o URI terá esta 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, consulte a documentação da API REST

Exemplo de corpo da solicitação

Use o exemplo a seguir para atualizar o estado de exclusão suave para 'desativado'.

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

Respostas para a operação PATCH

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

Exemplo de resposta para a operação PATCH

Uma vez que a solicitação 'PATCH' é enviada, uma resposta 200 (bem-sucedida) é 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óximos passos

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

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

• API REST do provedor de Serviços de Recuperação do Azure
• Introdução à API REST do Azure