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 reversível no cofre dos Serviços de Recuperação

Excluir backups de um item protegido é uma operação significativa que precisa 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 restaurar 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 funcionalidade não é necessária. 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 que foram excluídos de forma temporária. 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 reversível é 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 exclusão suave.

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 {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

Responses

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

Resposta de exemplo

Depois 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 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 {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 definições comuns a seguir são usadas para criar um corpo da solicitação

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

Exemplo do corpo de solicitação

Use o exemplo a seguir para atualizar o estado de soft delete 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

Depois 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óximas etapas

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
• Iniciar com a API REST do Azure