REST API aracılığıyla Azure Backup kullanarak Azure Dosyaları yedekleme

Bu makalede, REST API aracılığıyla Azure Backup kullanarak Azure Dosyaları'nın nasıl yedeklenmesi açıklanır. Ayrıca Azure portalı, CLI ve AzurePowerShell'i kullanarak Azure Dosyaları'nın yedekleyebilirsiniz.

Bu makalede, Dosya Paylaşımınız için yedeklemeyi yapılandırmak için zaten bir Kurtarma Hizmetleri kasası ve ilkesi oluşturduğunuz varsayılır. Henüz yapmadıysanız, yeni kasalar ve ilkeler oluşturmak için kasa oluşturma ve ilke oluşturma REST API öğreticilerine bakın.

Bu makale için aşağıdaki kaynakları kullanacağız:

  • RecoveryServicesVault: azurefilesvault

  • Politika:schedule1

  • Kaynak grubu: azurefiles

  • Depolama Hesabı: testvault2

  • Dosya Paylaşımı: testshare

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.

REST API kullanarak korumasız Azure Dosyaları için yedeklemeyi yapılandırma

Korumasız Azure Dosyaları ile depolama hesaplarını bulma

Kasanın, Kurtarma Hizmetleri kasasına yedeklenebilen Dosya Paylaşımları ile abonelikteki tüm Azure depolama hesaplarını bulması gerekir. Bu, yenileme işlemi kullanılarak tetiklenir. Eşzamansız bir POST işlemidir, kasanın geçerli abonelikteki tüm korumasız Azure Dosya Paylaşımlarının en son listesini almasını ve bunları 'önbelleğe almasını' temin eder. Dosya Paylaşımı 'önbelleğe alındıktan' sonra Kurtarma hizmetleri Dosya Paylaşımı'na erişebilir ve dosyayı koruyabilir.

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

POST URI'sinde , {subscriptionId}, {vaultName}ve {vaultresourceGroupName} parametreleri vardır{fabricName}. Örneğimizde, farklı parametrelerin değeri aşağıdaki gibi olacaktır:

  • {fabricName}Azure'dır

  • {vaultName} azurefilesvault

  • {vaultresourceGroupName} azurefiles dır

  • $filter=backupManagementType eq 'AzureStorage'

Gerekli tüm parametreler URI'de verildiğinden ayrı bir istek gövdesine gerek yoktur.

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'

Yenileme işlemine yanıtlar

'Refresh' işlemi zaman uyumsuz bir işlemdir. Bu, bu işlemin ayrı olarak izlenmesi gereken başka bir işlem oluşturduğu anlamına gelir.

İ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 (Tamam).

Yenileme işlemine örnek yanıtlar

POST isteği gönderildikten sonra 202 (Kabul Edildi) yanıtı döndürülür.

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'

Basit bir GET komutuyla "Konum" üst bilgisini kullanarak sonuçta elde edilen işlemi izleyin

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

Tüm Azure Depolama hesapları bulunduktan sonra GET komutu 204 (İçerik Yok) yanıtı döndürür. Kasa artık abonelik içinde yedeklenebilen Dosya Paylaşımlarına sahip tüm depolama hesaplarını bulabilir.

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

Kurtarma Hizmetleri kasasıyla yedeklenebilecek Dosya Paylaşımlarına sahip depolama hesaplarının listesini alın.

"Önbelleğe alma" işleminin tamamlandığını onaylamak için, Kurtarma Hizmetleri kasasıyla yedeklenebilen Dosya Paylaşımları ile abonelikteki tüm depolama hesaplarını listeleyin. Ardından yanıtta istediğiniz depolama hesabını bulun. Bu, GET ProtectableContainers işlemi kullanılarak yapılır.

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'

GET URI'sinde gerekli tüm parametreler bulunur. Ek bir talep gövdesine gerek yok.

Yanıt gövdesi örneği:

{

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

​      }

​    }

  ]

}

Yanıt gövdesinde testvault2 depolama hesabını okunaklı adıyla bulabildiğimiz için, yukarıda yapılan yenileme işlemi başarılı oldu. Kurtarma Hizmetleri kasası artık aynı abonelikte korumasız dosya paylaşımları olan depolama hesaplarını başarıyla bulabilir.

