Eseguire il backup di una macchina virtuale di Azure con Backup di Azure tramite l'API REST

Articolo
04/25/2024

Questo articolo descrive come gestire i backup per una macchina virtuale di Azure con Backup di Azure tramite l'API REST. Configurare la protezione per la prima volta per una macchina virtuale di Azure precedentemente non protetta, attivare un backup su richiesta per una macchina virtuale di Azure protetta e modificare le proprietà di backup di una macchina virtuale di cui è stato eseguito il backup tramite l'API REST, come illustrato di seguito. Per proteggere una macchina virtuale di Azure usando il portale di Azure, vedere questo articolo.

Informazioni su come creare un insieme di credenziali e creare esercitazioni sull'API REST dei criteri per la creazione di nuovi insiemi di credenziali e criteri.

Si supponga di voler proteggere una macchina virtuale testVM in un gruppo testRG di risorse in un insieme di credenziali testVaultdi Servizi di ripristino, presente all'interno del gruppo testVaultRGdi risorse , con i criteri predefiniti (denominati DefaultPolicy).

Configurare il backup di una macchina virtuale di Azure non protetta con l'API REST

Individuare le macchine virtuali di Azure non protette

In primo luogo l'insieme di credenziali deve essere in grado di identificare la macchina virtuale di Azure. Questa azione viene attivata tramite l'operazione di aggiornamento, ovvero un'operazione POST asincrona che garantisce che l'insieme di credenziali ottenga l'elenco più recente di tutte le macchine virtuali non protette della sottoscrizione corrente e che le memorizzi nella cache. Dopo che la macchina virtuale è stata memorizzata nella cache, la funzionalità Servizi di ripristino sarà in grado di accedere alla macchina virtuale e di proteggerla.

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

Per l'URI di POST sono presenti i parametri {subscriptionId}, {vaultName}, {vaultresourceGroupName}, {fabricName}. Il valore di {fabricName} è "Azure". Come indicato nell'esempio, il valore di {vaultName} è "testVault" e il valore di {vaultresourceGroupName} è "testVaultRG". Tutti i parametri obbligatori vengono specificati nell'URI e di conseguenza il corpo di una richiesta separata non è necessario.

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

Risposte all'operazione di aggiornamento

L'operazione di aggiornamento è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

Restituisce due risposte: 202 (accettato) quando viene creata un'altra operazione e 200 (OK) al termine dell'operazione.

Nome	Tipo	Descrizione
204 No Content		OK senza alcun contenuto restituito
202 - Accettato		Accettata

Risposte di esempio all'operazione di aggiornamento:

Dopo che la richiesta POST è stata inviata, viene restituita una risposta 202 di accettazione.

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

Tenere traccia dell'operazione risultante tramite l'intestazione "Location" con un semplice comando GET.

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

Quando vengono individuate tutte le macchine virtuali di Azure, il comando GET restituisce una risposta 204 che non prevede la restituzione di alcun contenuto. L'insieme di credenziali è ora in grado di individuare tutte le macchine virtuali presenti nella sottoscrizione.

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

Selezione della macchina virtuale di Azure pertinente

È possibile verificare che la memorizzazione nella cache venga eseguita elencando tutti gli elementi da proteggere nella sottoscrizione e individuare la macchina virtuale desiderata nella risposta. La risposta di questa operazione dà anche informazioni sul modo in cui la funzionalità Servizi di ripristino identifica una macchina virtuale. Dopo aver acquisito familiarità con il modello, è possibile ignorare questo passaggio e procedere direttamente all'abilitazione della protezione.

Questa è un'operazione GET.

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

All'URI GET sono associati tutti i parametri obbligatori. Non è necessario alcun corpo della richiesta aggiuntivo.

Risposte all'operazione get

Nome	Tipo	Descrizione
200 OK	WorkloadProtectableItemResourceList	Ok

Risposte di esempio per ottenere l'operazione:

Dopo l'invio della richiesta GET , viene restituita la risposta 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"
      }
    },……………..

Suggerimento

Il numero di valori in una risposta GET è limitato a 200 per pagina. Usare il campo "nextLink" per ottenere l'URL per il set successivo di risposte.

