REST API ile Azure Dosyalar yedeklemesini yönetme

Bu makalede, REST API kullanılarak yedeklenen Azure Dosyalarını yönetmek ve izlemek için görevlerin nasıl gerçekleştirleneceği açıklanmaktadır. Azure portalı, Azure PowerShell ve AzureCLI'yı kullanarak Azure Dosyalar yedeklemelerini de yönetebilirsiniz.

Desteklenen Azure Dosyaları yedekleme ve geri yükleme senaryoları, bölge kullanılabilirliği ve sınırlamaları hakkında bilgi edinmek için destek matrisine bakın. Sık sorulan sorular için sık sorulan sorulara bakın.

İş süreçlerini izleme

Azure Backup hizmeti arka planda çalışan işleri tetikler. Bu, yedeklemeyi tetikleme, geri yükleme işlemleri ve yedeklemeyi devre dışı bırakma gibi senaryoları içerir. Bu işler kimlikleri kullanılarak izlenebilir.

İşlemlerden iş bilgilerini al

Yedeklemeyi tetikleme gibi bir işlem yanıtta her zaman bir jobID döndürür.

Örneğin, tetikleyici yedekleme REST API işleminin son yanıtı aşağıdaki gibidir:

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

Azure Dosyalar yedekleme işi jobId alanı tarafından tanımlanır ve get isteği kullanılarak burada belirtildiği gibi izlenebilir.

İş takibi

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

{jobName}, yukarıda belirtilen "jobId" değeridir. Yanıt her zaman "200 Tamam" olur ve durum alanı işin durumunu belirtir. "Tamamlandı" veya "Uyarılarla Tamamlandı" olduktan sonra, extendedInfo bölümünde iş hakkında daha fazla ayrıntı gösterilir.

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'

Yanıt

Adı Türü Açıklama
200 Tamam JobResource Tamam

Yanıt örneği

GET URI'sı gönderildikten sonra 200 yanıtı döndürülür.

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

İlkeyi değiştirme

Dosya Paylaşımı'nın korunduğu ilkeyi değiştirmek için, korumayı etkinleştirmekle aynı biçimi kullanabilirsiniz. Talep politikasına yeni politika kimliğini girin ve talebi gönderin.

Örneğin: Test paylaşımının koruma ilkesini schedule1 yerine schedule2 olarak değiştirmek için istek gövdesinde schedule2 kimliğini sağlayın.

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

Korumayı durdurun ancak mevcut verileri koruyun

Korumalı bir Dosya Paylaşımındaki korumayı kaldırabilirsiniz, ancak önceden yedeklenmiş verileri koruyabilirsiniz. Bunu yapmak için yedeklemeyi etkinleştirmek ve isteği göndermek için kullandığınız istek gövdesindeki ilkeyi kaldırın. İlkeyle ilişkilendirme kaldırıldıktan sonra yedeklemeler tetiklenmez ve yeni kurtarma noktaları oluşturulmaz.

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

Örnek yanıt

Dosya Paylaşımı için korumayı durdurmak zaman uyumsuz bir işlemdir. İşlem, izlenmesi gereken başka bir işlem oluşturur. İki yanıt döndürür: başka bir işlem oluşturulduğunda 202 (Kabul Edildi) ve bu işlem tamamlandığında 200.

İşlem başarıyla kabul edildiğinde yanıt üst bilgisi:

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'

Ardından get komutuyla konum üst bilgisini veya Azure-AsyncOperation üst bilgisini kullanarak elde edilen işlemi izleyin:

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

Yanıtın içeriği

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

Korumayı durdurma ve verileri silme

Korumalı bir Dosya Paylaşımındaki korumayı kaldırmak ve yedekleme verilerini de silmek için burada ayrıntılı olarak açıklandığı gibi bir silme işlemi gerçekleştirin.

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

{containerName} ve {protectedItemName} parametreleri burada ayarlanmıştır.

Aşağıdaki örnek, azurefilesvault ile korunan testshare Dosya Paylaşımı için korumayı durdurma işlemini tetikler.

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

Yanıtlar

Silme koruması zaman uyumsuz bir işlemdir. İşlem, ayrı olarak izlenmesi gereken başka bir işlem oluşturur. İki yanıt döndürür: başka bir işlem oluşturulduğunda 202 (Kabul Edildi) ve bu işlem tamamlandığında 204 (NoContent).

Sonraki adımlar

  • Last updated on