Azure Recovery Services-kluisconfiguratie bijwerken met REST API

In dit artikel wordt beschreven hoe u back-upconfiguraties bijwerkt in azure Recovery Services-kluis met behulp van REST API.

Bewerkingen voor voorlopig verwijderen beheren in Recovery Services-kluis

Het verwijderen van back-ups van een beveiligd item is een belangrijke bewerking die moet worden bewaakt. Azure Recovery Services-kluis biedt een voorziening voor voorlopig verwijderen om te beschermen tegen onbedoelde verwijderingen. Met deze mogelijkheid kunt u verwijderde back-ups herstellen, indien nodig, binnen een bepaalde periode na de verwijdering.

Maar er zijn scenario's waarin deze mogelijkheid niet vereist is. Een Azure Recovery Services-kluis kan niet worden verwijderd als er back-upitems zijn, zelfs als er voorlopig verwijderde items zijn. Dit kan een probleem vormen als de kluis onmiddellijk moet worden verwijderd. Bijvoorbeeld: implementatiebewerkingen ruimen vaak de gemaakte resources op in dezelfde werkstroom. Een implementatie kan een kluis maken, back-ups voor een item configureren, een testherstel uitvoeren en vervolgens doorgaan met het verwijderen van de back-upitems en de kluis. Als het verwijderen van de kluis mislukt, kan de hele implementatie mislukken. Het uitschakelen van voorlopig verwijderen is de enige manier om onmiddellijke verwijdering te garanderen.

U moet er dus zorgvuldig voor kiezen om de functie voor voorlopig verwijderen voor een bepaalde kluis uit te schakelen, afhankelijk van het scenario. Meer informatie over voorlopig verwijderen.

Status van zachte verwijdering ophalen met REST API

De soft delete-status wordt standaard ingeschakeld voor elke nieuw aangemaakte Recovery Services-kluis. Als u de status van soft-delete voor een kluis wilt ophalen of bijwerken, gebruikt u de configuratiegerelateerde REST API-documentatie van de back-upkluis.

Gebruik de volgende GET-bewerking om de huidige status van soft-delete voor een kluis op te halen.

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

De GET-URI heeft {subscriptionId}, {vaultName}{vaultresourceGroupName} parameters. In dit voorbeeld {vaultName} is 'testVault' en {vaultresourceGroupName} 'testVaultRG'. Aangezien alle vereiste parameters worden gegeven in de URI, is er geen afzonderlijke aanvraagbody nodig.

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

Reacties

Hieronder ziet u het geslaagde antwoord voor de GET-bewerking:

Voorbeeldantwoord

Zodra de GET-aanvraag is ingediend, wordt een 200 (geslaagde) reactie geretourneerd.

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

"Zachte verwijderingstatus bijwerken met REST API"

Gebruik de volgende PUT-bewerking om met de REST API de status van de Recovery Services Vault bij te werken.

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

De PUT-URI heeft {subscriptionId}, {vaultName}{vaultresourceGroupName} parameters. In dit voorbeeld {vaultName} is 'testVault' en {vaultresourceGroupName} 'testVaultRG'. Als we de URI vervangen door de bovenstaande waarden, ziet de URI er als volgt uit.

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

De hoofdtekst van de aanvraag maken

De volgende algemene definities worden gebruikt om een aanvraagbody te maken

Raadpleeg de REST API-documentatie voor meer informatie

Voorbeeld van aanvraaginhoud

Gebruik het volgende voorbeeld om de soft delete-status bij te werken naar uitgeschakeld.

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

Antwoorden voor de PATCH-bewerking

Hieronder ziet u het succesvolle antwoord voor de 'PATCH'-operatie:

Voorbeeldantwoord voor de PATCH-bewerking

Zodra de PATCH-aanvraag is ingediend, wordt een 200 (geslaagd) antwoord geretourneerd.

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

Volgende stappen

Maak een back-upbeleid voor het maken van een back-up van een Azure VM in deze kluis.

Zie de volgende documenten voor meer informatie over de Azure REST API's:

• REST API van Azure Recovery Services-provider
• Aan de slag gaan met Azure REST API