Sdílet prostřednictvím

Zálohování sdílené složky Azure pomocí služby Azure Backup prostřednictvím rozhraní REST API

  • Článek

Tento článek popisuje, jak zálohovat sdílenou složku Azure pomocí služby Azure Backup prostřednictvím rozhraní REST API.

Tento článek předpokládá, že jste už vytvořili trezor služby Recovery Services a zásady pro konfiguraci zálohování sdílené složky. Pokud jste to neudělali, projděte si kurzy k vytvoření trezoru a vytvoření rozhraní REST API zásad pro vytváření nových trezorů a zásad.

V tomto článku použijeme následující zdroje informací:

  • RecoveryServicesVault: azurefilesvault

  • Zásada: schedule1

  • Skupina prostředků: azurefiles

  • Účet úložiště: testvault2

  • Sdílená složka: testovací sdílená složka

Konfigurace zálohování pro nechráněnou sdílenou složku Azure pomocí rozhraní REST API

Zjišťování účtů úložiště s nechráněnými sdílenými složkami Azure

Trezor musí zjistit všechny účty úložiště Azure v předplatném se sdílenými složkami, které je možné zálohovat do trezoru služby Recovery Services. To se aktivuje pomocí operace aktualizace. Jedná se o asynchronní operaci POST , která zajišťuje, že trezor získá nejnovější seznam všech nechráněných sdílených složek Azure v aktuálním předplatném a uloží je do mezipaměti. Jakmile je sdílená složka uložená v mezipaměti, můžou služby Recovery Services přistupovat ke sdílené složce a chránit ji.

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

Identifikátor URI POST obsahuje {subscriptionId}, {vaultName}{vaultresourceGroupName}a {fabricName} parametry. V našem příkladu bude hodnota pro různé parametry následující:

  • {fabricName} is Azure

  • {vaultName} is azurefilesvault

  • {vaultresourceGroupName} is azurefiles

  • $filter=backupManagementType eq 'AzureStorage'

Vzhledem k tomu, že všechny požadované parametry jsou zadané v identifikátoru URI, není nutné použít samostatný text požadavku.

POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/refreshContainers?api-version=2016-12-01&$filter=backupManagementType eq 'AzureStorage'

Odpovědi na operaci aktualizace

Operace "refresh" je asynchronní operace. To znamená, že tato operace vytvoří jinou operaci, která se musí sledovat samostatně.

Vrátí dvě odpovědi: 202 (Přijato) při vytvoření jiné operace a 200 (OK) po dokončení této operace.

Ukázkové odpovědi na operaci aktualizace

Po odeslání požadavku POST se vrátí odpověď 202 (Accepted).

HTTP/1.1 202 Accepted
'Pragma': 'no-cache'
'Expires': '-1'
'Location': ‘https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/ResourceGroups
/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/operationResults/
cca47745-12d2-42f9-b3a4-75335f18fdf6?api-version=2016-12-01’
'Retry-After': '60'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': '6cc12ceb-90a2-430d-a1ec-9b6b6fdea92b'
'x-ms-client-request-id': ‘3da383a5-d66d-4b7c-982a-bc8d94798d61,3da383a5-d66d-4b7c-982a-bc8d94798d61’
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-reads': '11996'
'x-ms-correlation-request-id': '6cc12ceb-90a2-430d-a1ec-9b6b6fdea92b'
'x-ms-routing-request-id': CENTRALUSEUAP:20200203T091326Z:6cc12ceb-90a2-430d-a1ec-9b6b6fdea92b'
'Date': 'Mon, 03 Feb 2020 09:13:25 GMT'

Sledování výsledné operace pomocí hlavičky Location pomocí jednoduchého příkazu GET

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/operationResults/cca47745-12d2-42f9-b3a4-75335f18fdf6?api-version=2016-12-01

Jakmile se zjistí všechny účty Azure Storage, vrátí příkaz GET odpověď 204 (Bez obsahu). Trezor teď dokáže zjistit libovolný účet úložiště se sdílenými složkami, které je možné zálohovat v rámci předplatného.

