Azure-beli virtuális gépek visszaállítása REST API használatával

Ez a cikk azt ismerteti, hogyan állíthat vissza Azure-beli virtuális gépeket vagy lemezeket a REST API használatával.

Előfeltételek

Miután elvégezte az Azure-beli virtuális gépek biztonsági mentését az Azure Backuppal, teljes virtuális gépeket, lemezeket vagy fájlokat állíthat vissza ugyanabból a biztonsági másolatból. Minden visszaállítási művelethez először azonosítania kell a megfelelő helyreállítási pontot.

Helyreállítási pont kiválasztása

A biztonsági mentési elem elérhető helyreállítási pontjai a REST API lista helyreállítási pontjának használatával listázhatók. Ez egy egyszerű GET művelet az összes releváns értékkel.

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

Az {containerName} és {protectedItemName} úgy épülnek itt. {fabricName} az Azure.

A GET URI az összes szükséges paramétert használja. Nincs szükség további kérelemtörzsre.

Válaszok

Név	Típus	Leírás
200 OK	RecoveryPointResourceList	OK

Példaválasz

A GET URI elküldése után a rendszer 200 (OK) választ ad vissza.

HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: 03453538-2f8d-46de-8374-143ccdf60f40
x-ms-client-request-id: c48f4436-ce3f-42da-b537-12710d4d1a24; c48f4436-ce3f-42da-b537-12710d4d1a24
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14998
x-ms-correlation-request-id: 03453538-2f8d-46de-8374-143ccdf60f40
x-ms-routing-request-id: SOUTHINDIA:20180604T071851Z:03453538-2f8d-46de-8374-143ccdf60f40
Cache-Control: no-cache
Date: Mon, 04 Jun 2018 07:18:51 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/protectedItems/VM;testRG;testVM/recoveryPoints/20982486783671",
      "name": "20982486783671",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "AppConsistent",
        "recoveryPointTime": "2018-06-04T06:06:00.5121087Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "NormalStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": 1,
            "status": 1
          },
          {
            "type": 2,
            "status": 1
          }
        ],
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_A1_v2",
        "originalStorageAccountOption": false
      }
    },
    {
      "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/recoveryPoints/23358112038108",
      "name": "23358112038108",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2018-06-03T06:20:56.3043878Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "NormalStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": 1,
            "status": 1
          },
          {
            "type": 2,
            "status": 1
          }
        ],
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_A1_v2",
        "originalStorageAccountOption": false
      }
    },
......

A helyreállítási pontot a {name} megadott válasz mezője azonosítja.

Visszaállítási műveletek

A megfelelő visszaállítási pont kiválasztása után indítsa el a visszaállítási műveletet.

A biztonsági mentési elem összes visszaállítási művelete ugyanazzal a POST API-val történik. Csak a kérelem törzse változik a visszaállítási forgatókönyvekkel.

Fontos

A különböző visszaállítási lehetőségekről és azok függőségeiről itt olvashat bővebben. Kérjük, tekintse át, mielőtt elindítja ezeket a műveleteket.

A visszaállítási műveletek aktiválása egy POST-kérés. További információ az "eseményindító visszaállítása" REST API-ról.

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

Az {containerName} és {protectedItemName} úgy épülnek itt. {fabricName}az "Azure", és a {recoveryPointId}{name} fent említett helyreállítási pont mezője.

A helyreállítási pont beszerzése után hozza létre a megfelelő visszaállítási forgatókönyv kérelemtörzsét. Az alábbi szakaszok az egyes forgatókönyvek kérelemtörzsét ismertetik:

Lemezek visszaállítása
Lemezek cseréje
Visszaállítás új virtuális gépként

Válasz visszaállítása

Bármely visszaállítási művelet aktiválása aszinkron művelet. Ez azt jelenti, hogy ez a művelet létrehoz egy másik műveletet, amelyet külön kell nyomon követni.

Két választ ad vissza: 202 (Elfogadva) egy másik művelet létrehozásakor, majd 200 (OK) a művelet befejezésekor.

Név	Típus	Leírás
202 Elfogadva		Elfogadva

Példaválaszok

