Condividi tramite

Aggiornare le configurazioni dell'insieme di credenziali di Servizi di ripristino di Azure usando l'API REST

  • Articolo

Questo articolo descrive come aggiornare le configurazioni correlate al backup nell'insieme di credenziali di Servizi di ripristino di Azure usando l'API REST.

Stato eliminazione temporanea

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 insieme di credenziali di Servizi di ripristino di Azure non può essere eliminato se sono presenti elementi di backup, anche quelli eliminati temporaneamente. 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 insieme di credenziali, configurare i backup per un elemento, eseguire un ripristino di test e quindi procedere all'eliminazione degli elementi di backup e dell'insieme di credenziali. 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 dell'eliminazione temporanea per un insieme di credenziali, usare il documento dell'API REST correlata alla configurazione dell'insieme di credenziali 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 {subscriptionId}parametri , {vaultName}. {vaultresourceGroupName} In questo esempio, {vaultName} è "testVault" e {vaultresourceGroupName} è "testVaultRG". Tutti i parametri obbligatori vengono specificati nell'URI e di conseguenza il corpo di una richiesta separata non è necessario.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Risposte

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

Nome Tipo Descrizione
200 OK BackupResourceVaultConfig Ok
Esempio di risposta

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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 temporanea usando 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 PUT seguente 

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 {subscriptionId}parametri , {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/00000000-0000-0000-0000-000000000000/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 Type Descrizione
eTag String eTag facoltativo
location true String Posizione della risorsa
proprietà VaultProperties Proprietà dell'insieme di credenziali
tag Object Tag delle risorse

Esempio di corpo della richiesta

Usare l'esempio seguente per aggiornare lo stato di eliminazione temporanea su "disabled".

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

Risposte per l'operazione PATCH

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

Nome Tipo Descrizione
200 OK BackupResourceVaultConfig Ok
Risposta di esempio per l'operazione PATCH

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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: