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

Azure Files biztonsági mentésének kezelése REST API-val

Ez a cikk bemutatja, hogyan hajthat végre feladatokat a REST API-val biztonsági másolatot készítő Azure Files felügyeletére és figyelésére. Az Azure Files biztonsági mentéseit az Azure Portal, az Azure PowerShell és az Azure CLI használatával is kezelheti.

Munkafolyamatok figyelése

Az Azure Backup szolgáltatás a háttérben futó feladatokat aktiválja. Ez olyan forgatókönyveket is magában foglal, mint a biztonsági mentés aktiválása, a visszaállítási műveletek és a biztonsági mentés letiltása. Ezek a feladatok a saját azonosítójukkal követhetők nyomon.

Műveletekből feladatadatok lekérése

Egy művelet, például a biztonsági mentés aktiválása mindig egy feladatazonosítót ad vissza a válaszban.

Egy trigger biztonsági mentési REST API-műveletének végső válasza például a következő:

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

Az Azure Files biztonsági mentési feladatát a jobId mező azonosítja, és get kéréssel nyomon követhető az itt említett módon.

A feladat nyomon követése

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupJobs/{jobName}?api-version=2019-05-13

Az {jobName} az előzőekben említett "jobId". A válasz mindig "200 OK", a munka állapotát jelző állapotmező segítségével. A "Kész" vagy a "CompletedWithWarnings" után a kiterjesztettInfo szakasz további részleteket jelenít meg a feladatról.

GET https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/e2ca2cf4-2eb9-4d4b-b16a-8e592d2a658b?api-version=2019-05-13'

Válasz

Név típus Leírás
200 OK JobResource OKÉ

Példa válaszra

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

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'
'Server': 'Microsoft-IIS/10.0, Microsoft-IIS/10.0'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': 'dba43f00-5cdb-43b1-a9ec-23e419db67c5'
'x-ms-client-request-id': 'a644712a-4895-11ea-ba57-0a580af42708, a644712a-4895-11ea-ba57-0a580af42708'
'X-Powered-By': 'ASP.NET'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'x-ms-ratelimit-remaining-subscription-reads': '11999'
'x-ms-correlation-request-id': 'dba43f00-5cdb-43b1-a9ec-23e419db67c5'
'x-ms-routing-request-id': 'WESTEUROPE:20200206T040341Z:dba43f00-5cdb-43b1-a9ec-23e419db67c5'
'Date': 'Thu, 06 Feb 2020 04:03:40 GMT'
{
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/e2ca2cf4-2eb9-4d4b-b16a-8e592d2a658b",
    "name": "e2ca2cf4-2eb9-4d4b-b16a-8e592d2a658b",
    "type": "Microsoft.RecoveryServices/vaults/backupJobs",
    "properties": {
        "jobType": "AzureStorageJob",
        "duration": "00:00:43.1809140",
        "storageAccountName": "testvault2",
        "storageAccountVersion": "Storage",
        "extendedInfo": {
            "tasksList": [],
            "propertyBag": {
                "File Share Name": "testshare",
                "Storage Account Name": "testvault2",
                "Policy Name": "schedule1"
            }
        },
        "entityFriendlyName": "testshare",
        "backupManagementType": "AzureStorage",
        "operation": "ConfigureBackup",
        "status": "Completed",
        "startTime": "2020-02-03T18:10:48.296012Z",
        "endTime": "2020-02-03T18:11:31.476926Z",
        "activityId": "3677cec0-942d-4eac-921f-8f3c873140d7"
    }
}

Szabályzat módosítása

Ha módosítani szeretné azt a házirendet, amellyel a fájlmegosztás védett, ugyanazt a formátumot használhatja, mint a védelem engedélyezése. Csak adja meg az új szabályzatazonosítót a kérelemszabályzatban, és küldje el a kérést.

Például: Ha módosítani szeretné a tesztmegosztás védelmi szabályzatát az ütemezés1-ről az ütemezés2-re, adja meg a schedule2 azonosítót a kérelem törzsében.

{
  "properties": {
    "protectedItemType": "AzureFileShareProtectedItem",
    "sourceResourceId": "/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",
    "policyId": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupPolicies/schedule2"
  }
}

