Obnovení sdílených složek Azure pomocí rozhraní REST API

Článek
06/01/2023

Tento článek vysvětluje, jak obnovit celou sdílenou složku nebo konkrétní soubory z bodu obnovení vytvořeného Azure Backup pomocí rozhraní REST API.

Na konci tohoto článku se dozvíte, jak pomocí rozhraní REST API provádět následující operace:

Zobrazení bodů obnovení pro zálohovanou sdílenou složku Azure
Obnovení úplné sdílené složky Azure
Obnovte jednotlivé soubory nebo složky.

Požadavky

Předpokládáme, že už máte zálohovanou sdílenou složku, kterou chcete obnovit. Pokud to neuděláte, přečtěte si téma Zálohování sdílených složek Azure pomocí rozhraní REST API , kde se dozvíte, jak sdílenou složku vytvořit.

Pro účely tohoto článku použijeme následující zdroje informací:

RecoveryServicesVault: azurefilesvault
Skupina prostředků: azurefiles
Účet úložiště: afsaccount
Sdílená složka: azurefiles

Fetch ContainerName a ProtectedItemName

U většiny volání rozhraní API souvisejících s obnovením musíte předat hodnoty parametrů identifikátoru URI {containerName} a {protectedItemName}. K načtení hodnot těchto parametrů použijte atribut ID v textu odpovědi operace GET backupprotectableitems . V našem příkladu je ID sdílené složky, kterou chceme chránit, následující:

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

Hodnoty se tedy přeloží takto:

{containername} – storagecontainer, storage, azurefiles, afsaccount
{protectedItemName} – azurefileshare; azurefiles

Pokud chcete obnovit zálohovanou sdílenou složku nebo soubory, nejprve vyberte bod obnovení, který provede operaci obnovení. Dostupné body obnovení zálohované položky je možné vypsat pomocí volání rozhraní REST API seznam bodů obnovení . Jedná se o operaci GET se všemi relevantními hodnotami.

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}

Nastavte hodnoty identifikátoru URI následujícím způsobem:

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

Identifikátor URI GET má všechny požadované parametry. Není potřeba další text požadavku.

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

Příklad odpovědi pro načtení bodů obnovení

Po odeslání get URI se vrátí odpověď 200:

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

Bod obnovení je ve výše uvedené odpovědi označen polem {name}.

Pomocí této možnosti obnovení můžete obnovit celou sdílenou složku v původním nebo alternativním umístění. Aktivace obnovení je požadavek POST a tuto operaci můžete provést pomocí rozhraní REST API pro obnovení triggeru .

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

Hodnoty {containerName} a {protectedItemName} jsou nastavené tady a recoveryPointID je pole {name} výše uvedeného bodu obnovení.

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'

Vytvoření textu požadavku

K aktivaci obnovení sdílené složky Azure patří následující součásti textu požadavku:

Název	Typ	Popis
Vlastnosti	AzureFileShareRestoreRequest	Vlastnosti RestoreRequestResource

Úplný seznam definic textu požadavku a další podrobnosti najdete v dokumentu k rozhraní REST API pro obnovení triggeru.

Obnovit do původního umístění

Příklad textu požadavku pro obnovení do původního umístění

Následující text požadavku definuje vlastnosti potřebné k aktivaci obnovení sdílené složky Azure:

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

Obnovení do alternativního umístění

Zadejte následující parametry pro obnovení do alternativního umístění:

targetResourceId: Účet úložiště, do kterého se obnovený zálohovaný obsah. Cílový účet úložiště musí být ve stejném umístění jako trezor.
name: Sdílená složka v rámci cílového účtu úložiště, do které se obnovený zálohovaný obsah.
targetFolderPath: Složka ve sdílené složce, do které se data obnovují.

Příklad textu požadavku pro obnovení do alternativního umístění

Následující text požadavku obnoví sdílenou složku azurefiles v účtu úložiště afsaccount do sdílené složky azurefiles1 v účtu úložiště 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"
}
}
}

Odpověď

Aktivace operace obnovení je asynchronní operace. Tato operace vytvoří další operaci, kterou je potřeba sledovat samostatně. Vrátí dvě odpovědi: 202 (přijato) při vytvoření další operace a 200 (OK) po dokončení této operace.

Příklad odpovědi

Jakmile odešlete identifikátor URI POST pro aktivaci obnovení, počáteční odpověď bude 202 (Přijato) s hlavičkou umístění nebo hlavičkou 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'

Potom sledujte výslednou operaci pomocí hlavičky location nebo hlavičky Azure-AsyncOperation pomocí příkazu GET.

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

Po dokončení operace se vrátí hodnota 200 (OK) s ID výsledné úlohy obnovení v textu odpovědi.

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

Pro obnovení do alternativního umístění bude text odpovědi vypadat takto:

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

Vzhledem k tomu, že úloha zálohování je dlouhotrvající operace, měla by se sledovat, jak je vysvětleno v dokumentu monitorování úloh pomocí rozhraní REST API.

Obnovení na úrovni položek pomocí rozhraní REST API

Tuto možnost obnovení můžete použít k obnovení jednotlivých souborů nebo složek v původním nebo alternativním umístění.

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

Hodnoty {containerName} a {protectedItemName} jsou nastavené tady a recoveryPointID je pole {name} výše uvedeného bodu obnovení.

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'

Vytvoření textu požadavku na obnovení na úrovni položek pomocí rozhraní REST API

K aktivaci obnovení sdílené složky Azure patří následující součásti textu požadavku:

Název	Typ	Popis
Vlastnosti	AzureFileShareRestoreRequest	Vlastnosti RestoreRequestResource

Úplný seznam definic textu požadavku a další podrobnosti najdete v dokumentu k rozhraní REST API pro obnovení triggeru.

Obnovení do původního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Následujícím textem požadavku je obnovení souboruRestoretest.txt ve sdílené složce azurefiles v účtu úložiště afsaccount .

Vytvořit text požadavku

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

Obnovení do alternativního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Následující text požadavku slouží k obnovení Restoretest.txt souboru ve sdílené složce azurefiles v účtu úložiště afsaccount do složky restoredata sdílené složky azurefiles1 v účtu úložiště afaccount1 .

Vytvoření textu požadavku

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

Odpověď by měla být zpracována stejným způsobem, jak je vysvětleno výše pro obnovení úplné sdílené složky.

Další kroky

Zjistěte, jak spravovat zálohování sdílených složek Azure pomocí rozhraní REST API.

Sdílet prostřednictvím

Obnovení sdílených složek Azure pomocí rozhraní REST API

Požadavky

Fetch ContainerName a ProtectedItemName

Příklad odpovědi pro načtení bodů obnovení

Vytvoření textu požadavku

Obnovit do původního umístění

Příklad textu požadavku pro obnovení do původního umístění

Obnovení do alternativního umístění

Příklad textu požadavku pro obnovení do alternativního umístění

Odpověď

Příklad odpovědi

Obnovení na úrovni položek pomocí rozhraní REST API

Vytvoření textu požadavku na obnovení na úrovni položek pomocí rozhraní REST API

Obnovení do původního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Obnovení do alternativního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Další kroky

Váš názor

Váš názor

Další materiály

Sdílet prostřednictvím

Obnovení sdílených složek Azure pomocí rozhraní REST API

Požadavky

Fetch ContainerName a ProtectedItemName

Načtení bodů obnovení pro zálohovanou sdílenou složku Azure

Příklad odpovědi pro načtení bodů obnovení

Obnovení úplné sdílené složky pomocí rozhraní REST API

Vytvoření textu požadavku

Obnovit do původního umístění

Příklad textu požadavku pro obnovení do původního umístění

Obnovení do alternativního umístění

Příklad textu požadavku pro obnovení do alternativního umístění

Odpověď

Příklad odpovědi

Obnovení na úrovni položek pomocí rozhraní REST API

Vytvoření textu požadavku na obnovení na úrovni položek pomocí rozhraní REST API

Obnovení do původního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Obnovení do alternativního umístění pro obnovení na úrovni položek pomocí rozhraní REST API

Další kroky

Váš názor

Váš názor

Další materiály