Depolama hesabını Kurtarma Hizmetleri kasasıyla kaydet

Bu adım yalnızca depolama hesabını daha önce kasaya kaydetmediyseniz gereklidir. ProtectionContainers-Register işlemi aracılığıyla kasayı kaydedebilirsiniz.

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

URI için değişkenleri aşağıdaki gibi ayarlayın:

  • {resourceGroupName} - azurefiles
  • {fabricName} - Azure
  • {vaultName} - azurefilesvault
  • {containerName} - Bu, GET ProtectableContainers işleminin yanıt gövdesindeki name özniteliğidir. Bizim örneğimizde, StorageContainer;Storage;AzureFiles;testvault2

Not

Her zaman yanıtın ad özniteliğini alın ve bu isteği doldurun. Sabit kod oluşturmayın veya kapsayıcı adı biçimini oluşturmayın. Bunu oluşturur veya sabit kodlarsanız, gelecekte kapsayıcı adı biçimi değişirse API çağrısı başarısız olur.


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

Oluşturma isteği gövdesi aşağıdaki gibidir:

{

 "properties": {


  "containerType": "StorageContainer",


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


  "resourceGroup": "AzureFiles",


  "friendlyName": "testvault2",


  "backupManagementType": "AzureStorage"

 }
}

İstek gövdesi tanımlarının tam listesi ve diğer ayrıntılar için bkz. ProtectionContainers-Register.

Bu zaman uyumsuz bir işlemdir ve iki yanıt döndürür: İşlem kabul edildiğinde "202 Kabul Edildi" ve işlem tamamlandığında "200 Tamam". İşlem durumunu izlemek için, işlemin en son durumunu almak için konum üst bilgisini kullanın.

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

İşlem tamamlandığında yanıt gövdesi örneği:

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

Kayıt işleminin başarılı olup olmadığını, yanıt gövdesindeki parametresinin değerinden registrationstatus doğrulayabilirsiniz. Bizim örneğimizde testvault2 için durumu kayıtlı olarak gösterir, bu nedenle kayıt işlemi başarılı oldu.

Depolama hesabı altında tüm korumasız dosya paylaşımlarını sorgulama

Koruma Kapsayıcıları-Sorgulama işlemini kullanarak depolama hesabındaki korunabilir öğeler hakkında bilgi edinebilirsiniz. Bu zaman uyumsuz bir işlemdir ve sonuçlar konum üst bilgisi kullanılarak izlenmelidir.

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

Yukarıdaki URI için değişkenleri aşağıdaki gibi ayarlayın:

  • {vaultName} - azurefilesvault
  • {fabricName} - Azure
  • {containerName}- GET ProtectableContainers işleminin yanıt gövdesindeki name özniteliğine bakın. Örneğimizde 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

İstek başarılı olduktan sonra "Tamam" durum kodunu döndürür

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

Yedeklemek istediğiniz Dosya Paylaşımını seçin

Aboneliğin altındaki tüm korunabilir öğeleri listeleyebilir ve GET backupprotectableItems işlemini kullanarak yedeklenecek dosya paylaşımını bulabilirsiniz.

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

URI'yi aşağıdaki gibi oluşturun:

  • {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

Örnek yanıt:

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

Yanıt, korumasız tüm Dosya Paylaşımlarının listesini içerir ve Azure Kurtarma Hizmeti tarafından yedeklemeyi yapılandırmak için gereken tüm bilgileri içerir.

Dosya Paylaşımı için yedeklemeyi etkinleştirme

İlgili Dosya Paylaşımı dostça bir adla tanımlandıktan sonra, koruma altına alınacak politikayı seçin. Mevcut ilkeler hakkında daha fazla bilgi edinmek için list Policy API bölümüne bakın. Ardından ilke adına bakarak ilgili ilkeyi seçin. İlke oluşturmak için ilke oluşturma öğreticisine bakın.

Korumayı etkinleştirme, "korumalı öğe" oluşturan zaman uyumsuz bir PUT işlemidir.

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

GET backupprotectableitems işleminin yanıt gövdesindeki ID özniteliğini kullanarak containername ve protecteditemname değişkenlerini ayarlayın.

Örneğimizde, korumak istediğimiz Dosya Paylaşımı kimliği şu şekildedir:

"/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; depolama; azurefiles; testvault2
  • {protectedItemName} - azurefileshare; testshare

Alternatif olarak, koruma kapsayıcısının ad özniteliğine ve korunabilir öğe yanıtlarına da başvurabilirsiniz.

Not

Her zaman yanıtın ad özniteliğini alın ve bu isteği doldurun. Sabit kod oluşturmayın veya kapsayıcı adı biçimini veya korumalı öğe adı biçimini oluşturmayın. Bunu oluşturur veya sabit kodlarsanız, gelecekte kapsayıcı adı biçimi veya korumalı öğe adı biçimi değişirse API çağrısı başarısız olur.


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

İstek gövdesi oluşturma:

Aşağıdaki istek gövdesi, korumalı öğe oluşturmak için gereken özellikleri tanımlar.

{
  "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, GET backupprotectableItems yanıtında parentcontainerFabricID değeridir.

Örnek Yanıtı

Korumalı bir öğenin oluşturulması, izlenmesi gereken başka bir işlem oluşturan zaman uyumsuz bir işlemdir. İ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 (Tamam).

Korumalı öğe oluşturma veya güncelleştirme için PUT isteğini gönderdikten sonra, ilk yanıt 202 (Kabul Edildi) ve bir konum üst bilgisi olur.

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

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

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

İşlem tamamlandıktan sonra, yanıt gövdesinde korumalı öğe içeriğiyle 200 (Tamam) döndürür.

Örnek Yanıt Gövdesi:

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

Bu, Dosya Paylaşımı için korumanın etkinleştirildiğini ve ilke zamanlamasına göre ilk yedeklemenin tetiklendiğini onaylar.

Dosya Paylaşımı için isteğe bağlı yedekleme tetikleme

Azure Dosyaları yedekleme için yapılandırıldıktan sonra yedeklemeler ilke zamanlamasına göre çalışır. İstediğiniz zaman ilk zamanlanmış yedeklemeyi bekleyebilir veya isteğe bağlı yedekleme tetikleyebilirsiniz.

İsteğe bağlı yedekleme tetikleme bir POST işlemidir.

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

Yedekleme etkinleştirilirken {containerName} ve {protectedItemName} yukarıda belirtildiği gibi oluşturulmuştur. Örneğimiz için şu ifadeye çevrilir:

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

İstek gövdesi oluşturma

İsteğe bağlı bir yedeklemeyi başlatmak için, istek gövdesinin bileşenleri aşağıdadır.

Adı Tür Açıklama
Özellikler Azure Dosya Paylaşımı Yedekleme İsteği BackupRequestResource özellikleri

İstek gövdesi tanımlarının tam listesi ve diğer ayrıntılar için, korumalı öğeler için yedeklemeleri tetikleme REST API belgesine bakın.

İstek İçeriği Örneği

{

  "properties":{

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

}

İsteğe bağlı yedekleme işlemine yanıtlar

İsteğe bağlı yedekleme tetikleme zaman uyumsuz bir işlemdir. Bu, bu işlemin ayrı olarak izlenmesi gereken başka bir işlem oluşturduğu anlamına gelir.

İ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 (Tamam).

İsteğe bağlı yedekleme işlemine örnek yanıtlar

İsteğe bağlı yedekleme için POST isteğini gönderdikten sonra ilk yanıt, konum üst bilgisi veya Azure-async-header ile 202 (Kabul Edildi) olur.

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

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

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

İşlem başarılı bir şekilde tamamlandığında, 200 (Tamam) durum kodunu ve sonuçta elde edilen yedekleme işinin kimliğini yanıt gövdesinde döndürür.

Örnek yanıt gövdesi

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

Yedekleme işi uzun süre çalışan bir işlem olduğundan, REST API belgesi kullanılarak izleme işlerinde açıklandığı gibi izlenmesi gerekir.

Sonraki adımlar

  • Last updated on