A védelem leállítása, de a meglévő adatok megőrzése

A védett fájlmegosztások védelmét eltávolíthatja, de megtarthatja a már biztonsági másolatot készítő adatokat. Ehhez távolítsa el a házirendet a kérés törzsében, amelyet a biztonsági mentés engedélyezéséhez és a kérés elküldéséhez használt. A szabályzattal való társítás eltávolítása után a biztonsági másolatok nem aktiválódnak, és nem jönnek létre új helyreállítási pontok.

{
  "properties": {
    "protectedItemType": "AzureFileShareProtectedItem",
    "sourceResourceId": "/subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/AzureFiles/providers/Microsoft.Storage/storageAccounts/testvault2",
    "policyId": "" ,
"protectionState":"ProtectionStopped"
  }
}

Mintaválasz

A fájlmegosztások védelmének leállítása aszinkron művelet. A művelet létrehoz egy másik műveletet, amelyet nyomon kell követni. Két választ ad vissza: 202 (Elfogadva) egy másik művelet létrehozásakor, és 200, amikor a művelet befejeződik.

Válaszfejléc a művelet sikeres elfogadásakor:

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;testvault2/protectedItems/AzureFileShare;testshare/operationResults/b300922a-ad9c-4181-b4cd-d42ea780ad77?api-version=2019-05-13'
'Retry-After': '60'
msrest.http_logger :     '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;testvault2/protectedItems/AzureFileShare;testshare/operationsStatus/b300922a-ad9c-4181-b4cd-d42ea780ad77?api-version=2019-05-13'
'X-Content-Type-Options': 'nosniff'
'x-ms-request-id': '3895e8a1-e4b9-4da5-bec7-2cf0266405f8'
'x-ms-client-request-id': 'd331c15e-48ab-11ea-84c0-0a580af46a50, d331c15e-48ab-11ea-84c0-0a580af46a50'
'Strict-Transport-Security': 'max-age=31536000; includeSubDomains'
'X-Powered-By': 'ASP.NET'
'x-ms-ratelimit-remaining-subscription-writes': '1199'
'x-ms-correlation-request-id': '3895e8a1-e4b9-4da5-bec7-2cf0266405f8'
'x-ms-routing-request-id': 'WESTEUROPE:20200206T064224Z:3895e8a1-e4b9-4da5-bec7-2cf0266405f8'
'Date': 'Thu, 06 Feb 2020 06:42:24 GMT'
'Content-Length': '0'

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

GET https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupoperations/b300922a-ad9c-4181-b4cd-d42ea780ad77?api-version=2016-12-01

Válaszüzenet tartalma

{
    "id": "b300922a-ad9c-4181-b4cd-d42ea780ad77",
    "name": "b300922a-ad9c-4181-b4cd-d42ea780ad77",
    "status": "Succeeded",
    "startTime": "2020-02-06T06:42:24.4001299Z",
    "endTime": "2020-02-06T06:42:24.4001299Z",
    "properties": {
        "objectType": "OperationStatusJobExtendedInfo",
        "jobId": "7816fca8-d5be-4c41-b911-1bbd922e5826"
    }
}

Védelem leállítása és adatok törlése

A védett fájlmegosztások védelmének eltávolításához és a biztonsági mentési adatok törléséhez hajtsa végre az itt részletezett törlési műveletet.

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

A(z) {containerName} és a {protectedItemName} paraméterek itt vannak beállítva.

Az alábbi példa elindít egy műveletet, amely leállítja az azurefilesvaulttal védett testshare fájlmegosztás védelmét.

DELETE https://management.azure.com/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupFabrics/Azure/protectionContainers/StorageContainer;Storage;AzureFiles;testvault2/protectedItems/azurefileshare;testshare?api-version=2016-12-01

Válaszok

A törlés elleni védelem aszinkron művelet. A művelet létrehoz egy másik műveletet, amelyet külön kell nyomon követni. Két választ ad vissza: 202 (Elfogadva) egy másik művelet létrehozásakor és 204 (NoContent) a művelet befejezésekor.

Következő lépések