Miután elküldte a POST URI-t a visszaállítási lemezek elindításához, a kezdeti válasz 202 (elfogadva) helyfejléc vagy Azure-async-fejléc használatával.

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/781a0f18-e250-4d73-b059-5e9ffed4069e?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: 893fe372-8d6c-4c56-b589-45a95eeef95f
x-ms-client-request-id: a15ce064-25bd-4ac6-87e5-e3bc6ec65c0b; a15ce064-25bd-4ac6-87e5-e3bc6ec65c0b
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1198
x-ms-correlation-request-id: 893fe372-8d6c-4c56-b589-45a95eeef95f
x-ms-routing-request-id: SOUTHINDIA:20180604T130003Z:893fe372-8d6c-4c56-b589-45a95eeef95f
Cache-Control: no-cache
Date: Mon, 04 Jun 2018 13:00:03 GMT
Location: https://management.azure.com/subscriptions//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/781a0f18-e250-4d73-b059-5e9ffed4069e?api-version=2019-05-13
X-Powered-By: ASP.NET

Ezután kövesse nyomon az eredményül kapott műveletet a helyfejléc vagy az Azure-AsyncOperation fejléc használatával egy egyszerű GET paranccsal.

GET https://management.azure.com/subscriptions//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/781a0f18-e250-4d73-b059-5e9ffed4069e?api-version=2019-05-13

Miután a művelet befejeződött, a válasz törzsében a 200 (OK) értéket adja vissza az eredményül kapott visszaállítási feladat azonosítójával.

HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: ea2a8011-eb83-4a4b-9ed2-e694070a966a
x-ms-client-request-id: a7f3a144-ed80-41ee-bffe-ae6a90c35a2f; a7f3a144-ed80-41ee-bffe-ae6a90c35a2f
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14973
x-ms-correlation-request-id: ea2a8011-eb83-4a4b-9ed2-e694070a966a
x-ms-routing-request-id: SOUTHINDIA:20180604T130917Z:ea2a8011-eb83-4a4b-9ed2-e694070a966a
Cache-Control: no-cache
Date: Mon, 04 Jun 2018 13:09:17 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET

{
  "id": "781a0f18-e250-4d73-b059-5e9ffed4069e",
  "name": "781a0f18-e250-4d73-b059-5e9ffed4069e",
  "status": "Succeeded",
  "startTime": "2018-06-04T13:00:03.8068176Z",
  "endTime": "2018-06-04T13:00:03.8068176Z",
  "properties": {
    "objectType": "OperationStatusJobExtendedInfo",
    "jobId": "3021262a-fb3a-4538-9b37-e3e97a386093"
  }
}

Mivel a visszaállítási feladat egy hosszú ideig futó művelet, a REST API-dokumentum használatával a monitorozási feladatokban leírtak szerint kell nyomon követni.

Lemezek visszaállítása

Ha testre kell szabni egy virtuális gép létrehozását a biztonsági mentési adatokból, állítsa vissza a lemezeket egy kiválasztott tárfiókba, és hozzon létre egy virtuális gépet ezekből a lemezekről a követelményeknek megfelelően. A tárfióknak ugyanabban a régióban kell lennie, mint a Recovery Services-tárolónak, és nem szabad zónaredundánsnak lennie. A lemezeket, valamint a biztonsági másolatot készítő virtuális gép (vmconfig.json) konfigurációját a rendszer az adott tárfiókban tárolja. Az itt leírtak szerint a lemezek visszaállítására vonatkozó kérelemtörzset alább találja.

Kérelem törzsének létrehozása

Ha lemez-visszaállítást szeretne aktiválni egy Azure-beli virtuális gép biztonsági mentéséből, kövesse a kérelem törzsének összetevőit:

Név	Típus	Leírás
tulajdonságok	IaaSVM-visszaállítási kérelem	VisszaállításiKérésErőforrásTulajdonságok

A kérelem törzsének definícióinak teljes listáját és egyéb részleteit az eseményindító REST API-jának visszaállítása című cikkben találja.

Példa kérés

A következő kérelemtörzs a lemez-visszaállítás aktiválásához szükséges tulajdonságokat határozza meg:

{
  "properties": {
    "objectType": "IaasVMRestoreRequest",
    "recoveryPointId": "20982486783671",
    "recoveryType": "RestoreDisks",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Storage/storageAccounts/testAccount",
    "region": "westus",
    "createNewCloudService": false,
    "originalStorageAccountOption": false,
    "encryptionDetails": {
      "encryptionEnabled": false
    }
  }
}

Lemezek szelektív visszaállítása

Ha szelektíven ment lemezeket, akkor a jelenlegi biztonsági mentéssel lefedett lemezek listáját a helyreállítási pont összefoglalója és a részletes válasz tartalmazza. A lemezeket szelektíven is visszaállíthatja, és további részleteket itt talál. Ha szelektíven szeretne helyreállítani egy lemezt a biztonsági másolatok listájában, keresse meg a lemez LUN-ját a helyreállítási pont válaszából, és adja hozzá a restoreDiskLunList tulajdonságot a fenti kérelemtörzshöz az alább látható módon.

{
    "properties": {
        "objectType": "IaasVMRestoreRequest",
        "recoveryPointId": "20982486783671",
        "recoveryType": "RestoreDisks",
        "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
        "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Storage/storageAccounts/testAccount",
        "region": "westus",
        "createNewCloudService": false,
        "originalStorageAccountOption": false,
        "encryptionDetails": {
          "encryptionEnabled": false
        },
        "restoreDiskLunList" : [0]
    }
}

Miután nyomon követte a választ az itt leírtak szerint, és a hosszú ideig futó feladat befejeződött, a biztonsági mentést futtató virtuális gép (VMConfig.json) lemezei és konfigurációja megjelenik az adott tárfiókban.

Lemezek cseréje egy biztonsági mentéssel rendelkező virtuális gépen

Míg a lemezek visszaállítása lemezeket hoz létre a helyreállítási pontból, a lemezek cseréje a biztonsági másolatban lévő virtuális gép aktuális lemezeit a helyreállítási pont lemezeire cseréli. Az itt leírtak szerint a lemezek cseréjére vonatkozó kérelemtörzset alább találja.

Kérelem törzsének létrehozása

Az Azure virtuális gép biztonsági mentéséből indítható lemezcseréhez a kérés törzse a következő összetevőket tartalmazza.

Név	Típus	Leírás
tulajdonságok	IaaSVMRestoreRequest	VisszaállításiKérésErőforrásTulajdonságok

A kérelem törzsének definícióit és egyéb részleteket a Visszaállítás REST API dokumentum-ban találja.

Példakérés

A következő kérelemtörzs a lemez-visszaállítás indításához szükséges tulajdonságokat határozza meg.

{
    "properties": {
        "objectType": "IaasVMRestoreRequest",
        "recoveryPointId": "20982486783671",
        "recoveryType": "OriginalLocation",
        "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
        "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Storage/storageAccounts/testAccount",  
        "region": "westus",
        "createNewCloudService": false,
        "originalStorageAccountOption": false,
        "affinityGroup": "",
        "diskEncryptionSetId": null,
        "subnetId": null,
        "targetDomainNameId": null,
        "targetResourceGroupId": null,
        "targetVirtualMachineId": null,
        "virtualNetworkId": null
     }
}

Állítsa vissza másik virtuális gépként

A fentiekben ismertetett módon a következő kérelemtörzs határozza meg a virtuális gépek visszaállításához szükséges tulajdonságokat.

{
  "properties": {
          "objectType":  "IaasVMRestoreRequest",
          "recoveryPointId": "348916168024334",
          "recoveryType": "AlternateLocation",
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
          "targetVirtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/targetRG/providers/Microsoft.Compute/virtualmachines/targetVM",
          "targetResourceGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/targetRG",
          "storageAccountId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Storage/storageAccounts/testingAccount",
          "virtualNetworkId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/targetRG/providers/Microsoft.Network/virtualNetworks/testNet",
          "subnetId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/targetRG/providers/Microsoft.Network/virtualNetworks/testNet/subnets/default",
          "region": "westus",
          "createNewCloudService": false,
          "originalStorageAccountOption": false,
          "encryptionDetails": {
            "encryptionEnabled": false
          }
     }
 }

A választ ugyanúgy kell kezelni, mint a lemezek visszaállítására vonatkozó fent leírtakat.

Régiók közötti visszaállítás

Ha a régiók közötti visszaállítás (CRR) engedélyezve van azon a tárolón, amellyel védte a virtuális gépeket, a rendszer replikálja a biztonsági mentési adatokat a másodlagos régióba. A biztonsági mentési adatokkal visszaállítási műveletet hajthat végre. Ha REST API-val szeretne visszaállítási műveletet indítani a másodlagos régióban, kövesse az alábbi lépéseket:

Helyreállítási pont kiválasztása a másodlagos régióban

A crr-hez készült REST API-val listázhatja a másodlagos régióban található biztonsági mentési elemek rendelkezésre álló helyreállítási pontjait. Ez egy egyszerű GET művelet az összes releváns értékkel.

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints?api-version=2018-12-20

Az {containerName} és {protectedItemName} úgy épülnek itt. {fabricName} az Azure.

A GET URI az összes szükséges paramétert használja. Nincs szükség további kérési törzsre.

Feljegyzés

A másodlagos régióban a helyreállítási pontok lekéréséhez használja az API 2018-12-20-as verzióját, mint a fenti példában.

Válaszok

Név	Típus	Leírás
200 OK	RecoveryPointResourceList	OK

Példaválasz

A GET URI elküldése után a rendszer 200 (OK) választ ad vissza.

Headers:
Pragma                        : no-cache
X-Content-Type-Options        : nosniff
x-ms-request-id               : bfc4a4e6-c585-46e0-8e38-f11a86093701
x-ms-client-request-id        : 4344a9c2-70d8-482d-b200-0ca9cc498812,4344a9c2-70d8-482d-b200-0ca9cc498812
Strict-Transport-Security     : max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-resource-requests: 149
x-ms-correlation-request-id   : bfc4a4e6-c585-46e0-8e38-f11a86093701
x-ms-routing-request-id       : SOUTHINDIA:20210731T112441Z:bfc4a4e6-c585-46e0-8e38-f11a86093701
Cache-Control                 : no-cache
Date                          : Sat, 31 Jul 2021 11:24:40 GMT
Server                        : Microsoft-IIS/10.0
X-Powered-By                  : ASP.NET

Body:
{
  "value": [
    {
      "id":
"/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG1;testVM/protectedItems/VM;iaasvmcontainerv2;testRG1;testVM/recoveryPoints/932895704780058094",
      "name": "932895704780058094",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2021-07-31T09:24:34.687561Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "PremiumVMOnPartialPremiumStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": 1,
            "status": 1
          }
        ],
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_D2s_v3",
        "originalStorageAccountOption": false,
        "osType": "Windows"
      }
    },
    {
      "id":
"/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG1;testVM/protectedItems/VM;iaasvmcontainerv2;testRG1;testVM/recoveryPoints/932891484644960954",
      "name": "932891484644960954",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
      "properties": {
        "objectType": "IaasVMRecoveryPoint",
        "recoveryPointType": "CrashConsistent",
        "recoveryPointTime": "2021-07-30T09:20:01.8355052Z",
        "recoveryPointAdditionalInfo": "",
        "sourceVMStorageType": "PremiumVMOnPartialPremiumStorage",
        "isSourceVMEncrypted": false,
        "isInstantIlrSessionActive": false,
        "recoveryPointTierDetails": [
          {
            "type": 1,
            "status": 1
          },
          {
            "type": 2,
            "status": 1
          }
        ],
        "isManagedVirtualMachine": true,
        "virtualMachineSize": "Standard_D2s_v3",
        "originalStorageAccountOption": false,
        "osType": "Windows"
      }
    },
.....

A helyreállítási pontot a rendszer a {name} fenti válaszban szereplő mezővel azonosítja.

Hozzáférési jogkivonat lekérése

A régiók közötti visszaállítás végrehajtásához hozzáférési jogkivonatra van szükség, amely engedélyezi a kérést a másodlagos régió replikált visszaállítási pontjaihoz való hozzáféréshez. Hozzáférési jogkivonat beszerzéséhez kövesse az alábbi lépéseket:

1. lépés:

Az AAD Properties API használatával szerezze be a másodlagos régió AAD-tulajdonságait (az alábbi példában westus):

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/westus/backupAadProperties?api-version=2018-12-20

Példa válaszra

A válasz a következő formátumban lesz visszaadva:

{
  "properties": {
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "audience": "https://RecoveryServices/IaasCoord/aadmgmt/wus",
    "servicePrincipalObjectId": "00000000-0000-0000-0000-000000000000"
  }
}

2. lépés:

A Hozzáférési jogkivonat lekérése API használatával engedélyezze a kérést a másodlagos régió replikált visszaállítási pontjainak elérésére:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/recoveryPoints/{recoveryPointId}/accessToken?api-version=2018-12-20

A kérelem törzséhez illessze be az AAD Properties API által az előző lépésben visszaadott válasz tartalmát.

{
  "properties": {
    "tenantId": "00000000-0000-0000-0000-000000000000",
    "audience": "https://RecoveryServices/IaasCoord/aadmgmt/wus",
    "servicePrincipalObjectId": "00000000-0000-0000-0000-000000000000"
  }
}

Példa válaszra

A válasz a következő formátumban lesz visszaadva:

