Återställa Azure-filresurser med hjälp av REST API

Artikel
10/16/2024

Den här artikeln beskriver hur du återställer en hel filresurs eller specifika filer från en återställningspunkt som skapats av Azure Backup med hjälp av REST-API:et.

I slutet av den här artikeln får du lära dig hur du utför följande åtgärder med hjälp av REST API:

Visa återställningspunkter för en säkerhetskopierad Azure-filresurs.
Återställa en fullständig Azure-filresurs.
Återställa enskilda filer eller mappar.

Förutsättningar

Vi antar att du redan har en säkerhetskopierad filresurs som du vill återställa. Om du inte gör det kontrollerar du Säkerhetskopiering av Azure-filresurs med HJÄLP av REST API för att lära dig hur du skapar en.

I den här artikeln använder vi följande resurser:

RecoveryServicesVault: azurefilesvault
Resursgrupp: azurefiles
Lagringskonto: afsaccount
Filresurs: azurefiles

Hämta ContainerName och ProtectedItemName

För de flesta återställningsrelaterade API-anrop måste du skicka värden för URI-parametrarna {containerName} och {protectedItemName}. Använd ID-attributet i svarstexten i åtgärden GET backupprotectableitems för att hämta värden för dessa parametrar. I vårt exempel är ID:t för den filresurs som vi vill skydda:

"/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/storagecontainer;storage;azurefiles;afsaccount/protectableItems/azurefileshare;azurefiles

Så värdena översätts på följande sätt:

{containername} – storagecontainer; lagring; azurefiles; afsaccount
{protectedItemName} – azurefileshare; azurefiles

Om du vill återställa en säkerhetskopierad filresurs eller filer väljer du först en återställningspunkt för att utföra återställningsåtgärden. Tillgängliga återställningspunkter för ett säkerhetskopierat objekt kan visas med hjälp av REST API-anropet för återställningspunktlista . Det är en GET-åtgärd med alla relevanta värden.

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&$filter={$filter}

Ange URI-värdena på följande sätt:

{fabricName}: Azure
{vaultName}: azurefilesvault
{containername}: storagecontainer; lagring; azurefiles; afsaccount
{protectedItemName}: azurefileshare; azurefiles
{ResourceGroupName}: azurefiles

GET-URI:n har alla nödvändiga parametrar. Det finns inget behov av en annan begärandetext.

GET https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/recoveryPoints?api-version=2019-05-13

Exempelsvar för att hämta återställningspunkter

När GET-URI:n har skickats returneras ett 200-svar:

