Säkerhetskopiera en virtuell Azure-dator med Hjälp av Azure Backup via REST API

  • Artikel

Den här artikeln beskriver hur du hanterar säkerhetskopior för en virtuell Azure-dator med hjälp av Azure Backup via REST API. Konfigurera skydd för första gången för en tidigare oskyddad virtuell Azure-dator, utlös en säkerhetskopiering på begäran för en skyddad virtuell Azure-dator och ändra säkerhetskopieringsegenskaperna för en säkerhetskopierad virtuell dator via REST API enligt beskrivningen här. Information om hur du skyddar en virtuell Azure-dator med hjälp av Azure-portalen finns i den här artikeln.

Lär dig hur du skapar valv och skapar rest-API-självstudier för principer för att skapa nya valv och principer.

Anta att du vill skydda en virtuell dator testVM under en resursgrupp testRG till ett Recovery Services-valv testVault, som finns i resursgruppen testVaultRG, med standardprincipen (med namnet DefaultPolicy).

Konfigurera säkerhetskopiering för en oskyddad virtuell Azure-dator med hjälp av REST API

Identifiera oskyddade virtuella Azure-datorer

Först bör valvet kunna identifiera den virtuella Azure-datorn. Detta utlöses med uppdateringsåtgärden. Det är en asynkron POST-åtgärd som ser till att valvet hämtar den senaste listan över alla oskyddade virtuella datorer i den aktuella prenumerationen och "cachelagrar" dem. När den virtuella datorn har cachelagrats kommer Recovery Services att kunna komma åt den virtuella datorn och skydda den.

POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupname}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/refreshContainers?api-version=2016-12-01

POST-URI:n har {subscriptionId}parametrarna , {vaultName}, {vaultresourceGroupName}. {fabricName} {fabricName} är "Azure". Enligt vårt exempel {vaultName} är "testVault" och {vaultresourceGroupName} "testVaultRG". Eftersom alla obligatoriska parametrar anges i URI:n behöver du ingen separat begärandetext.

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

Svar på uppdateringsåtgärd

Uppdateringsåtgärden är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

Namn Type Beskrivning
204 inget innehåll OK med Inget innehåll returnerat
202 Accepterad Har godkänts

Exempel på svar på uppdateringsåtgärd:

När POST-begäran har skickats returneras ett 202-svar (godkänt).

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

Spåra den resulterande åtgärden med hjälp av "Plats"-huvudet med ett enkelt GET-kommando

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

När alla virtuella Azure-datorer har identifierats returnerar GET-kommandot ett 204-svar (inget innehåll). Valvet kan nu identifiera alla virtuella datorer i prenumerationen.

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

Välja relevant virtuell Azure-dator

Du kan bekräfta att "cachelagring" görs genom att visa alla skyddsbara objekt under prenumerationen och leta upp den önskade virtuella datorn i svaret. Svaret från den här åtgärden ger dig också information om hur Recovery Services identifierar en virtuell dator. När du är bekant med mönstret kan du hoppa över det här steget och direkt fortsätta med att aktivera skydd.

Den här åtgärden är en GET-åtgärd .

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectableItems?api-version=2016-12-01&$filter=backupManagementType eq 'AzureIaasVM'

GET-URI:n har alla nödvändiga parametrar. Ingen ytterligare begärandetext behövs.

Svar för att hämta åtgärden

Namn Type Beskrivning
200 OK WorkloadProtectableItemResourceList OK

Exempel på svar för att hämta åtgärden:

När GET-begäran har skickats returneras 200 (OK).

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"
      }
    },……………..

Dricks

Antalet värden i ett GET-svar är begränsat till 200 för en sida. Använd fältet "nextLink" för att hämta URL:en för nästa uppsättning svar.

Svaret innehåller listan över alla oskyddade virtuella Azure-datorer och {value} innehåller all information som krävs av Azure Recovery Service för att konfigurera säkerhetskopiering. Observera fältet {name} och fältet {virtualMachineId} i {properties} avsnittet för att konfigurera säkerhetskopiering. Skapa två variabler från dessa fältvärden enligt beskrivningen nedan.

  • containerName = "iaasvmcontainer;" +{name}
  • protectedItemName = "vm;" + {name}
  • {virtualMachineId} används senare i begärandetexten

I exemplet översätts ovanstående värden till:

  • containerName = "iaasvmcontainer; iaasvmcontainerv2; testRG; testVM"
  • protectedItemName = "vm;iaasvmcontainerv2; testRG; testVM"

Aktivera skydd för den virtuella Azure-datorn

När den relevanta virtuella datorn har "cachelagrats" och "identifierats" väljer du den princip som ska skyddas. Mer information om befintliga principer i valvet finns i listan Princip-API. Välj sedan relevant princip genom att referera till principnamnet. Information om hur du skapar principer finns i självstudien Skapa princip. "DefaultPolicy" är markerat i exemplet nedan.

Aktivering av skydd är en asynkron PUT-åtgärd som skapar ett "skyddat objekt".

https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13

Och {containerName}{protectedItemName} är som konstruerade ovan. {fabricName} är "Azure". I vårt exempel översätts detta till:

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

Skapa begärandetexten

För att skapa ett skyddat objekt följer du komponenterna i begärandetexten.

Namn Type Beskrivning
egenskaper AzureIaaSVMProtectedItem Egenskaper för ProtectedItem-resurs

Den fullständiga listan över definitioner av begärandetexten och annan information finns i skapa REST API-dokument för skyddade objekt.

Exempel på begärandetext:

Följande begärandetext definierar egenskaper som krävs för att skapa ett skyddat objekt.

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

{sourceResourceId} är det {virtualMachineId} som nämns ovan från svaret för listskyddbara objekt. Svar för att skapa åtgärden för skyddat objekt @01011011

Svar för att skapa en åtgärd för skyddat objekt

Skapandet av ett skyddat objekt är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

Namn Type Beskrivning
200 OK ProtectedItemResource OK
202 Accepterad Har godkänts

Exempel på svar för att skapa åtgärden skyddat objekt:

När du har skickat PUT-begäran om att skapa eller uppdatera skyddade objekt är det första svaret 202 (accepterad) med en platsrubrik eller 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

Spåra sedan den resulterande åtgärden med hjälp av platsrubriken eller Azure-AsyncOperation-huvudet med ett enkelt GET-kommando .

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

När åtgärden är klar returneras 200 (OK) med det skyddade objektinnehållet i svarstexten.

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

Detta bekräftar att skyddet är aktiverat för den virtuella datorn och att den första säkerhetskopieringen utlöses enligt principschemat.

Exkluderande diskar i säkerhetskopiering av virtuella Azure-datorer

Azure Backup ger också ett sätt att selektivt säkerhetskopiera en delmängd diskar på en virtuell Azure-dator. Mer information finns här. Om du selektivt vill säkerhetskopiera några diskar under aktivering av skydd bör följande kodfragment vara begärandetexten under aktivering av skydd.

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

I begärandetexten ovan visas listan över diskar som ska säkerhetskopieras i avsnittet utökade egenskaper.

Property Värde
diskLunList LUN-listan för diskar är en lista över LUN med datadiskar. OS-disken säkerhetskopieras alltid och behöver inte nämnas.
IsInclusionList Bör vara sant för att LUN ska inkluderas under säkerhetskopieringen. Om det är falskt undantas ovan nämnda LUN.

Om kravet är att endast säkerhetskopiera OS-disken ska alla datadiskar undantas. Ett enklare sätt är att säga att inga datadiskar ska inkluderas. Så diskens LUN-lista kommer att vara tom och IsInclusionList kommer att vara sann. Tänk på vad som är det enklare sättet att välja en delmängd: Några diskar bör alltid undantas eller några diskar bör alltid inkluderas. Välj LUN-listan och det booleska variabelvärdet i enlighet med detta.

Utlösa en säkerhetskopiering på begäran för en skyddad virtuell Azure-dator

När en virtuell Azure-dator har konfigurerats för säkerhetskopiering sker säkerhetskopieringar enligt principschemat. Du kan vänta på den första schemalagda säkerhetskopieringen eller utlösa en säkerhetskopiering på begäran när som helst. Kvarhållning för säkerhetskopiering på begäran är separat från kvarhållning av säkerhetskopieringsprinciper och kan anges till en viss datum-tid. Om det inte anges antas det vara 30 dagar från dagen för utlösaren av säkerhetskopiering på begäran.

Att utlösa en säkerhetskopiering på begäran är en POST-åtgärd .

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

Och {containerName}{protectedItemName} är som konstruerade ovan. {fabricName} är "Azure". I vårt exempel översätts detta till:

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

Skapa begärandetexten för säkerhetskopiering på begäran

Om du vill utlösa en säkerhetskopiering på begäran följer du komponenterna i begärandetexten.

Namn Type Beskrivning
egenskaper IaaSVMBackupRequest Egenskaper för BackupRequestResource

En fullständig lista över definitioner av begärandetexten och annan information finns i utlösarsäkerhetskopior för REST API-dokument för skyddade objekt.

Exempel på begärandetext för säkerhetskopiering på begäran

Följande begärandetext definierar egenskaper som krävs för att utlösa en säkerhetskopia för ett skyddat objekt. Om kvarhållningen inte anges behålls den i 30 dagar från tidpunkten för utlösaren av säkerhetskopieringsjobbet.

{
   "properties": {
    "objectType": "IaasVMBackupRequest",
    "recoveryPointExpiryTimeInUTC": "2018-12-01T02:16:20.3156909Z"
  }
}

Svar för säkerhetskopiering på begäran

Att utlösa en säkerhetskopiering på begäran är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

Namn Type Beskrivning
202 Accepterad Har godkänts