La risposta contiene l'elenco di tutte le macchine virtuali di Azure non protette e ogni elemento {value} contiene tutte le informazioni necessarie dal servizio di ripristino di Azure per configurare il backup. Per configurare il backup, si notino i campi {name} e {virtualMachineId} nella sezione {properties}. Creare due variabili a partire dai valori di questi campi come indicato di seguito.

containerName = "iaasvmcontainer;"+{name}
protectedItemName = "vm;"+ {name}
{virtualMachineId} viene usato in seguito nel corpo della richiesta

Nell'esempio in valori precedenti vengono convertiti in:

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

Abilitare la protezione per la macchina virtuale di Azure

Dopo che la macchina virtuale di Azure è stata memorizzata nella cache e identificata, selezionare i criteri per la protezione. Per altre informazioni sui criteri esistenti, vedere l'elenco di API dei criteri e quindi selezionare i criteri rilevanti facendo riferimento al nome dei criteri stessi. Per creare i criteri, vedere l'esercitazione sulla creazione di criteri. Nell'esempio seguente è selezionato "DefaultPolicy".

L'abilitazione della protezione è un'operazione PUT asincrona che crea un elemento protetto.

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

Gli elementi {containerName} e {protectedItemName} sono come creati in precedenza. Il valore di {fabricName} è "Azure". Per questo esempio, la situazione è quindi la seguente:

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

Creare il corpo della richiesta

Di seguito vengono indicati i componenti del corpo della richiesta necessari per creare un elemento protetto.

Nome	Tipo	Descrizione
proprietà	AzureIaaSVMProtectedItem	Proprietà delle risorse ProtectedItem

Per l'elenco completo di definizioni del corpo della richiesta e altri dettagli, vedere il documento per creare l'API REST dell'elemento protetto.

Corpo della richiesta di esempio:

Il corpo della richiesta seguente definisce le proprietà necessarie per creare un elemento protetto.