{
	"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG1;testVM/protectedItems/VM;iaasvmcontainerv2;testRG1;testVM/recoveryPoints/26083826328862",
  "name": "932879774590051503",
  "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints",
	"properties": {
		"objectType": "CrrAccessToken",
		"accessTokenString": "<access-token-string>",
		"subscriptionId": "00000000-0000-0000-0000-000000000000",
		"resourceGroupName": "testVaultRG",
		"resourceName": "testVault",
		"resourceId": "000000000000000000",
		"protectionContainerId": 000000,
		"recoveryPointId": "932879774590051503",
		"recoveryPointTime": "7/26/2021 3:35:36 PM",
		"containerName": "iaasvmcontainerv2;testRG1;testVM",
		"containerType": "IaasVMContainer",
		"backupManagementType": "AzureIaasVM",
		"datasourceType": "VM",
		"datasourceName": "testvm1234",
		"datasourceId": "000000000000000000",
		"datasourceContainerName": "iaasvmcontainerv2;testRG1;testVM",
		"coordinatorServiceStampUri": "https://pod01-coord1.eus.backup.windowsazure.com",
		"protectionServiceStampId": "00000000-0000-0000-0000-000000000000",
		"protectionServiceStampUri": "https://pod01-prot1h-int.eus.backup.windowsazure.com",
		"tokenExtendedInformation": "<IaaSVMRecoveryPointMetadataBase xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" i:type=\"IaaSVMRecoveryPointMetadata_V2015_09\" xmlns=\"http://windowscloudbackup.com/CloudCommon/V2011_09\"><MetadataVersion>V2015_09</MetadataVersion><ContainerType i:nil=\"true\" /><InstantRpGCId>ef4ab5a7-c2c0-4304-af80-af49f48af3d1;AzureBackup_testvm1234_932843259176972511;AzureBackup_20210726_033536;AzureBackupRG_eastus_1</InstantRpGCId><IsBlockBlobEnabled>true</IsBlockBlobEnabled><IsManagedVirtualMachine>true</IsManagedVirtualMachine><OriginalSAOption>false</OriginalSAOption><OsType>Windows</OsType><ReadMetadaFromConfigBlob i:nil=\"true\" /><RecoveryPointConsistencyType>CrashConsistent</RecoveryPointConsistencyType><RpDiskDetails i:nil=\"true\" /><SourceIaaSVMRPKeyAndSecret i:nil=\"true\" /><SourceIaaSVMStorageType>PremiumVMOnPartialPremiumStorage</SourceIaaSVMStorageType><VMSizeDescription>Standard_D2s_v3</VMSizeDescription><Zones xmlns:d2p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\" i:nil=\"true\" /></IaaSVMRecoveryPointMetadataBase>",
		"rpTierInformation": {
			"InstantRP": "Valid",
			"HardenedRP": "Valid"
		},
		"rpOriginalSAOption": false,
		"rpIsManagedVirtualMachine": true,
		"rpVMSizeDescription": "Standard_D2s_v3",
		"bMSActiveRegion": "EastUS"
	}
}

Lemezek visszaállítása a másodlagos régióba

A Régiók közötti visszaállítási Trigger API használatával visszaállíthat egy elemet a másodlagos régióba.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.RecoveryServices/locations/{azureRegion}/backupCrossRegionRestore?api-version=2018-12-20

A kérelem törzsének két részből kell állnia:

crossRegionRestoreAccessDetails: Illessze be az előző lépésben végrehajtott Access Token API-kérés válaszának tulajdonságblokkját a kérelem törzsének ezen szegmensének kitöltéséhez.
restoreRequest: A kérelem törzsének restoreRequest szegmensének kitöltéséhez meg kell adnia a korábban beszerzett helyreállításipont-azonosítót, valamint a forrás virtuális gép Azure Resource Manager (ARM) azonosítóját, valamint az átmeneti helyként használandó másodlagos régióban lévő tárfiók részleteit. A lemez-visszaállítás végrehajtásához adja meg a RestoreDisks értéket helyreállítási típusként.

