Uppdatera Azure Recovery Services-valvkonfigurationer med hjälp av REST API

Artikel
05/30/2024

I den här artikeln beskrivs hur du uppdaterar säkerhetskopieringsrelaterade konfigurationer i Azure Recovery Services-valvet med hjälp av REST API.

Tillstånd för mjuk borttagning

Att ta bort säkerhetskopior av ett skyddat objekt är en betydande åtgärd som måste övervakas. För att skydda mot oavsiktliga borttagningar har Azure Recovery Services-valvet en funktion för mjuk borttagning. Med den här funktionen kan du återställa borttagna säkerhetskopior, om det behövs, inom en tidsperiod efter borttagningen.

Men det finns scenarier där den här funktionen inte krävs. Det går inte att ta bort ett Azure Recovery Services-valv om det finns säkerhetskopieringsobjekt i det, även mjukt borttagna. Detta kan innebära ett problem om valvet måste tas bort omedelbart. Till exempel: Distributionsåtgärder rensar ofta de skapade resurserna i samma arbetsflöde. En distribution kan skapa ett valv, konfigurera säkerhetskopior för ett objekt, göra en teståterställning och sedan fortsätta med att ta bort säkerhetskopieringsobjekten och valvet. Om valvborttagningen misslyckas kan hela distributionen misslyckas. Att inaktivera mjuk borttagning är det enda sättet att garantera omedelbar borttagning.

Därför måste du noggrant välja att inaktivera funktionen för mjuk borttagning för ett visst valv beroende på scenariot. Läs mer om mjuk borttagning.

Hämta tillstånd för mjuk borttagning med hjälp av REST API

Som standard aktiveras tillståndet för mjuk borttagning för alla nyligen skapade Recovery Services-valv. Om du vill hämta/uppdatera tillståndet för mjuk borttagning för ett valv använder du säkerhetskopieringsvalvets konfigurationsrelaterade REST API-dokument

Om du vill hämta det aktuella tillståndet för mjuk borttagning för ett valv använder du följande GET-åtgärd

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

GET-URI:n har {subscriptionId}parametrarna , {vaultName}, {vaultresourceGroupName} . I det här exemplet {vaultName} är "testVault" och {vaultresourceGroupName} "testVaultRG". Eftersom alla obligatoriska parametrar anges i URI:n behöver du ingen separat begärandetext.

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

Svar

Det lyckade svaret för get-åtgärden visas nedan:

Namn	Type	Beskrivning
200 OK	BackupResourceVaultConfig	OK

Exempelsvar

När GET-begäran har skickats returneras ett 200-svar (lyckat).

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

Uppdatera tillståndet för mjuk borttagning med hjälp av REST API

Om du vill uppdatera tillståndet för mjuk borttagning av Recovery Services-valvet med hjälp av REST-API:et använder du följande PUT-åtgärd

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

PUT-URI:n har {subscriptionId}parametrarna , {vaultName}, {vaultresourceGroupName} . I det här exemplet {vaultName} är "testVault" och {vaultresourceGroupName} "testVaultRG". Om vi ersätter URI:n med värdena ovan ser URI:n ut så här.

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

Skapa begärandetexten

Följande vanliga definitioner används för att skapa en begärandetext

Mer information finns i REST API-dokumentationen

Namn	Obligatoriskt	Type	Beskrivning
Etag		String	Valfri eTag
plats	true	String	Resursplats
egenskaper		ValvEgenskaper	Egenskaper för valvet
taggar		Objekt	Resurstaggar

Exempel på begärandetext

Använd följande exempel för att uppdatera tillståndet för mjuk borttagning till "inaktiverad".

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

Svar för PATCH-åtgärden

Det lyckade svaret för patch-åtgärden visas nedan:

Namn	Type	Beskrivning
200 OK	BackupResourceVaultConfig	OK

Exempelsvar för PATCH-åtgärden

När "PATCH"-begäran har skickats returneras ett 200-svar (lyckat).

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

Nästa steg

Skapa en säkerhetskopieringsprincip för säkerhetskopiering av en virtuell Azure-dator i det här valvet.

Mer information om Azure REST-API:er finns i följande dokument:

Dela via