HTTP/1.1 200 NoContent
Cache-Control  : no-cache
Pragma   : no-cache
X-Content-Type-Options  : nosniff
x-ms-request-id    : d9bdb266-8349-4dbd-9688-de52f07648b2
x-ms-client-request-id  : 3da383a5-d66d-4b7c-982a-bc8d94798d61,3da383a5-d66d-4b7c-982a-bc8d94798d61
Strict-Transport-Security  : max-age=31536000; includeSubDomains
X-Powered-By    : ASP.NET
x-ms-ratelimit-remaining-subscription-reads: 11933
x-ms-correlation-request-id   : d9bdb266-8349-4dbd-9688-de52f07648b2
x-ms-routing-request-id  : CENTRALUSEUAP:20200127T105304Z:d9bdb266-8349-4dbd-9688-de52f07648b2
Date   : Mon, 27 Jan 2020 10:53:04 GMT

Získání seznamu účtů úložiště se sdílenými složkami, které je možné zálohovat pomocí trezoru služby Recovery Services

Pokud chcete potvrdit, že se ukládání do mezipaměti provádí, uveďte všechny účty úložiště v předplatném se sdílenými složkami, které je možné zálohovat pomocí trezoru služby Recovery Services. Potom v odpovědi vyhledejte požadovaný účet úložiště. To se provádí pomocí operace GET ProtectableContainers .

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectableContainers?api-version=2016-12-01&$filter=backupManagementType eq 'AzureStorage'

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

Příklad textu odpovědi:

{

  "value": [

​    {

​      "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers
 /Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/

protectableContainers/StorageContainer;Storage;AzureFiles;testvault2",

​      "name": "StorageContainer;Storage;AzureFiles;testvault2",

​      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectableContainers",

​      "properties": {

​        "friendlyName": "testvault2",

​        "backupManagementType": "AzureStorage",

​        "protectableContainerType": "StorageContainer",

​        "healthStatus": "Healthy",

​        "containerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/
 AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2"

​      }

​    }

  ]

}

Vzhledem k tomu, že můžeme v textu odpovědi najít účet úložiště testvault2 s popisným názvem, byla operace aktualizace provedena výše úspěšná. Trezor služby Recovery Services teď může úspěšně zjišťovat účty úložiště s nechráněnými sdílenými složkami ve stejném předplatném.

Registrace účtu úložiště v trezoru služby Recovery Services

Tento krok je potřeba jenom v případě, že jste předtím neregistrovali účet úložiště v trezoru. Trezor můžete zaregistrovat pomocí operace ProtectionContainers-Register.

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}?api-version=2016-12-01

Nastavte proměnné pro identifikátor URI následujícím způsobem:

  • {resourceGroupName} – azurefiles
  • {fabricName} – Azure
  • {vaultName} – azurefilesvault
  • {containerName} – toto je atribut názvu v textu odpovědi operace GET ProtectableContainers. V našem příkladu je to StorageContainer; Skladování; AzureFiles; testvault2

Poznámka:

Vždy vezměte atribut názvu odpovědi a vyplňte ho v tomto požadavku. Nezakódujte ani nevytvávejte formát názvu kontejneru. Pokud ho vytvoříte nebo pevně zakódujete, volání rozhraní API selže, pokud se formát názvu kontejneru v budoucnu změní.


PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2?api-version=2016-12-01

Text žádosti o vytvoření je následující:

{

 "properties": {


  "containerType": "StorageContainer",


  "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",


  "resourceGroup": "AzureFiles",


  "friendlyName": "testvault2",


  "backupManagementType": "AzureStorage"

 }
}

Úplný seznam definic textu požadavku a dalších podrobností najdete v části ProtectionContainers-Register.

Jedná se o asynchronní operaci a vrátí dvě odpovědi: "202 Přijato" při přijetí operace a "200 OK" po dokončení operace. Pokud chcete sledovat stav operace, použijte hlavičku umístění k získání nejnovějšího stavu operace.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/operationresults/1a3c8ee7-e0e5-43ed-b8b3-73cc992b6db9?api-version=2016-12-01

Příklad textu odpovědi po dokončení operace:

{
    "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/
protectionContainers/StorageContainer;Storage;AzureFiles;testvault2",
    "name": "StorageContainer;Storage;AzureFiles;testvault2",
    "properties": {
        "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",
        "protectedItemCount": 0,
        "friendlyName": "testvault2",
        "backupManagementType": "AzureStorage",
        "registrationStatus": "Registered",
        "healthStatus": "Healthy",
        "containerType": "StorageContainer",
        "protectableObjectType": "StorageContainer"
    }
}

Můžete ověřit, jestli registrace proběhla úspěšně z hodnoty parametru registrationstatus v textu odpovědi. V našem případě se zobrazí stav zaregistrovaný pro testvault2, takže operace registrace byla úspěšná.

Inquire all unprotected files shares under a storage account

Pomocí operace Diagnostika kontejnerů ochrany můžete inquire v účtu úložiště inquire ( Ochrana kontejnerů). Jedná se o asynchronní operaci a výsledky by se měly sledovat pomocí hlavičky umístění.

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

Nastavte proměnné pro výše uvedený identifikátor URI následujícím způsobem:

  • {vaultName} – azurefilesvault
  • {fabricName} – Azure
  • {containerName}- Odkaz na atribut name v textu odpovědi operace GET ProtectableContainers. V našem příkladu je to StorageContainer; Skladování; AzureFiles; testvault2
https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/inquire?api-version=2016-12-01

Jakmile bude požadavek úspěšný, vrátí stavový kód OK.

Cache-Control : no-cache
Pragma   : no-cache
X-Content-Type-Options: nosniff
x-ms-request-id  : 68727f1e-b8cf-4bf1-bf92-8e03a9d96c46
x-ms-client-request-id  : 3da383a5-d66d-4b7c-982a-bc8d94798d61,3da383a5-d66d-4b7c-982a-bc8d94798d61
Strict-Transport-Security: max-age=31536000; includeSubDomains
Server  : Microsoft-IIS/10.0
X-Powered-B : ASP.NET
x-ms-ratelimit-remaining-subscription-reads: 11932
x-ms-correlation-request-id  : 68727f1e-b8cf-4bf1-bf92-8e03a9d96c46
x-ms-routing-request-id   : CENTRALUSEUAP:20200127T105305Z:68727f1e-b8cf-4bf1-bf92-8e03a9d96c46
Date  : Mon, 27 Jan 2020 10:53:05 GMT

Vyberte sdílenou složku, kterou chcete zálohovat.

Pomocí operace GET backupprotectableItems můžete zobrazit seznam všech chráněných položek v rámci předplatného a vyhledat požadovanou sdílenou složku, kterou chcete zálohovat.

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

Vytvořte identifikátor URI následujícím způsobem:

  • {vaultName} – azurefilesvault
  • {$filter} – backupManagementType eq AzureStorage
GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupProtectableItems?$filter=backupManagementType eq 'AzureStorage'&api-version=2016-12-01

Ukázková odpověď:

Status Code:200

{
    "value": [
        {
            "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/storagecontainer;storage;azurefiles;afaccount1/protectableItems/azurefileshare;azurefiles1",
            "name": "azurefileshare;azurefiles1",
            "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
            "properties": {
                "parentContainerFabricId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afaccount1",
                "parentContainerFriendlyName": "afaccount1",
                "azureFileShareType": "XSMB",
                "backupManagementType": "AzureStorage",
                "workloadType": "AzureFileShare",
                "protectableItemType": "AzureFileShare",
                "friendlyName": "azurefiles1",
                "protectionState": "NotProtected"
            }
        },
        {
            "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/storagecontainer;storage;azurefiles;afsaccount/protectableItems/azurefileshare;afsresource",
            "name": "azurefileshare;afsresource",
            "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
            "properties": {
                "parentContainerFabricId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/afsaccount",
                "parentContainerFriendlyName": "afsaccount",
                "azureFileShareType": "XSMB",
                "backupManagementType": "AzureStorage",
                "workloadType": "AzureFileShare",
                "protectableItemType": "AzureFileShare",
                "friendlyName": "afsresource",
                "protectionState": "NotProtected"
            }
        },
        {
            "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/storagecontainer;storage;azurefiles;testvault2/protectableItems/azurefileshare;testshare",
            "name": "azurefileshare;testshare",
            "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
            "properties": {
                "parentContainerFabricId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",
                "parentContainerFriendlyName": "testvault2",
                "azureFileShareType": "XSMB",
                "backupManagementType": "AzureStorage",
                "workloadType": "AzureFileShare",
                "protectableItemType": "AzureFileShare",
                "friendlyName": "testshare",
                "protectionState": "NotProtected"
            }
        }
    ]
}

Odpověď obsahuje seznam všech nechráněných sdílených složek a obsahuje všechny informace vyžadované službou Azure Recovery Service ke konfiguraci zálohování.

Povolení zálohování sdílené složky

Jakmile se příslušná sdílená složka označí popisným názvem, vyberte zásadu, která se má chránit. Další informace o existujících zásadách v trezoru najdete v seznamu rozhraní POLICY API. Pak vyberte příslušnou zásadu odkazem na název zásady. Pokud chcete vytvořit zásady, projděte si kurz vytvoření zásad.

Povolení ochrany je asynchronní operace PUT , která vytvoří "chráněnou položku".

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

Nastavte proměnné containername a protecteditemname pomocí atributu 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/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/storagecontainer;storage;azurefiles;testvault2/protectableItems/azurefileshare;testshare
  • {containername} – storagecontainer; skladování; azurefiles; testvault2
  • {protectedItemName} – azurefileshare; testshare

Nebo můžete odkazovat na atribut názvu kontejneru ochrany a odpovědi na chráněné položky.

Poznámka:

Vždy vezměte atribut názvu odpovědi a vyplňte ho v tomto požadavku. Nezakódujte ani nevytvávejte formát názvu kontejneru ani formát názvu chráněné položky. Pokud vytvoříte nebo pevně zakódujete, volání rozhraní API selže, pokud se formát názvu kontejneru nebo formát názvu chráněné položky v budoucnu změní.


PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/protectedItems/azurefileshare;testshare?api-version=2016-12-01

Vytvoření textu požadavku:

Následující text požadavku definuje vlastnosti potřebné k vytvoření chráněné položky.

{
  "properties": {
    "protectedItemType": "AzureFileShareProtectedItem",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",
    "policyId": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupPolicies/schedule1"
  }
}

SourceResourceId je parentcontainerFabricID v reakci na GET backupprotectableItems.

Ukázková odezva

Vytvoření chráněné položky je asynchronní operace, která vytvoří další operaci, kterou je potřeba sledovat. Vrátí dvě odpovědi: 202 (Přijato) při vytvoření jiné operace a 200 (OK) po dokončení této operace.

Po odeslání požadavku PUT pro vytvoření nebo aktualizaci chráněné položky je počáteční odpověď 202 (Přijato) s hlavičkou umístění.

HTTP/1.1 202 Accepted
Cache-Control  : no-cache
Pragma  : no-cache
Location : https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/protectedItems/azurefileshare;testshare/operationResults/c3a52d1d-0853-4211-8141-477c65740264?api-version=2016-12-01
Retry-Afte  : 60
Azure-AsyncOperation  : https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/protectedItems/azurefileshare;testshare/operationResults/c3a52d1d-0853-4211-8141-477c65740264?api-version=2016-12-01
X-Content-Type-Options : nosniff
x-ms-request-id : b55527fa-f473-4f09-b169-9cc3a7a39065
x-ms-client-request-id: 3da383a5-d66d-4b7c-982a-bc8d94798d61,3da383a5-d66d-4b7c-982a-bc8d94798d61
Strict-Transport-Security : max-age=31536000; includeSubDomains
X-Powered-By  : ASP.NET
x-ms-ratelimit-remaining-subscription-writes: 1198
x-ms-correlation-request-id : b55527fa-f473-4f09-b169-9cc3a7a39065
x-ms-routing-request-id  : CENTRALUSEUAP:20200127T105412Z:b55527fa-f473-4f09-b169-9cc3a7a39065
Date : Mon, 27 Jan 2020 10:54:12 GMT

Pak pomocí hlavičky umístění nebo hlavičky Azure-AsyncOperation sledujte výslednou operaci pomocí příkazu GET .

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupOperations/c3a52d1d-0853-4211-8141-477c65740264?api-version=2016-12-01

Po dokončení operace vrátí hodnotu 200 (OK) s obsahem chráněné položky v textu odpovědi.

Ukázkový text odpovědi:

{
    "id": "c3a52d1d-0853-4211-8141-477c65740264",
    "name": "c3a52d1d-0853-4211-8141-477c65740264",
    "status": "Succeeded",
    "startTime": "2020-02-03T18:10:48.296012Z",
    "endTime": "2020-02-03T18:10:48.296012Z",
    "properties": {
        "objectType": "OperationStatusJobExtendedInfo",
        "jobId": "e2ca2cf4-2eb9-4d4b-b16a-8e592d2a658b"
    }
}

Tím potvrdíte, že je pro sdílenou složku povolená ochrana a první zálohování se aktivuje podle plánu zásad.

Aktivace zálohování sdílené složky na vyžádání

Jakmile je sdílená složka Azure nakonfigurovaná pro zálohování, zálohování se spustí podle plánu zásad. Můžete počkat na první naplánované zálohování nebo kdykoli aktivovat zálohování na vyžádání.

Aktivace zálohování na vyžádání je operace 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

{containerName} a {protectedItemName} jsou vytvořené výše při povolování zálohování. V našem příkladu se to překládá na:

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;testvault2/protectedItems/AzureFileShare;testshare/backup?api-version=2017-07-01

Vytvoření textu požadavku

Pokud chcete aktivovat zálohování na vyžádání, následují komponenty textu požadavku.

Name Typ Popis
Vlastnosti AzurefilesharebackupReques Vlastnosti BackupRequestResource

Úplný seznam definic textu požadavku a dalších podrobností najdete v tématu o aktivaci zálohování chráněných položek v dokumentu rozhraní REST API chráněných položek.

Příklad textu požadavku

{

  "properties":{

   "objectType":"AzureFileShareBackupRequest",
    "recoveryPointExpiryTimeInUTC":"2020-03-07T18:29:59.000Z"
}

}

Odpovědi na operaci zálohování na vyžádání

Aktivace zálohování na vyžádání je asynchronní operace. To znamená, že tato operace vytvoří jinou operaci, která se musí sledovat samostatně.

Vrátí dvě odpovědi: 202 (Přijato) při vytvoření jiné operace a 200 (OK) po dokončení této operace.

Ukázkové odpovědi na operaci zálohování na vyžádání

Jakmile odešlete požadavek POST na zálohování na vyžádání, počáteční odpověď je 202 (Přijato) s hlavičkou umístění nebo hlavičkou Azure-async-header.

'Cache-Control': 'no-cache'
'Pragma': 'no-cache'
'Expires': '-1'
'Location': https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;testvault2/protectedItems/AzureFileShare;testshare/operationResults/dc62d524-427a-4093-968d-e951c0a0726e?api-version=2017-07-01
'Retry-After': '60'
'Azure-AsyncOperation': https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;storage;azurefiles;testvault2/protectedItems/AzureFileShare;testshare/operationsStatus/dc62d524-427a-4093-968d-e951c0a0726e?api-version=2017-07-01
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': '2e03b8d4-66b1-48cf-8094-aa8bff57e8fb'
'x-ms-client-request-id': 'a644712a-4895-11ea-ba57-0a580af42708, a644712a-4895-11ea-ba57-0a580af42708'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-writes': '1199'
'x-ms-correlation-request-id': '2e03b8d4-66b1-48cf-8094-aa8bff57e8fb'
'x-ms-routing-request-id': 'WESTEUROPE:20200206T040339Z:2e03b8d4-66b1-48cf-8094-aa8bff57e8fb'
'Date': 'Thu, 06 Feb 2020 04:03:38 GMT'
'Content-Length': '0'

Pak pomocí hlavičky umístění nebo hlavičky Azure-AsyncOperation sledujte výslednou operaci pomocí příkazu GET .

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupOperations/dc62d524-427a-4093-968d-e951c0a0726e?api-version=2016-12-01

Po dokončení operace vrátí hodnotu 200 (OK) s ID výsledné úlohy zálohování v těle odpovědi.

Ukázkový text odpovědi

{
    "id": "dc62d524-427a-4093-968d-e951c0a0726e",
    "name": "dc62d524-427a-4093-968d-e951c0a0726e",
    "status": "Succeeded",
    "startTime": "2020-02-06T11:06:02.1327954Z",
    "endTime": "2020-02-06T11:06:02.1327954Z",
    "properties": {
        "objectType": "OperationStatusJobExtendedInfo",
        "jobId": "39282261-cb52-43f5-9dd0-ffaf66beeaef"
    }
}

Vzhledem k tomu, že úloha zálohování je dlouhotrvající operace, je potřeba ji sledovat, jak je vysvětleno v úlohách monitorování pomocí dokumentu rozhraní REST API.

Další kroky