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 as configurações relacionadas ao backup no cofre dos Serviços de Recuperação do Azure usando a API REST.

Estado de exclusão suave

A exclusão de 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 um recurso de exclusão suave. 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 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, prosseguir para excluir os itens de backup e o 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.

Portanto, você precisa escolher cuidadosamente desativar o recurso de exclusão suave para um cofre específico, 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 exclusão suave será habilitado para qualquer cofre dos Serviços de Recuperação recém-criado. Para buscar/atualizar o estado de exclusão suave de um cofre, use o documento da API REST relacionada à 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:

Nome	Tipo	Description
200 OK	BackupResourceVaultConfig	OK

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 exclusão suave 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 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

Nome	Obrigatório	Type	Description
eTag		String	eTag opcional
localização	verdadeiro	String	Localização do recurso
propriedades		VaultProperties	Propriedades do cofre
etiquetas		Object	Etiquetas de recursos

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:

Nome	Tipo	Description
200 OK	BackupResourceVaultConfig	OK

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:

Partilhar via