Azure Recovery Services-kluisconfiguraties bijwerken met rest API

Artikel
05/30/2024

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

Status voorlopig verwijderen

Het verwijderen van back-ups van een beveiligd item is een belangrijke bewerking die moet worden bewaakt. Azure Recovery Services-kluis biedt een functie 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 voor voorlopig verwijderen ophalen met rest API

De status voorlopig verwijderen wordt standaard ingeschakeld voor elke zojuist gemaakte Recovery Services-kluis. Als u de status van voorlopig verwijderen voor een kluis wilt ophalen/bijwerken, gebruikt u het configuratiegerelateerde REST API-document van de back-upkluis

Gebruik de volgende GET-bewerking om de huidige status van voorlopig verwijderen 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/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Antwoorden

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

Name	Type	Description
200 OK	BackupResourceVaultConfig	OK

Voorbeeld van een antwoord

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

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

Status voorlopig verwijderen bijwerken met rest API

Gebruik de volgende PUT-bewerking om de status van de Recovery Services-kluis bij te werken met rest API

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/00000000-0000-0000-0000-000000000000/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

Naam	Vereist	Type	Description
eTag		String	Optionele eTag
locatie	true	String	Resourcelocatie
properties		VaultProperties	Eigenschappen van de kluis
tags		Object	Resourcetags

Voorbeeld van aanvraagbody

Gebruik het volgende voorbeeld om de status voorlopig verwijderen bij te werken naar Uitgeschakeld.

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

Antwoorden voor de PATCH-bewerking

Hieronder ziet u het geslaagde antwoord voor de bewerking PATCH:

Name	Type	Description
200 OK	BackupResourceVaultConfig	OK

Voorbeeldantwoord voor de PATCH-bewerking

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

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

Volgende stappen

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

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

Share via