{
  "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} è l'elemento {virtualMachineId} citato in precedenza per dalla risposta per l'elenco di elementi che è possibile proteggere. Risposte per creare un'operazione di elemento protetto @01011011

Risposte all'operazione di creazione di un elemento protetto

La creazione di un elemento protetto è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

Restituisce due risposte: 202 (accettato) quando viene creata un'altra operazione e 200 (OK) al termine dell'operazione.

Nome	Tipo	Descrizione
200 OK	ProtectedItemResource	Ok
202 - Accettato		Accettata

Risposte di esempio per creare un'operazione di elemento protetto:

Dopo aver inviato la richiesta PUT per la creazione o l'aggiornamento dell'elemento protetto, la risposta iniziale è 202 (accettazione) con intestazione location o Azure-async.

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

Tenere quindi traccia dell'operazione risultante usando l'intestazione location o Azure-AsyncOperation con un semplice comando GET.

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

Dopo che è stata completata, l'operazione restituisce 200 (OK) con il contenuto dell'elemento protetto nel corpo della risposta.

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

In questo modo si conferma che la protezione viene abilitata per la macchina virtuale e che il primo backup verrà attivato in base alla pianificazione dei criteri.

Esclusione dei dischi nel backup di macchine virtuali di Azure

Backup di Azure consente anche di eseguire il backup selettivo di un subset di dischi nella macchina virtuale di Azure. Altri dettagli sono disponibili qui. Se si vuole eseguire il backup selettivo di alcuni dischi durante l'abilitazione della protezione, il frammento di codice seguente deve essere il corpo della richiesta durante l'abilitazione della protezione.

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

Nel corpo della richiesta precedente, l'elenco dei dischi di cui eseguire il backup viene fornito nella sezione delle proprietà estese.

Proprietà	valore
diskLunList	L'elenco dei LUN del disco è un elenco di LUN di dischi dati. Il disco del sistema operativo viene sempre incluso nel backup e non deve essere menzionato.
IsInclusionList	Deve essere true affinché i LUN vengano inclusi durante il backup. Se è false, i LUN indicati in precedenza verranno esclusi.

Pertanto, se è necessario eseguire il backup solo del disco del sistema operativo, tutti i dischi dati devono essere esclusi. ovvero, per meglio dire, non deve essere incluso alcun disco dati. L'elenco dei LUN del disco sarà quindi vuoto e IsInclusionList sarà true. Analogamente, considerare il modo più semplice per selezionare un subset: alcuni dischi devono essere sempre esclusi o alcuni dischi devono essere sempre inclusi. Scegliere l'elenco dei LUN e il valore della variabile booleana di conseguenza.

Attivare un backup su richiesta per una macchina virtuale di Azure protetta

Dopo che una macchina virtuale di Azure viene configurata per il backup, i backup vengono eseguiti in base alla pianificazione dei criteri. È possibile attendere il primo backup pianificato o attivare un backup su richiesta in qualsiasi momento. La conservazione dei backup su richiesta è separata da quella dei criteri di backup e può essere specificata per una determinata data e ora. Se non specificato, si presuppone che la durata della conservazione sia di 30 giorni a partire dal giorno del trigger di backup su richiesta.

L'attivazione di un backup su richiesta è un'operazione POST.

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

Gli elementi {containerName} e {protectedItemName} sono come creati in precedenza. Il valore di {fabricName} è "Azure". Per questo esempio, la situazione è quindi la seguente:

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

Creare il corpo della richiesta per il backup su richiesta

Di seguito vengono indicati i componenti del corpo della richiesta necessari per attivare un backup su richiesta.

Nome	Tipo	Descrizione
proprietà	IaaSVMBackupRequest	Proprietà BackupRequestResource

Per l'elenco completo di definizioni del corpo della richiesta e altri dettagli, vedere il documento sull'API REST per attivare il backup di elementi protetti.

Esempio di corpo della richiesta per il backup su richiesta

Il corpo della richiesta seguente definisce le proprietà necessarie per attivare un backup per un elemento protetto. Se non specificato, si presuppone che la durata della conservazione sia di 30 giorni a partire dal giorno dell'attivazione del processo di backup.

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

Risposte per il backup su richiesta

L'attivazione di un backup su richiesta è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

Restituisce due risposte: 202 (accettato) quando viene creata un'altra operazione e 200 (OK) al termine dell'operazione.

Nome	Tipo	Descrizione
202 - Accettato		Accettata

Esempi di risposte per il backup su richiesta

Dopo aver inviato la richiesta POST per un backup su richiesta, la risposta iniziale è 202 (accettazione) con un'intestazione location o Azure-async.

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

Tenere quindi traccia dell'operazione risultante usando l'intestazione location o Azure-AsyncOperation con un semplice comando GET.

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

Al termine dell'operazione, viene restituita la risposta 200 (OK) con l'ID del processo di backup risultante nel corpo della risposta.

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

Poiché il processo di backup è un'operazione con esecuzione prolungata, ne deve essere tenuta traccia come illustrato nel documento per monitorare i processi usando l'API REST.

Modificare la configurazione di backup per una macchina virtuale di Azure protetta

Modifica dei criteri di protezione

Per modificare i criteri con cui la macchina virtuale è protetta, è possibile usare lo stesso formato dell'abilitazione della protezione. È sufficiente fornire il nuovo ID criteri nel corpo della richiesta e inviare la richiesta. Esempio: per modificare i criteri di testVM da 'DefaultPolicy' in 'ProdPolicy', specificare l'ID 'ProdPolicy' nel corpo della richiesta.

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

Il formato della risposta è analogo a quello indicato per l'abilitazione della protezione

Esclusione dei dischi durante la protezione delle macchine virtuali di Azure

Se è già stato eseguito il backup della macchina virtuale di Azure, è possibile specificare l'elenco dei dischi di cui eseguire il backup o da escludere modificando i criteri di protezione. È sufficiente preparare la richiesta nello stesso formato valido per l'esclusione dei dischi durante l'abilitazione della protezione

Importante

Il corpo della richiesta precedente è sempre la copia finale dei dischi dati da escludere o includere. La configurazione non è aggiuntiva rispetto a quella precedente. Ad esempio: se si aggiorna prima la protezione "escludendo il disco dati 1" e quindi si ripete "escludendo il disco dati 2", solo il disco dati 2 viene escluso nei backup successivi e il disco dati 1 verrà incluso. Si tratta sempre dell'elenco finale che verrà incluso/escluso nei backup successivi.

Per ottenere l'elenco corrente dei dischi esclusi o inclusi, recuperare le informazioni sugli elementi protetti come indicato qui. La risposta fornirà l'elenco dei LUN del disco dati e indica se sono inclusi o esclusi.

Arrestare la protezione dati, ma conservare i dati esistenti

Per rimuovere la protezione in una macchina virtuale protetta conservando contemporaneamente i dati di cui è stato eseguito il backup, rimuovere i criteri dal corpo della richiesta e inviare la richiesta stessa. Dopo che l'associazione ai criteri è stata rimossa, i backup non vengono più attivati e non viene creato alcun nuovo punto di ripristino.

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

Il formato della risposta è analogo a quello indicato per attivare un backup su richiesta. Il processo risultante deve essere rilevato come illustrato nel documento per monitorare i processi usando l'API REST.

Arrestare la protezione ed eliminare i dati

Per rimuovere la protezione in una macchina virtuale protetta ed eliminare anche i dati di backup, eseguire un'operazione di eliminazione come descritto in dettaglio qui.

L'arresto della protezione e l'eliminazione dei dati sono operazioni DELETE.

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

Gli elementi {containerName} e {protectedItemName} sono come creati in precedenza. {fabricName} è "Azure". Per questo esempio, la situazione è quindi la seguente:

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

Risposte per la protezione dall'eliminazione

L'operazione DELETE applicata alla protezione è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

Restituisce due risposte: 202 (accettato) quando viene creata un'altra operazione e 204 (NoContent) al termine dell'operazione.

Nome	Tipo	Descrizione
204 NoContent (Nessun contenuto)		Nessun contenuto restituito
202 - Accettato		Accettata

Importante

Per proteggersi da scenari di eliminazione accidentale, è disponibile la funzionalità di eliminazione temporanea per l'insieme di credenziali di Servizi di ripristino. Se lo stato di eliminazione temporanea dell'insieme di credenziali è impostato su abilitato, l'operazione di eliminazione non eliminerà immediatamente i dati. I dati verranno conservati per 14 giorni e poi rimossi definitivamente. Non è previsto alcun addebito per l'archiviazione per questo periodo di 14 giorni. Per annullare l'operazione di eliminazione, fare riferimento alla sezione Annullare l'eliminazione.

Annullare l'eliminazione

L'annullamento dell'eliminazione accidentale è simile alla creazione dell'elemento di backup. Dopo l'annullamento dell'eliminazione, l'elemento viene conservato ma non vengono attivati backup futuri.

L'annullamento dell'eliminazione è un'operazione PUT molto simile alla modifica dei criteri e/o all'abilitazione della protezione. Indicare semplicemente l'intenzione di annullare l'eliminazione con la variabile isRehydrate nel corpo della richiesta e inviare la richiesta. Per annullare l'eliminazione per testVM, ad esempio, è necessario usare il corpo della richiesta seguente.

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

Passaggi successivi

Restore data from an Azure Virtual machine backup (Ripristinare i dati da un backup di macchina virtuale di Azure).

Per altre informazioni sulle API REST di Backup di Azure, vedere i documenti seguenti:

Azure Recovery Services provider REST API (API REST del provider di Servizi di ripristino di Azure)
Introduzione all'API REST di Azure

Condividi tramite

Eseguire il backup di una macchina virtuale di Azure con Backup di Azure tramite l'API REST

Configurare il backup di una macchina virtuale di Azure non protetta con l'API REST

Individuare le macchine virtuali di Azure non protette

Risposte all'operazione di aggiornamento

Selezione della macchina virtuale di Azure pertinente

Risposte all'operazione get

Abilitare la protezione per la macchina virtuale di Azure

Creare il corpo della richiesta

Risposte all'operazione di creazione di un elemento protetto

Esclusione dei dischi nel backup di macchine virtuali di Azure

Attivare un backup su richiesta per una macchina virtuale di Azure protetta

Creare il corpo della richiesta per il backup su richiesta

Esempio di corpo della richiesta per il backup su richiesta

Risposte per il backup su richiesta

Esempi di risposte per il backup su richiesta

Modificare la configurazione di backup per una macchina virtuale di Azure protetta

Modifica dei criteri di protezione

Esclusione dei dischi durante la protezione delle macchine virtuali di Azure

Arrestare la protezione dati, ma conservare i dati esistenti

Arrestare la protezione ed eliminare i dati

Risposte per la protezione dall'eliminazione

Annullare l'eliminazione

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive