Share via

Back-up maken van Azure-bestandsshare met behulp van Azure Backup via REST API

  • Artikel

In dit artikel wordt beschreven hoe u een back-up maakt van een Azure-bestandsshare met behulp van Azure Backup via REST API.

In dit artikel wordt ervan uitgegaan dat u al een Recovery Services-kluis en -beleid hebt gemaakt voor het configureren van back-ups voor uw bestandsshare. Als u dit nog niet hebt gedaan, raadpleegt u de zelfstudies voor het maken van een kluis en maakt u rest API-zelfstudies voor beleid voor het maken van nieuwe kluizen en beleid.

Voor dit artikel gebruiken we de volgende resources:

  • RecoveryServicesVault: azurefilesvault

  • Beleid: schedule1

  • Resourcegroep: azurefiles

  • Opslagaccount: testvault2

  • Bestandsshare: testshare

Back-up configureren voor een niet-beveiligde Azure-bestandsshare met behulp van REST API

Opslagaccounts detecteren met niet-beveiligde Azure-bestandsshares

De kluis moet alle Azure-opslagaccounts in het abonnement detecteren met bestandsshares waarvan een back-up kan worden gemaakt naar de Recovery Services-kluis. Dit wordt geactiveerd met behulp van de vernieuwingsbewerking. Het is een asynchrone POST-bewerking die ervoor zorgt dat de kluis de meest recente lijst krijgt met alle niet-beveiligde Azure-bestandsshares in het huidige abonnement en 'caches'. Zodra de bestandsshare in de cache is opgeslagen, kan Recovery Services toegang krijgen tot de bestandsshare en deze beveiligen.

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

De POST-URI heeft , {vaultName}en {vaultresourceGroupName}{fabricName} parameters{subscriptionId}. In ons voorbeeld is de waarde voor de verschillende parameters als volgt:

  • {fabricName} is Azure

  • {vaultName} is azurefilesvault

  • {vaultresourceGroupName} is azurefiles

  • $filter=backupManagementType eq 'AzureStorage'

Omdat alle vereiste parameters worden opgegeven in de URI, is er geen afzonderlijke aanvraagbody nodig.

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'

Antwoorden op de vernieuwingsbewerking

De bewerking Vernieuwen is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.

Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.

Voorbeeldantwoorden voor de vernieuwingsbewerking

Zodra de POST-aanvraag is ingediend, wordt een antwoord van 202 (Geaccepteerd) geretourneerd.

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'

De resulterende bewerking bijhouden met behulp van de header Locatie met een eenvoudige GET-opdracht

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

Zodra alle Azure Storage-accounts zijn gedetecteerd, retourneert de GET-opdracht een antwoord van 204 (geen inhoud). De kluis kan nu elk opslagaccount detecteren met bestandsshares waarvan een back-up kan worden gemaakt binnen het abonnement.

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

Lijst met opslagaccounts ophalen met bestandsshares waarvan een back-up kan worden gemaakt met Recovery Services-kluis

Als u wilt controleren of opslaan in cache is voltooid, vermeldt u alle opslagaccounts in het abonnement met bestandsshares waarvan een back-up kan worden gemaakt met de Recovery Services-kluis. Zoek vervolgens het gewenste opslagaccount in het antwoord. Dit wordt gedaan met behulp van de bewerking 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'

De GET-URI heeft alle vereiste parameters. Er is geen extra aanvraagbody nodig.

Voorbeeld van antwoordtekst:

{

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

​      }

​    }

  ]

}

Omdat we het testvault2-opslagaccount kunnen vinden in de hoofdtekst van het antwoord met de beschrijvende naam, is de hierboven uitgevoerde vernieuwingsbewerking geslaagd. De Recovery Services-kluis kan nu opslagaccounts detecteren met niet-beveiligde bestandsshares in hetzelfde abonnement.

Opslagaccount registreren bij Recovery Services-kluis

Deze stap is alleen nodig als u het opslagaccount niet eerder bij de kluis hebt geregistreerd. U kunt de kluis registreren via de bewerking 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

Stel de variabelen voor de URI als volgt in:

  • {resourceGroupName} - azurefiles
  • {fabricName} - Azure
  • {vaultName} - azurefilesvault
  • {containerName}: dit is het naamkenmerk in de hoofdtekst van de bewerking GET ProtectableContainers. In ons voorbeeld is het StorageContainer;Storage;AzureFiles;testvault2

Notitie

Neem altijd het naamkenmerk van het antwoord en vul deze in deze aanvraag in. Maak geen code of maak de indeling van de containernaam niet. Als u deze maakt of codeert, mislukt de API-aanroep als de indeling van de containernaam in de toekomst wordt gewijzigd.


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

De hoofdtekst van de aanvraag maken is als volgt:

{

 "properties": {


  "containerType": "StorageContainer",


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


  "resourceGroup": "AzureFiles",


  "friendlyName": "testvault2",


  "backupManagementType": "AzureStorage"

 }
}

Raadpleeg ProtectionContainers-Register voor de volledige lijst met definities van de aanvraagbody en andere details.

Dit is een asynchrone bewerking en retourneert twee antwoorden: '202 Geaccepteerd' wanneer de bewerking wordt geaccepteerd en '200 OK' wanneer de bewerking is voltooid. Als u de bewerkingsstatus wilt bijhouden, gebruikt u de locatieheader om de meest recente status van de bewerking op te halen.

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

Voorbeeld van antwoordtekst wanneer de bewerking is voltooid:

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

U kunt controleren of de registratie is geslaagd op basis van de waarde van de registrationstatus parameter in de hoofdtekst van het antwoord. In ons geval wordt de status weergegeven als geregistreerd voor testvault2, zodat de registratiebewerking is geslaagd.

Alle niet-beveiligde bestandsshares onder een opslagaccount invragen

U kunt vragen stellen over beveiligbare items in een opslagaccount met behulp van de bewerking Protection Containers-Inquire . Het is een asynchrone bewerking en de resultaten moeten worden bijgehouden met behulp van de locatieheader.

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

Stel de variabelen voor de bovenstaande URI als volgt in:

  • {vaultName} - azurefilesvault
  • {fabricName} - Azure
  • {containerName}- Raadpleeg het naamkenmerk in de antwoordtekst van de bewerking GET ProtectableContainers. In ons voorbeeld is het StorageContainer; Opslag; 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

Zodra de aanvraag is geslaagd, wordt de statuscode 'OK' geretourneerd

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

Selecteer de bestandsshare waarvoor u een back-up wilt maken

U kunt alle beveiligbare items onder het abonnement weergeven en de gewenste bestandsshare zoeken waarvan een back-up moet worden gemaakt met behulp van de bewerking GET backupprotectableItems .

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

Bouw de URI als volgt:

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

Voorbeeldantwoord:

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

Het antwoord bevat de lijst met alle niet-beveiligde bestandsshares en bevat alle informatie die de Azure Recovery Service nodig heeft om de back-up te configureren.

Back-up inschakelen voor de bestandsshare

Nadat de relevante bestandsshare is geïdentificeerd met de beschrijvende naam, selecteert u het beleid dat u wilt beveiligen. Raadpleeg de lijst policy-API voor meer informatie over bestaande beleidsregels in de kluis. Selecteer vervolgens het relevante beleid door te verwijzen naar de beleidsnaam. Als u beleidsregels wilt maken, raadpleegt u de zelfstudie over het maken van beleid.

Beveiliging inschakelen is een asynchrone PUT-bewerking waarmee een beveiligd item wordt gemaakt.

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

Stel de variabelen containername en protecteditemname in met behulp van het id-kenmerk in de antwoordtekst van de bewerking GET backupprotectableitems.

In ons voorbeeld is de id van de bestandsshare die we willen beveiligen:

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

U kunt ook verwijzen naar het naamkenmerk van de beveiligingscontainer en beveiligbare itemreacties.

Notitie

Neem altijd het naamkenmerk van het antwoord en vul deze in deze aanvraag in. Maak geen code of maak de indeling van de containernaam of de indeling van de beveiligde itemnaam. Als u deze maakt of codeert, mislukt de API-aanroep als de indeling van de containernaam of de indeling van de beveiligde itemnaam in de toekomst wordt gewijzigd.


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

Een aanvraagbody maken:

De volgende aanvraagbody definieert eigenschappen die vereist zijn voor het maken van een beveiligd item.

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

De sourceResourceId is de parentcontainerFabricID in reactie op GET backupprotectableItems.

Voorbeeldantwoord

Het maken van een beveiligd item is een asynchrone bewerking, waarmee een andere bewerking wordt gemaakt die moet worden bijgehouden. Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.

Nadat u de PUT-aanvraag hebt ingediend voor het maken of bijwerken van beveiligde items, is het eerste antwoord 202 (geaccepteerd) met een locatieheader.

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

Volg vervolgens de resulterende bewerking met behulp van de locatieheader of Azure-AsyncOperation-header met een GET-opdracht .

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

Zodra de bewerking is voltooid, wordt 200 (OK) geretourneerd met de inhoud van het beveiligde item in de hoofdtekst van het antwoord.

Hoofdtekst van voorbeeldantwoord:

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

Hiermee wordt bevestigd dat beveiliging is ingeschakeld voor de bestandsshare en dat de eerste back-up wordt geactiveerd volgens het beleidsschema.

Een back-up op aanvraag activeren voor bestandsshare

Zodra een Azure-bestandsshare is geconfigureerd voor back-ups, worden back-ups uitgevoerd volgens het beleidsschema. U kunt op elk gewenst moment wachten op de eerste geplande back-up of een back-up op aanvraag activeren.

Het activeren van een back-up op aanvraag is een POST-bewerking.

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} en {protectedItemName} zijn zoals hierboven is samengesteld terwijl back-ups worden ingeschakeld. In ons voorbeeld wordt dit omgezet in:

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

Hoofdtekst van aanvraag maken

Als u een back-up op aanvraag wilt activeren, volgt u de onderdelen van de aanvraagbody.

Name Type Description
Eigenschappen AzurefilesharebackupReques Eigenschappen van BackupRequestResource

Raadpleeg voor de volledige lijst met definities van de aanvraagbody en andere details back-ups activeren voor rest API-documenten voor beveiligde items.

Voorbeeld van aanvraagtekst

{

  "properties":{

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

}

Antwoorden op de back-upbewerking op aanvraag

Het activeren van een back-up op aanvraag is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.

Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer een andere bewerking wordt gemaakt en 200 (OK) wanneer deze bewerking is voltooid.

Voorbeeldantwoorden op de back-upbewerking op aanvraag

Nadat u de POST-aanvraag voor een back-up op aanvraag hebt ingediend, is het eerste antwoord 202 (geaccepteerd) met een locatieheader of 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'

Volg vervolgens de resulterende bewerking met behulp van de locatieheader of Azure-AsyncOperation-header met een GET-opdracht .

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

Zodra de bewerking is voltooid, retourneert deze 200 (OK) met de id van de resulterende back-uptaak in de hoofdtekst van het antwoord.

Voorbeeld hoofdtekst van respons

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

Omdat de back-uptaak een langdurige bewerking is, moet deze worden bijgehouden zoals uitgelegd in de monitortaken met behulp van rest API-document.

Volgende stappen