Bagikan melalui

Mengelola cadangan Azure Files dengan REST API

Artikel ini menjelaskan cara melakukan tugas untuk mengelola dan memantau Azure Files yang dicadangkan menggunakan REST API. Anda juga dapat mengelola cadangan Azure Files menggunakan portal Microsoft Azure, Azure PowerShell, Azure CLI.

Pantau pekerjaan

Layanan Azure Backup memicu pekerjaan yang berjalan di latar belakang. Ini termasuk skenario seperti memicu pencadangan, operasi pemulihan, dan menonaktifkan pencadangan. Pekerjaan ini dapat dilacak menggunakan ID mereka.

Dapatkan detail pekerjaan dari proses operasi

Operasi seperti memicu pencadangan akan selalu mengembalikan jobID dalam respons.

Misalnya, respons akhir dari operasi pemicu REST API cadangan adalah sebagai berikut:

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

Pekerjaan pencadangan Azure Files diidentifikasi oleh bidang jobId dan dapat dilacak seperti yang disebutkan di sini menggunakan permintaan GET.

Melacak pekerjaan

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

{jobName} adalah "jobId" yang disebutkan di atas. Responsnya selalu "200 OK" dengan bidang status yang menunjukkan status pekerjaan. Setelah "Selesai" atau "CompletedWithWarnings", bagian extendedInfo mengungkapkan detail selengkapnya tentang pekerjaan tersebut.

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'

Jawaban

Nama Tipe Deskripsi
200 OK (Permintaan berhasil) JobResources OKE

Contoh tanggapan

Setelah URI GET dikirimkan, 200 respons dikembalikan.

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

Ubah kebijakan

Untuk mengubah kebijakan tempat Berbagi File dilindungi, Anda dapat menggunakan format yang sama dengan mengaktifkan perlindungan. Cukup berikan ID kebijakan baru dalam kebijakan permintaan dan kirimkan permintaan.

Misalnya: Untuk mengubah kebijakan perlindungan testshare dari schedule1 ke schedule2, berikan ID schedule2 di isi permintaan.

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

Hentikan perlindungan tetapi tetap pertahankan data yang ada

Anda dapat menghapus perlindungan pada Berbagi File yang dilindungi tetapi menyimpan data yang sudah dicadangkan. Untuk melakukannya, hapus kebijakan dalam isi permintaan yang Anda gunakan untuk mengaktifkan pencadangan dan mengirimkan permintaan. Setelah asosiasi dengan kebijakan dihapus, cadangan tidak lagi dipicu, dan tidak ada titik pemulihan baru yang dibuat.

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

Contoh tanggapan

Menghentikan perlindungan untuk Berbagi File adalah operasi asinkron. Operasi ini akan menciptakan operasi lain yang perlu dilacak. Ini mengembalikan dua respons: 202 (Diterima) saat operasi lain dibuat, dan 200 ketika operasi tersebut selesai.

Kop respons ketika operasi berhasil diterima:

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'

Kemudian lacak operasi yang dihasilkan menggunakan header lokasi atau header Azure-AsyncOperation dengan perintah GET:

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

Badan respons

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

Hentikan perlindungan dan hapus data

Untuk menghapus perlindungan pada Berbagi File yang dilindungi dan menghapus data cadangan juga, lakukan operasi penghapusan seperti yang dirinci di sini.

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

Parameter {containerName} dan {protectedItemName} sebagaimana diatur di sini.

Contoh berikut memicu operasi untuk menghentikan perlindungan bagi Berbagi File testshare yang dilindungi dengan azurefilesvault.

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

Tanggapan

Perlindungan terhadap penghapusan adalah operasi asinkron. Operasi ini akan menciptakan operasi lain yang perlu dilacak secara terpisah. Ini mengembalikan dua respons: 202 (Diterima) ketika operasi lain dibuat dan 204 (NoContent) ketika operasi tersebut selesai.

Langkah selanjutnya