A következő mintakérés törzse egy virtuális gép lemezeinek a másodlagos régióba való visszaállítására:

 {
  "crossRegionRestoreAccessDetails": {
        "objectType": "CrrAccessToken",
	    "accessTokenString": "<access-token-string>",
	    "subscriptionId": "00000000-0000-0000-0000-000000000000",
	    "resourceGroupName": "azurefiles",
	    "resourceName": "azurefilesvault",
	    "resourceId": "000000000000000000",
	    "protectionContainerId": 000000,
	    "recoveryPointId": "932879774590051503",
	    "recoveryPointTime": "7/26/2021 3:35:36 PM",
	    "containerName": "iaasvmcontainerv2;testRG1;testVM",
	    "containerType": "IaasVMContainer",
	    "backupManagementType": "AzureIaasVM",
		"datasourceType": "VM",
		"datasourceName": "testvm1234",
		"datasourceId": "000000000000000000",
		"datasourceContainerName": "iaasvmcontainerv2;testRG1;testVM",
		"coordinatorServiceStampUri": "https://pod01-coord1.eus.backup.windowsazure.com",
		"protectionServiceStampId": "00000000-0000-0000-0000-000000000000",
		"protectionServiceStampUri": "https://pod01-prot1h-int.eus.backup.windowsazure.com",
		"tokenExtendedInformation": "<IaaSVMRecoveryPointMetadataBase xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" i:type=\"IaaSVMRecoveryPointMetadata_V2015_09\" xmlns=\"http://windowscloudbackup.com/CloudCommon/V2011_09\"><MetadataVersion>V2015_09</MetadataVersion><ContainerType i:nil=\"true\" /><InstantRpGCId>ef4ab5a7-c2c0-4304-af80-af49f48af3d1;AzureBackup_testvm1234_932843259176972511;AzureBackup_20210726_033536;AzureBackupRG_eastus_1</InstantRpGCId><IsBlockBlobEnabled>true</IsBlockBlobEnabled><IsManagedVirtualMachine>true</IsManagedVirtualMachine><OriginalSAOption>false</OriginalSAOption><OsType>Windows</OsType><ReadMetadaFromConfigBlob i:nil=\"true\" /><RecoveryPointConsistencyType>CrashConsistent</RecoveryPointConsistencyType><RpDiskDetails i:nil=\"true\" /><SourceIaaSVMRPKeyAndSecret i:nil=\"true\" /><SourceIaaSVMStorageType>PremiumVMOnPartialPremiumStorage</SourceIaaSVMStorageType><VMSizeDescription>Standard_D2s_v3</VMSizeDescription><Zones xmlns:d2p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\" i:nil=\"true\" /></IaaSVMRecoveryPointMetadataBase>",
		"rpTierInformation": {
			"InstantRP": "Valid",
			"HardenedRP": "Valid"
		},
		"rpOriginalSAOption": false,
		"rpIsManagedVirtualMachine": true,
		"rpVMSizeDescription": "Standard_D2s_v3",
		"bMSActiveRegion": "EastUS"
    },
    "restoreRequest": {
        "affinityGroup": "",
        "createNewCloudService": false,
        "encryptionDetails": {
            "encryptionEnabled": false
        },
        "objectType": "IaasVMRestoreRequest",
        "recoveryPointId": "932879774590051503",
        "recoveryType": "RestoreDisks",
        "sourceResourceId":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG1/providers/Microsoft.Compute/virtualMachines/testVM",
        "targetResourceGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG1",
        "storageAccountId":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG1/providers/Microsoft.Storage/storageAccounts/testStorageAccount",
        "region": "westus",
        "affinityGroup": "",
        "createNewCloudService": false,
        "originalStorageAccountOption": false,
        "restoreDiskLunList": []
    }
}

Az elsődleges régió visszaállítási műveletéhez hasonlóan ez egy aszinkron művelet, amelyet külön kell nyomon követni.

Következő lépések

Az Azure Backup REST API-kkal kapcsolatos további információkért tekintse meg a következő dokumentumokat:

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-04-07

Megosztás a következőn keresztül:

Azure-beli virtuális gépek visszaállítása REST API használatával

Előfeltételek

Helyreállítási pont kiválasztása

Válaszok

Példaválasz

Visszaállítási műveletek

Válasz visszaállítása

Példaválaszok

Lemezek visszaállítása

Kérelem törzsének létrehozása

Példa kérés

Lemezek szelektív visszaállítása

Lemezek cseréje egy biztonsági mentéssel rendelkező virtuális gépen

Kérelem törzsének létrehozása

Példakérés

Állítsa vissza másik virtuális gépként

Régiók közötti visszaállítás

Helyreállítási pont kiválasztása a másodlagos régióban

Válaszok

Példaválasz

Hozzáférési jogkivonat lekérése

1. lépés:

Példa válaszra

2. lépés:

Példa válaszra

Lemezek visszaállítása a másodlagos régióba

Következő lépések

Visszajelzés

További források