Aggiornare le configurazioni del vault di Servizi di ripristino di Azure utilizzando l'API REST

Questo articolo descrive come aggiornare le configurazioni relative al backup nella cassetta dei Servizi di ripristino di Azure utilizzando l'API REST.

Gestire le operazioni di eliminazione temporanea nell'insieme di credenziali di Servizi di ripristino

L'eliminazione di backup di un elemento protetto è un'operazione significativa che deve essere monitorata. Per proteggersi da eliminazioni accidentali, l'insieme di credenziali di Servizi di ripristino di Azure ha una funzionalità di eliminazione temporanea. Questa funzionalità consente di ripristinare i backup eliminati, se necessario, entro un periodo di tempo dopo l'eliminazione.

Esistono tuttavia scenari in cui questa funzionalità non è necessaria. Un archivio dei Servizi di ripristino di Azure non può essere eliminato se contiene elementi di backup, inclusi quelli eliminati in modo temporaneo. Questo può causare un problema se l'insieme di credenziali deve essere eliminato immediatamente. Ad esempio: le operazioni di distribuzione spesso puliscono le risorse create nello stesso flusso di lavoro. Una distribuzione può creare un archivio, configurare i backup per un elemento, eseguire un ripristino di test e quindi procedere all'eliminazione degli elementi di backup e dell'archivio. Se l'eliminazione dell'insieme di credenziali ha esito negativo, l'intera distribuzione potrebbe non riuscire. La disabilitazione dell'eliminazione temporanea è l'unico modo per garantire l'eliminazione immediata.

È quindi necessario scegliere con attenzione di disabilitare la funzionalità di eliminazione temporanea per un insieme di credenziali specifico a seconda dello scenario. Altre informazioni sull'eliminazione temporanea.

Recuperare lo stato di eliminazione temporanea usando l'API REST

Per impostazione predefinita, lo stato di eliminazione temporanea verrà abilitato per qualsiasi insieme di credenziali di Servizi di ripristino appena creato. Per recuperare/aggiornare lo stato della soft-delete per un vault, usare il documento dell'API REST correlato alla configurazione del vault di backup.

Per recuperare lo stato corrente dell'eliminazione temporanea per un insieme di credenziali, usare l'operazione GET seguente

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

L'URI GET ha i parametri {subscriptionId}, {vaultName}, {vaultresourceGroupName}. In questo esempio, {vaultName} è "testVault" e {vaultresourceGroupName} è "testVaultRG". Poiché tutti i parametri obbligatori vengono specificati nell'URI, non è necessario un corpo della richiesta separato.

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

Di seguito è illustrata la risposta corretta per l'operazione 'GET':

Nome	TIPO	Description
200 Va bene	BackupResourceVaultConfig	Va bene

Risposta di esempio

Dopo l'invio della richiesta 'GET', viene restituita una risposta 200 (operazione riuscita).

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

Aggiornare lo stato di eliminazione non definitiva utilizzando l'API REST

Per aggiornare lo stato di eliminazione temporanea dell'insieme di credenziali di Servizi di ripristino tramite l'API REST, usare l'operazione PUTseguente

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

L'URI PUT ha i parametri {subscriptionId}, {vaultName}, {vaultresourceGroupName}. In questo esempio, {vaultName} è "testVault" e {vaultresourceGroupName} è "testVaultRG". Se si sostituisce l'URI con i valori precedenti, l'URI sarà simile al seguente.

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

Creare il corpo della richiesta

Le definizioni comuni seguenti vengono usate per creare un corpo della richiesta

Per altri dettagli, vedere la documentazione dell'API REST

Nome	Obbligatorio	TIPO	Description
eTag		String	ETag facoltativo
ubicazione	true	String	Posizione risorsa
properties		VaultProperties	Proprietà dell'insieme di credenziali
tags		Oggetto	Tag delle risorse

Esempio di corpo della richiesta

Usare l'esempio seguente per aggiornare lo stato di eliminazione logica a 'disabilitato'.

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

Risposte per l'operazione PATCH

Di seguito è illustrata la risposta corretta per l'operazione 'PATCH':

Nome	TIPO	Description
200 Va bene	BackupResourceVaultConfig	Va bene

Risposta di esempio per l'operazione PATCH

Dopo l'invio della richiesta "PATCH", viene restituita una risposta 200 (riuscita).

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

Passaggi successivi

Creare un criterio di backup per il backup di una macchina virtuale di Azure in questo insieme di credenziali.

Per altre informazioni sulle API REST di Azure, vedere i documenti seguenti:

• API REST del provider di Servizi di ripristino di Azure
• Introduzione all'API REST di Azure