HTTP/1.1" 200 None
'Cache-Control': 'no-cache'
'Pragma': 'no-cache'
'Transfer-Encoding': 'chunked'
'Content-Type': 'application/json'
'Content-Encoding': 'gzip'
'Expires': '-1'
'Vary': 'Accept-Encoding'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': 'd68d7951-7d97-4c49-9a2d-7fbaab55233a'
'x-ms-client-request-id': '4edb5a58-47ea-11ea-a27a-0a580af41908, 4edb5a58-47ea-11ea-a27a-0a580af41908'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'Server': 'Microsoft-IIS/10.0'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-reads': '11998'
'x-ms-correlation-request-id': 'd68d7951-7d97-4c49-9a2d-7fbaab55233a'
'x-ms-routing-request-id': 'WESTEUROPE:20200205T073708Z:d68d7951-7d97-4c49-9a2d-7fbaab55233a'
'Date': 'Wed, 05 Feb 2020 07:37:08 GMT'
{
“value”:[
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/recoveryPoints/932881138555802864",
    "location": null,
    "name": "932881138555802864",
    "properties": {
      "fileShareSnapshotUri": "https://afsaccount.file.core.windows.net/azurefiles?sharesnapshot=2020-02-04T08:01:35.0000000Z",
      "objectType": "AzureFileShareRecoveryPoint",
      "recoveryPointSizeInGb": 1,
      "recoveryPointTime": "2020-02-04T08:01:35+00:00",
      "recoveryPointType": "FileSystemConsistent"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints"
  },
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/recoveryPoints/932878582606969225",
    "location": null,
    "name": "932878582606969225",
    "properties": {
      "fileShareSnapshotUri": "https://afsaccount.file.core.windows.net/azurefiles?sharesnapshot=2020-02-03T08:05:30.0000000Z",
      "objectType": "AzureFileShareRecoveryPoint",
      "recoveryPointSizeInGb": 1,
      "recoveryPointTime": "2020-02-03T08:05:30+00:00",
      "recoveryPointType": "FileSystemConsistent"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints"
  },
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/recoveryPoints/932890167574511261",
    "location": null,
    "name": "932890167574511261",
    "properties": {
      "fileShareSnapshotUri": "https://afsaccount.file.core.windows.net/azurefiles?sharesnapshot=2020-02-02T08:03:50.0000000Z",
      "objectType": "AzureFileShareRecoveryPoint",
      "recoveryPointSizeInGb": 1,
      "recoveryPointTime": "2020-02-02T08:03:50+00:00",
      "recoveryPointType": "FileSystemConsistent"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems/recoveryPoints"
  },

Återställningspunkten identifieras med fältet {name} i svaret ovan.

Använd det här återställningsalternativet för att återställa den fullständiga filresursen på den ursprungliga eller en alternativ plats. Utlösande återställning är en POST-begäran och du kan utföra den här åtgärden med hjälp av rest-API:et för utlösarens återställning .

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

Värdena {containerName} och {protectedItemName} anges här och recoveryPointID är fältet {name} i återställningspunkten som nämns ovan.

POST https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare%3Bazurefiles/recoveryPoints/932886657837421071/restore?api-version=2019-05-13'

Skapa begärandetext

För att utlösa en återställning för en Azure-filresurs är följande komponenter i begärandetexten:

Namn	Type	Beskrivning
Egenskaper	AzureFileShareRestoreRequest	Egenskaper för RestoreRequestResource

En fullständig lista över definitioner av begärandetexten och annan information finns i rest-API-dokumentet för återställning av utlösare.

Återställ till den ursprungliga platsen

Exempel på begärandetext för återställning till den ursprungliga platsen

Följande begärandetext definierar egenskaper som krävs för att utlösa en återställning av En Azure-filresurs:

{
   "properties":{
      "objectType":"AzureFileShareRestoreRequest",
      "recoveryType":"OriginalLocation",
      "sourceResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afsaccount",
      "copyOptions":"Overwrite",
      "restoreRequestType":"FullShareRestore"
}
}

Återställa till en annan plats

Ange följande parametrar för alternativ platsåterställning:

targetResourceId: Lagringskontot som det säkerhetskopierade innehållet återställs till. Mållagringskontot måste finnas på samma plats som valvet.
name: Filresursen i mållagringskontot som det säkerhetskopierade innehållet återställs till.
targetFolderPath: Mappen under filresursen som data återställs till.

Exempel på begärandetext för återställning till alternativ plats

Följande begärandetext återställer azurefiles-filresursen i afsaccount-lagringskontot till azurefiles1-filresursen på lagringskontot afaccount1.

{
   "properties":{
      "objectType":"AzureFileShareRestoreRequest",
      "recoveryType":"AlternateLocation",
      "sourceResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afsaccount",
      "copyOptions":"Overwrite",
      "restoreRequestType":"FullShareRestore",
      "restoreFileSpecs":[
         {
            "targetFolderPath":"restoredata"
}
],
      "targetDetails":{
         "name":"azurefiles1",
         "targetResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afaccount1"
}
}
}

Response

Utlösaren av en återställningsåtgärd är en asynkron åtgärd. 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.

Svarsexempel

När du skickar POST-URI :n för att utlösa en återställning är det första svaret 202 (accepterad) med en platsrubrik eller Azure-async-header.

HTTP/1.1" 202
'Cache-Control': 'no-cache'
'Pragma': 'no-cache'
'Expires': '-1'
'Location': 'https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/operationResults/68ccfbc1-a64f-4b29-b955-314b5790cfa9?api-version=2019-05-13'
'Retry-After': '60'
'Azure-AsyncOperation': 'https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare;azurefiles/operationsStatus/68ccfbc1-a64f-4b29-b955-314b5790cfa9?api-version=2019-05-13'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': '2426777d-c5ec-44b6-a324-384f8947460c'
'x-ms-client-request-id': '3c743096-47eb-11ea-ae90-0a580af41908, 3c743096-47eb-11ea-ae90-0a580af41908'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-writes': '1198'
'x-ms-correlation-request-id': '2426777d-c5ec-44b6-a324-384f8947460c'
'x-ms-routing-request-id': 'WESTEUROPE:20200205T074347Z:2426777d-c5ec-44b6-a324-384f8947460c'
'Date': 'Wed, 05 Feb 2020 07:43:47 GMT'

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

GET https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupOperations/68ccfbc1-a64f-4b29-b955-314b5790cfa9?api-version=2016-12-01

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

HTTP/1.1" 200
'Cache-Control': 'no-cache'
'Pragma': 'no-cache'
'Transfer-Encoding': 'chunked'
'Content-Type': 'application/json'
'Content-Encoding': 'gzip'
'Expires': '-1'
'Vary': 'Accept-Encoding'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': '41ee89b2-3be4-40d8-8ff6-f5592c2571e3'
'x-ms-client-request-id': '3c743096-47eb-11ea-ae90-0a580af41908, 3c743096-47eb-11ea-ae90-0a580af41908'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'Server': 'Microsoft-IIS/10.0'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-reads': '11998'
'x-ms-correlation-request-id': '41ee89b2-3be4-40d8-8ff6-f5592c2571e3'
'x-ms-routing-request-id': 'WESTEUROPE:20200205T074348Z:41ee89b2-3be4-40d8-8ff6-f5592c2571e3'
'Date': 'Wed, 05 Feb 2020 07:43:47 GMT'
{
  "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/a7e97e42-4e54-4d4b-b449-26fcf946f42c",
  "location": null,
  "name": "a7e97e42-4e54-4d4b-b449-26fcf946f42c",
  "properties": {
    "actionsInfo": [
      "Cancellable"
    ],
    "activityId": "3c743096-47eb-11ea-ae90-0a580af41908",
    "backupManagementType": "AzureStorage",
    "duration": "0:00:01.863098",
    "endTime": null,
    "entityFriendlyName": "azurefiles",
    "errorDetails": null,
    "extendedInfo": {
      "dynamicErrorMessage": null,
      "propertyBag": {},
      "tasksList": []
    },
    "jobType": "AzureStorageJob",
    "operation": "Restore",
    "startTime": "2020-02-05T07:43:47.144961+00:00",
    "status": "InProgress",
    "storageAccountName": "afsaccount",
    "storageAccountVersion": "Storage"
  },
  "resourceGroup": "azurefiles",
  "tags": null,
  "type": "Microsoft.RecoveryServices/vaults/backupJobs"
}

För alternativ platsåterställning blir svarstexten så här:

{
  "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/7e0ee41e-6e31-4728-a25c-98ff6b777641",
  "location": null,
  "name": "7e0ee41e-6e31-4728-a25c-98ff6b777641",
  "properties": {
    "actionsInfo": [
      "Cancellable"
    ],
    "activityId": "6077be6e-483a-11ea-a915-0a580af4ad72",
    "backupManagementType": "AzureStorage",
    "duration": "0:00:02.171965",
    "endTime": null,
    "entityFriendlyName": "azurefiles",
    "errorDetails": null,
    "extendedInfo": {
      "dynamicErrorMessage": null,
      "propertyBag": {
        "Data Transferred (in MB)": "0",
        "Job Type": "Recover to an alternate file share",
        "Number Of Failed Files": "0",
        "Number Of Restored Files": "0",
        "Number Of Skipped Files": "0",
        "RestoreDestination": "afaccount1/azurefiles1/restoredata",
        "Source File Share Name": "azurefiles",
        "Source Storage Account Name": "afsaccount",
        "Target File Share Name": "azurefiles1",
        "Target Storage Account Name": "afaccount1"
      },
      "tasksList": []
    },
    "jobType": "AzureStorageJob",
    "operation": "Restore",
    "startTime": "2020-02-05T17:10:18.106532+00:00",
    "status": "InProgress",
    "storageAccountName": "afsaccount",
    "storageAccountVersion": "ClassicCompute"
  },
  "resourceGroup": "azurefiles",
  "tags": null,
  "type": "Microsoft.RecoveryServices/vaults/backupJobs"
}

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

Återställning på objektnivå med rest-API

Du kan använda det här återställningsalternativet för att återställa enskilda filer eller mappar på den ursprungliga eller en alternativ plats.

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

Värdena {containerName} och {protectedItemName} anges här och recoveryPointID är fältet {name} i återställningspunkten som nämns ovan.

POST https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;afsaccount/protectedItems/AzureFileShare%3Bazurefiles/recoveryPoints/932886657837421071/restore?api-version=2019-05-13'

Skapa begärandetext för återställning på objektnivå med hjälp av REST API

För att utlösa en återställning för en Azure-filresurs är följande komponenter i begärandetexten:

Namn	Type	Beskrivning
Egenskaper	AzureFileShareRestoreRequest	Egenskaper för RestoreRequestResource

En fullständig lista över definitioner av begärandetexten och annan information finns i rest-API-dokumentet för återställning av utlösare.

Återställa till den ursprungliga platsen för återställning på objektnivå med hjälp av REST API

Följande begärandetext är att återställa den Restoretest.txt filen i azurefiles-filresursen i afsaccount-lagringskontot.

Skapa begärandetext

{
   "properties":{
      "objectType":"AzureFileShareRestoreRequest",
      "copyOptions":"Overwrite",
      "recoveryType":"OriginalLocation",
      "restoreFileSpecs":[
         {
            "fileSpecType":"File",
            "path":"RestoreTest.txt",
            "targetFolderPath":null
}
],
      "restoreRequestType":"ItemLevelRestore",
      "sourceResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.storage/storageAccounts/afsaccount",
      "targetDetails":null
}
}

Återställa till en annan plats för återställning på objektnivå med hjälp av REST API

Följande begärandetext är att återställa den Restoretest.txt filen i azurefiles-filresursen i afsaccount-lagringskontot till mappen restoredata för azurefiles1-filresursen på lagringskontot afaccount1.

Skapa begärandetext

{
   "properties":{
      "objectType":"AzureFileShareRestoreRequest",
      "recoveryType":"AlternateLocation",
      "sourceResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afsaccount",
      "copyOptions":"Overwrite",
      "restoreRequestType":"ItemLevelRestore",
      "restoreFileSpecs":[
         {
            "path":"Restore/RestoreTest.txt",
            "fileSpecType":"File",
            "targetFolderPath":"restoredata"
}
],
      "targetDetails":{
         "name":"azurefiles1",
         "targetResourceId":"/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afaccount1"
}
}
}

Svaret bör hanteras på samma sätt som beskrivs ovan för fullständiga resursåterställningar.

Nästa steg

Lär dig hur du hanterar säkerhetskopiering av Azure-filresurser med hjälp av REST API.

Dela via

Återställa Azure-filresurser med hjälp av REST API

Förutsättningar

Hämta ContainerName och ProtectedItemName

Exempelsvar för att hämta återställningspunkter

Skapa begärandetext

Återställ till den ursprungliga platsen

Exempel på begärandetext för återställning till den ursprungliga platsen

Återställa till en annan plats

Exempel på begärandetext för återställning till alternativ plats

Response

Svarsexempel

Återställning på objektnivå med rest-API

Skapa begärandetext för återställning på objektnivå med hjälp av REST API

Återställa till den ursprungliga platsen för återställning på objektnivå med hjälp av REST API

Återställa till en annan plats för återställning på objektnivå med hjälp av REST API

Nästa steg

Feedback

Ytterligare resurser

Dela via

Återställa Azure-filresurser med hjälp av REST API

Förutsättningar

Hämta ContainerName och ProtectedItemName

Hämta återställningspunkter för säkerhetskopierad Azure-filresurs

Exempelsvar för att hämta återställningspunkter

Fullständig resursåterställning med HJÄLP av REST API

Skapa begärandetext

Återställ till den ursprungliga platsen

Exempel på begärandetext för återställning till den ursprungliga platsen

Återställa till en annan plats

Exempel på begärandetext för återställning till alternativ plats

Response

Svarsexempel

Återställning på objektnivå med rest-API

Skapa begärandetext för återställning på objektnivå med hjälp av REST API

Återställa till den ursprungliga platsen för återställning på objektnivå med hjälp av REST API

Återställa till en annan plats för återställning på objektnivå med hjälp av REST API

Nästa steg

Feedback

Ytterligare resurser