Uppdatera Azure Recovery Services-valvkonfigurationer med hjälp av REST API
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 noga välja om du vill inaktivera mjuk borttagning för ett visst valv beroende på scenariot. Mer information finns i artikeln 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:
| Name | Type | Description |
|---|---|---|
| 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
| Name | Obligatoriskt | Type | Description |
|---|---|---|---|
| Etag | String | Valfri eTag | |
| location | true | String | Resursplats |
| egenskaper | ValvEgenskaper | Egenskaper för valvet | |
| tags | Objekt | Resurstaggar |
Exempel på begärandetext
Följande exempel används 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:
| Name | Type | Description |
|---|---|---|
| 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
Mer information om Azure REST-API:er finns i följande dokument: