Zálohování služby Azure Files pomocí služby Azure Backup prostřednictvím rozhraní REST API

Tento článek popisuje, jak zálohovat soubory 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, podívejte se na návody k vytvoření trezoru a vytvoření zásad v rozhraní REST API pro vytváření nových trezorů a zásad.

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

RecoveryServicesVault: azurefilesvault
Politika:schedule1
Skupina prostředků: azurefiles
Účet úložiště: testvault2
Sdílení souborů: testshare

Konfigurace zálohování pro nechráněné soubory Azure pomocí rozhraní REST API

Objevte účty úložiště s nechráněnými Azure Files

Trezor musí zjistit všechny účty úložiště Azure v předplatném, které mají sdílené složky a které je možné zálohovat do trezoru služby Obnovení. To se aktivuje pomocí operace obnovy. 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 soubory, které lze 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ískat seznam účtů úložiště se sdílenými soubory, které lze zálohovat pomocí trezoru služby Recovery Services.

Pokud chcete ověřit, že je ukládání do mezipaměti hotové, vylistujte všechny účty úložiště v předplatném s sdílenými složkami souborů, které lze 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"

      }

    }

  ]

}

Jelikož můžeme v textu odpovědi najít účet úložiště testvault2 s přívětivým názvem, byla zmiňovaná operace obnovy úspěšná. Úložiště Recovery Services nyní může úspěšně detekovat účty úložiště s nechráněnými sdílenými soubory 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 dříve 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;Storage;AzureFiles;testvault2

Poznámka:

Vždy použijte atribut jména z odpovědi a vyplňte jej 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 těla žádosti a dalších podrobností naleznete 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 registrace proběhla úspěšně.

Dotazujte se na všechny nechráněné sdílené soubory v rámci úložiště.

Můžete se dotázat na chráněné položky v účtu úložiště pomocí operace Ochranné kontejnery - Dotaz. 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 jde o StorageContainer; Storage; 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

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í.

Jakmile se příslušná sdílená složka označí popisným názvem, vyberte zásadu, kterou chcete chránit. Další informace o existujících zásadách v trezoru najdete v 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;storage;azurefiles;testvault2
{protectedItemName} – azurefileshare; testshare

Nebo můžete odkazovat na atribut name ochranného kontejneru a reakce na položky, které lze chránit.

Poznámka:

Vždy použijte atribut jména z odpovědi a vyplňte jej 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 položku, 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ý obsah 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 se potvrzuje, že je ochrana pro sdílenou složku povolena, a první zálohování bude spuštěno podle harmonogramu.

Jakmile je služba Azure Files 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, jak je uvedeno výše, vytvořené 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.

Název	Typ	Popis
Vlastnosti	AzurefilesharebackupRequest	Vlastnosti BackupRequestResource

Pro úplný seznam definic těla požadavku a dalších podrobností se podívejte na dokument o spuštění zálohování chráněných položek v rozhraní REST API.

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 Location 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

Obnovení služby Azure Files pomocí rozhraní REST API
Obnovení služby Azure Files pomocí webu Azure Portal, Azure PowerShellu a Azure CLI
Spravujte zálohy Azure Files pomocí Portálu Azure, Azure PowerShell, Azure CLI, REST API.

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-05-22