Exempel på svar för säkerhetskopiering på begäran

När du skickar POST-begäran om en säkerhetskopiering på begäran är det första svaret 202 (accepterad) med en platsrubrik eller 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

Spåra sedan den resulterande åtgärden med hjälp av platsrubriken eller Azure-AsyncOperation-huvudet med ett enkelt GET-kommando .

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

När åtgärden är klar returneras 200 (OK) med ID:t för det resulterande säkerhetskopieringsjobbet i svarstexten.

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

Eftersom säkerhetskopieringsjobbet är en tidskrävande åtgärd måste det spåras enligt beskrivningen i övervakningsjobben med hjälp av REST API-dokumentet.

Ändra säkerhetskopieringskonfigurationen för en skyddad virtuell Azure-dator

Ändra skyddsprincipen

Om du vill ändra principen som den virtuella datorn skyddas med kan du använda samma format som att aktivera skydd). Ange bara det nya princip-ID:t i begärandetexten och skicka begäran. Exempel: Om du vill ändra principen för testVM från DefaultPolicy till ProdPolicy anger du ProdPolicy-ID:t i begärandetexten.

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

Svaret kommer att följa samma format som nämnts för att aktivera skydd

Exkludering av diskar under Azure VM-skydd

Om den virtuella Azure-datorn redan har säkerhetskopierats kan du ange listan över diskar som ska säkerhetskopieras eller undantas genom att ändra skyddsprincipen. Förbered bara begäran i samma format som att exkludera diskar under aktivering av skydd

Viktigt!

Begärandetexten ovan är alltid den slutliga kopian av datadiskar som ska undantas eller inkluderas. Detta läggs inte till i den tidigare konfigurationen. Till exempel: Om du först uppdaterar skyddet som "exkludera datadisk 1" och sedan upprepar med "exkludera datadisk 2" undantas endast datadisk 2 i efterföljande säkerhetskopior och datadisk 1 inkluderas. Det här är alltid den slutliga listan som kommer att inkluderas/exkluderas i de efterföljande säkerhetskopiorna.

Om du vill hämta den aktuella listan över diskar som är exkluderade eller inkluderade hämtar du den skyddade objektinformationen som anges här. Svaret innehåller en lista över LUN för datadiskar och anger om de ingår eller exkluderas.

Stoppa skyddet men behåll befintliga data

Om du vill ta bort skyddet på en skyddad virtuell dator men behålla de data som redan har säkerhetskopierats tar du bort principen i begärandetexten och skickar begäran. När associationen med principen har tagits bort utlöses inte längre säkerhetskopior och inga nya återställningspunkter skapas.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "policyId": ""
  }
}

Svaret följer samma format som nämnts för att utlösa en säkerhetskopiering på begäran. Det resulterande jobbet ska spåras enligt beskrivningen i övervakningsjobben med hjälp av REST API-dokumentet.

Stoppa skydd och ta bort data

Om du vill ta bort skyddet på en skyddad virtuell dator och även ta bort säkerhetskopierade data utför du en borttagningsåtgärd enligt beskrivningen här.

Att stoppa skyddet och ta bort data är en DELETE-åtgärd .

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

Och {containerName}{protectedItemName} är som konstruerade ovan. {fabricName} är "Azure". I vårt exempel översätts detta till:

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

Svar för borttagningsskydd

DELETE-skydd är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 204 (NoContent) när åtgärden har slutförts.

Namn Type Beskrivning
204 NoContent NoContent
202 Accepterad Har godkänts

Viktigt!

För att skydda mot oavsiktliga borttagningsscenarier finns det en funktion för mjuk borttagning som är tillgänglig för Recovery Services-valvet. Om tillståndet för mjuk borttagning av valvet är inställt på aktiverat tas inte borttagningsåtgärden bort omedelbart. Den kommer att hållas i 14 dagar och sedan rensas permanent. Du debiteras inte för lagring under den här 14-dagarsperioden. Om du vill ångra borttagningsåtgärden läser du avsnittet ångra borttagning.

Ångra borttagningen

Att ångra den oavsiktliga borttagningen liknar att skapa säkerhetskopieringsobjektet. När du har ångrat borttagningen behålls objektet, men inga framtida säkerhetskopior utlöses.

Ångra borttagning är en PUT-åtgärd som liknar att ändra principen och/eller aktivera skyddet. Ange bara avsikten att ångra borttagningen med variabeln isRehydrate i begärandetexten och skicka begäran. Till exempel: Om du vill ångra borttagningen för testVM ska följande begärandetext användas.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "protectionState": "ProtectionStopped",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "isRehydrate": true
  }
}

Svaret följer samma format som nämnts för att utlösa en säkerhetskopiering på begäran. Det resulterande jobbet ska spåras enligt beskrivningen i övervakningsjobben med hjälp av REST API-dokumentet.

Nästa steg

Återställa data från en säkerhetskopiering av en virtuell Azure-dator.

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