Een back-up maken van een Azure-VM met behulp van Azure Backup via REST API
In dit artikel wordt beschreven hoe u back-ups voor een Azure-VM beheert met behulp van Azure Backup via REST API. Configureer de beveiliging voor de eerste keer voor een eerder onbeveiligde Azure-VM, activeer een back-up op aanvraag voor een beveiligde Azure-VM en wijzig back-upeigenschappen van een back-up-VM via REST API, zoals hier wordt uitgelegd. Zie dit artikel voor het beveiligen van een Virtuele Azure-machine met behulp van Azure Portal.
Meer informatie over het maken van een kluis en het maken van REST API-zelfstudies voor beleid voor het maken van nieuwe kluizen en beleid.
Stel dat u een virtuele machine testVM onder een resourcegroep testRG wilt beveiligen naar een Recovery Services-kluis testVault, aanwezig in de resourcegroep testVaultRG, met het standaardbeleid (met de naam DefaultPolicy).
Back-up configureren voor een niet-beveiligde Azure-VM met behulp van REST API
Niet-beveiligde Azure-VM's detecteren
Eerst moet de kluis de Azure-VM kunnen identificeren. Dit wordt geactiveerd met behulp van de vernieuwingsbewerking. Het is een asynchrone POST-bewerking die ervoor zorgt dat de kluis de meest recente lijst met alle niet-beveiligde VM's in het huidige abonnement ophaalt en 'cachet' deze. Zodra de VM in de cache is opgeslagen, heeft Recovery Services toegang tot de VIRTUELE machine en kan deze worden beveiligd.
POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupname}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/refreshContainers?api-version=2016-12-01
De POST-URI heeft {subscriptionId}, {vaultName}, parameters {fabricName} {vaultresourceGroupName}. Het {fabricName} is 'Azure'. Volgens ons voorbeeld {vaultName} is 'testVault' en {vaultresourceGroupName} 'testVaultRG'. Aangezien alle vereiste parameters worden gegeven in de URI, is er geen afzonderlijke aanvraagbody nodig.
POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/refreshContainers?api-version=2016-12-01
Antwoorden op vernieuwingsbewerking
De bewerking Vernieuwen is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.
Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.
| Name | Type | Description |
|---|---|---|
| 204 Geen inhoud | OK zonder inhoud geretourneerd | |
| 202 Geaccepteerd | Geaccepteerd |
Voorbeeldantwoorden voor vernieuwingsbewerking:
Zodra de POST-aanvraag is ingediend, wordt een antwoord van 202 (Geaccepteerd) geretourneerd.
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
X-Content-Type-Options: nosniff
x-ms-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-client-request-id: 4910609f-bb9b-4c23-8527-eb6fa2d3253f; 4910609f-bb9b-4c23-8527-eb6fa2d3253f
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-routing-request-id: SOUTHINDIA:20180521T105701Z:43cf550d-e463-421c-8922-37e4766db27d
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:57:00 GMT
Location: https://management.azure.com/subscriptions//00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13
X-Powered-By: ASP.NET
De resulterende bewerking bijhouden met behulp van de header Locatie met een eenvoudige GET-opdracht
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13
Zodra alle Virtuele Azure-machines zijn gedetecteerd, retourneert de GET-opdracht een 204-antwoord (geen inhoud). De kluis kan nu elke virtuele machine binnen het abonnement detecteren.
HTTP/1.1 204 NoContent
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-client-request-id: 25bb6345-f9fc-4406-be1a-dc6db0eefafe; 25bb6345-f9fc-4406-be1a-dc6db0eefafe
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14997
x-ms-correlation-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-routing-request-id: SOUTHINDIA:20180521T105825Z:cf6cd73b-9189-4942-a61d-878fcf76b1c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:58:25 GMT
X-Powered-By: ASP.NET
De relevante Azure-VM selecteren
U kunt bevestigen dat 'caching' wordt uitgevoerd door alle beveiligbare items onder het abonnement weer te geven en de gewenste VIRTUELE machine in het antwoord te vinden. Het antwoord van deze bewerking geeft u ook informatie over hoe Recovery Services een VIRTUELE machine identificeert. Zodra u bekend bent met het patroon, kunt u deze stap overslaan en direct doorgaan met het inschakelen van beveiliging.
Deze bewerking is een GET-bewerking .
GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectableItems?api-version=2016-12-01&$filter=backupManagementType eq 'AzureIaasVM'
De GET-URI heeft alle vereiste parameters. Er is geen extra aanvraagbody nodig.
Antwoorden voor het ophalen van bewerkingen
| Name | Type | Description |
|---|---|---|
| 200 OK | WorkloadProtectableItemResourceList | OK |
Voorbeeldantwoorden voor het ophalen van bewerkingen:
Zodra de GET-aanvraag is ingediend, wordt 200 (OK) antwoord geretourneerd.
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-client-request-id: 40c8601a-c217-4c68-87da-01db8dac93dd; 40c8601a-c217-4c68-87da-01db8dac93dd
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14979
x-ms-correlation-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-routing-request-id: SOUTHINDIA:20180521T071408Z:7c2cf56a-e6be-4345-96df-c27ed849fe36
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:14:08 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"value": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG;testVM/protectableItems/vm;iaasvmcontainerv2;testRG;testVM",
"name": "iaasvmcontainerv2;testRG;testVM",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
"properties": {
"virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"virtualMachineVersion": "Compute",
"resourceGroup": "testRG",
"backupManagementType": "AzureIaasVM",
"protectableItemType": "Microsoft.Compute/virtualMachines",
"friendlyName": "testVM",
"protectionState": "NotProtected"
}
},……………..
Tip
Het aantal waarden in een GET-antwoord is beperkt tot 200 voor een pagina. Gebruik het veld nextLink om de URL voor de volgende set antwoorden op te halen.
Het antwoord bevat de lijst met alle niet-beveiligde Azure-VM's en elk {value} bevat alle informatie die azure Recovery Service nodig heeft om back-ups te configureren. Als u een back-up wilt configureren, noteert u het {name} veld en het {virtualMachineId} veld in {properties} de sectie. Maak twee variabelen op basis van deze veldwaarden, zoals hieronder wordt vermeld.
- containerName = "iaasvmcontainer;" +
{name} - protectedItemName = "vm;" +
{name} {virtualMachineId}wordt later in de aanvraagbody gebruikt
In het voorbeeld worden de bovenstaande waarden omgezet in:
- containerName = "iaasvmcontainer; iaasvmcontainerv2; testRG; testVM"
- protectedItemName = "vm;iaasvmcontainerv2; testRG; testVM"
Beveiliging inschakelen voor de Virtuele Azure-machine
Nadat de relevante VM in de cache en geïdentificeerd is, selecteert u het beleid dat u wilt beveiligen. Raadpleeg de lijst policy-API voor meer informatie over bestaande beleidsregels in de kluis. Selecteer vervolgens het relevante beleid door te verwijzen naar de beleidsnaam. Als u beleidsregels wilt maken, raadpleegt u de zelfstudie over het maken van beleid. 'DefaultPolicy' is geselecteerd in het onderstaande voorbeeld.
Beveiliging inschakelen is een asynchrone PUT-bewerking waarmee een beveiligd item wordt gemaakt.
https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
De {containerName} en {protectedItemName} zijn zoals hierboven is samengesteld. Het {fabricName} is 'Azure'. In ons voorbeeld wordt dit omgezet in:
PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13
De hoofdtekst van de aanvraag maken
Als u een beveiligd item wilt maken, volgt u de onderdelen van de aanvraagbody.
| Name | Type | Description |
|---|---|---|
| properties | AzureIaaSVMProtectedItem | ProtectedItem-resourceeigenschappen |
Voor de volledige lijst met definities van de aanvraagbody en andere details raadpleegt u het document met de REST API voor beveiligde items maken.
Voorbeeld van aanvraagtekst:
De volgende aanvraagbody definieert eigenschappen die vereist zijn voor het maken van een beveiligd item.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy"
}
}
De {sourceResourceId} bovenstaande is de {virtualMachineId} bovenstaande uit het antwoord van de lijst beveiligbare items.
Antwoorden voor het maken van beveiligde itembewerking @01011011
Antwoorden voor het maken van een beveiligde itembewerking
Het maken van een beveiligd item is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.
Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.
| Name | Type | Description |
|---|---|---|
| 200 OK | ProtectedItemResource | OK |
| 202 Geaccepteerd | Geaccepteerd |
Voorbeeldantwoorden voor het maken van een beveiligde itembewerking:
Nadat u de PUT-aanvraag hebt ingediend voor het maken of bijwerken van beveiligde items, is het eerste antwoord 202 (geaccepteerd) met een locatieheader of Azure-async-header.
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-client-request-id: e1f94eef-9b2d-45c4-85b8-151e12b07d03; e1f94eef-9b2d-45c4-85b8-151e12b07d03
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-routing-request-id: SOUTHINDIA:20180521T073907Z:db785be0-bb20-4598-bc9f-70c9428b170b
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:39:06 GMT
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationResults/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
X-Powered-By: ASP.NET
Volg vervolgens de resulterende bewerking met behulp van de locatieheader of Azure-AsyncOperation-header met een eenvoudige GET-opdracht .
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
Zodra de bewerking is voltooid, wordt 200 (OK) geretourneerd met de inhoud van het beveiligde item in de hoofdtekst van het antwoord.
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM",
"name": "VM;testRG;testVM",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems",
"properties": {
"friendlyName": "testVM",
"virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"protectionStatus": "Healthy",
"protectionState": "IRPending",
"healthStatus": "Passed",
"lastBackupStatus": "",
"lastBackupTime": "2001-01-01T00:00:00Z",
"protectedItemDataId": "17592691116891",
"extendedInfo": {
"recoveryPointCount": 0,
"policyInconsistent": false
},
"protectedItemType": "Microsoft.Compute/virtualMachines",
"backupManagementType": "AzureIaasVM",
"workloadType": "VM",
"containerName": "iaasvmcontainerv2;testRG;testVM",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy",
"policyName": "DefaultPolicy"
}
}
Hiermee wordt bevestigd dat beveiliging is ingeschakeld voor de VIRTUELE machine en dat de eerste back-up wordt geactiveerd volgens het beleidsschema.
Schijven uitsluiten in Azure VM-back-up
Azure Backup biedt ook een manier om selectief een back-up te maken van een subset van schijven in azure-VM. Meer informatie vindt u hier. Als u tijdens het inschakelen van beveiliging selectief een back-up wilt maken van enkele schijven, moet het volgende codefragment de aanvraagbody zijn tijdens het inschakelen van beveiliging.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy",
"extendedProperties": {
"diskExclusionProperties":{
"diskLunList":[0,1],
"isInclusionList":true
}
}
}
}
In de bovenstaande aanvraagtekst wordt de lijst met schijven waarvan een back-up moet worden gemaakt, opgegeven in de sectie uitgebreide eigenschappen.
| Eigenschappen | Weergegeven als |
|---|---|
| diskLunList | De schijf-LUN-lijst is een lijst met LUN's van gegevensschijven. Er wordt altijd een back-up van de besturingssysteemschijf gemaakt en hoeft niet te worden vermeld. |
| IsInclusionList | Moet waar zijn voor de LUN's die tijdens de back-up moeten worden opgenomen. Als het onwaar is, worden de bovengenoemde LUN's uitgesloten. |
Dus als de vereiste is om alleen een back-up te maken van de besturingssysteemschijf, moeten alle gegevensschijven worden uitgesloten. Een eenvoudigere manier is om te zeggen dat er geen gegevensschijven moeten worden opgenomen. De schijf-LUN-lijst is dus leeg en de IsInclusionList is waar. Denk ook aan wat de eenvoudigere manier is om een subset te selecteren: een paar schijven moeten altijd worden uitgesloten of een paar schijven moeten altijd worden opgenomen. Kies de LUN-lijst en de booleaanse variabelewaarde dienovereenkomstig.
Een back-up op aanvraag activeren voor een beveiligde Azure-VM
Zodra een Azure-VM is geconfigureerd voor back-ups, worden back-ups uitgevoerd volgens het beleidsschema. U kunt op elk gewenst moment wachten op de eerste geplande back-up of een back-up op aanvraag activeren. Retentie voor back-ups op aanvraag is gescheiden van de bewaarperiode van het back-upbeleid en kan worden opgegeven voor een bepaalde datum/tijd. Als dit niet is opgegeven, wordt ervan uitgegaan dat deze 30 dagen vanaf de dag van de trigger van back-up op aanvraag is.
Het activeren van een back-up op aanvraag is een POST-bewerking .
POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup?api-version=2016-12-01
De {containerName} en {protectedItemName} zijn zoals hierboven is samengesteld. Het {fabricName} is 'Azure'. In ons voorbeeld wordt dit omgezet in:
POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM/backup?api-version=2016-12-01
De aanvraagbody voor back-up op aanvraag maken
Als u een back-up op aanvraag wilt activeren, volgt u de onderdelen van de aanvraagbody.
| Name | Type | Description |
|---|---|---|
| properties | IaaSVMBackupRequest | Eigenschappen van BackupRequestResource |
Raadpleeg voor de volledige lijst met definities van de aanvraagbody en andere details back-ups activeren voor rest API-documenten voor beveiligde items.
Voorbeeld van aanvraagbody voor back-up op aanvraag
De volgende aanvraagbody definieert eigenschappen die vereist zijn voor het activeren van een back-up voor een beveiligd item. Als de retentie niet is opgegeven, wordt deze gedurende 30 dagen bewaard vanaf het moment van trigger van de back-uptaak.
{
"properties": {
"objectType": "IaasVMBackupRequest",
"recoveryPointExpiryTimeInUTC": "2018-12-01T02:16:20.3156909Z"
}
}
Antwoorden voor back-up op aanvraag
Het activeren van een back-up op aanvraag is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.
Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.
| Name | Type | Description |
|---|---|---|
| 202 Geaccepteerd | Geaccepteerd |
Voorbeeldantwoorden voor back-up op aanvraag
Nadat u de POST-aanvraag voor een back-up op aanvraag hebt ingediend, is het eerste antwoord 202 (geaccepteerd) met een locatieheader of Azure-async-header.
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-client-request-id: 7df8e874-1d66-4f81-8e91-da2fe054811d; 7df8e874-1d66-4f81-8e91-da2fe054811d
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-routing-request-id: SOUTHINDIA:20180521T083541Z:7885ca75-c7c6-43fb-a38c-c0cc437d8810
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:35:41 GMT
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationResults/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?api-version=2019-05-13
X-Powered-By: ASP.NET
Volg vervolgens de resulterende bewerking met behulp van de locatieheader of Azure-AsyncOperation-header met een eenvoudige GET-opdracht .
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
Zodra de bewerking is voltooid, retourneert deze 200 (OK) met de id van de resulterende back-uptaak in de hoofdtekst van het antwoord.
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-client-request-id: 5a63209d-3708-4e69-a75f-9499f4c8977c; 5a63209d-3708-4e69-a75f-9499f4c8977c
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14995
x-ms-correlation-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-routing-request-id: SOUTHINDIA:20180521T083723Z:a8b13524-2c95-445f-b107-920806f385c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:37:22 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "00000000-0000-0000-0000-000000000000",
"status": "Succeeded",
"startTime": "2018-05-21T08:35:40.9488967Z",
"endTime": "2018-05-21T08:35:40.9488967Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "7ddead57-bcb9-4269-ac31-6a1b57588700"
}
}
Omdat de back-uptaak een langdurige bewerking is, moet deze worden bijgehouden zoals uitgelegd in de monitortaken met behulp van rest API-document.
De back-upconfiguratie voor een beveiligde Azure-VM wijzigen
Het beveiligingsbeleid wijzigen
Als u het beleid wilt wijzigen waarmee de VIRTUELE machine is beveiligd, kunt u dezelfde indeling gebruiken als het inschakelen van beveiliging). Geef de nieuwe beleids-id op in de aanvraagbody en dien de aanvraag in. Als u bijvoorbeeld het beleid van testVM wilt wijzigen van 'DefaultPolicy' in 'ProdPolicy', geeft u de id 'ProdPolicy' op in de aanvraagbody.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/ProdPolicy"
}
}
Het antwoord volgt dezelfde indeling als vermeld voor het inschakelen van beveiliging
Schijven uitsluiten tijdens Azure VM-beveiliging
Als er al een back-up van de Virtuele Azure-machine is gemaakt, kunt u de lijst met schijven opgeven waarvan een back-up moet worden gemaakt of uitgesloten door het beveiligingsbeleid te wijzigen. Bereid de aanvraag alleen voor in dezelfde indeling als schijven uitsluiten tijdens het inschakelen van beveiliging
Belangrijk
De bovenstaande aanvraagbody is altijd de laatste kopie van gegevensschijven die moeten worden uitgesloten of opgenomen. Dit wordt niet toegevoegd aan de vorige configuratie. Bijvoorbeeld: Als u eerst de beveiliging bijwerkt als 'gegevensschijf 1 uitsluiten' en vervolgens herhaalt met 'gegevensschijf 2 uitsluiten', wordt alleen gegevensschijf 2 uitgesloten in de volgende back-ups en gegevensschijf 1 wordt opgenomen. Dit is altijd de uiteindelijke lijst die wordt opgenomen/uitgesloten in de volgende back-ups.
Als u de huidige lijst met schijven wilt ophalen die zijn uitgesloten of opgenomen, haalt u de informatie over beveiligde items op, zoals hier wordt vermeld. Het antwoord bevat de lijst met LUN's voor gegevensschijven en geeft aan of ze zijn opgenomen of uitgesloten.
Beveiliging stoppen, maar bestaande gegevens behouden
Als u de beveiliging op een beveiligde VM wilt verwijderen, maar de gegevens waarvan al een back-up is gemaakt, verwijdert u het beleid in de aanvraagbody en verzendt u de aanvraag. Zodra de koppeling met het beleid is verwijderd, worden back-ups niet meer geactiveerd en worden er geen nieuwe herstelpunten gemaakt.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": ""
}
}
Het antwoord volgt dezelfde indeling als vermeld voor het activeren van een back-up op aanvraag. De resulterende taak moet worden bijgehouden zoals uitgelegd in de monitortaken met behulp van rest API-document.
Beveiliging stoppen en gegevens verwijderen
Als u de beveiliging op een beveiligde VM wilt verwijderen en de back-upgegevens ook wilt verwijderen, voert u een verwijderbewerking uit zoals hier wordt beschreven.
Het stoppen van de beveiliging en het verwijderen van gegevens is een DELETE-bewerking .
DELETE https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
De {containerName} en {protectedItemName} zijn zoals hierboven is samengesteld. {fabricName} is 'Azure'. In ons voorbeeld wordt dit omgezet in:
DELETE https://management.azure.com//Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13
Antwoorden voor verwijderingsbeveiliging
DELETE-beveiliging is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.
Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 204 (NoContent) wanneer deze bewerking is voltooid.
| Name | Type | Description |
|---|---|---|
| 204 NoContent | NoContent | |
| 202 Geaccepteerd | Geaccepteerd |
Belangrijk
Om te beschermen tegen onbedoelde verwijderingsscenario's, is er een functie voor voorlopig verwijderen beschikbaar voor Recovery Services-kluis. Als de status voorlopig verwijderen van de kluis is ingesteld op ingeschakeld, worden de gegevens niet onmiddellijk verwijderd door de verwijderbewerking. Het wordt 14 dagen bewaard en vervolgens permanent verwijderd. Er worden geen kosten in rekening gebracht voor opslag voor deze periode van 14 dagen. Als u de verwijderingsbewerking ongedaan wilt maken, raadpleegt u de sectie Ongedaan maken.
De verwijdering ongedaan maken
Het ongedaan maken van de onbedoelde verwijdering is vergelijkbaar met het maken van het back-upitem. Nadat u de verwijdering ongedaan hebt maken, blijft het item behouden, maar worden er geen toekomstige back-ups geactiveerd.
Verwijderen ongedaan maken is een PUT-bewerking die vergelijkbaar is met het wijzigen van het beleid en/of het inschakelen van de beveiliging. Geef de intentie op om de verwijdering ongedaan te maken met de variabele isRehydrate in de aanvraagbody en dien de aanvraag in. Bijvoorbeeld: Als u de verwijdering voor testVM ongedaan wilt maken, moet de volgende aanvraagbody worden gebruikt.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"protectionState": "ProtectionStopped",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"isRehydrate": true
}
}
Het antwoord volgt dezelfde indeling als vermeld voor het activeren van een back-up op aanvraag. De resulterende taak moet worden bijgehouden zoals uitgelegd in de monitortaken met behulp van rest API-document.
Volgende stappen
Gegevens herstellen vanuit een back-up van een virtuele Azure-machine.
Zie de volgende documenten voor meer informatie over de REST API's van Azure Backup: