Dela via

Säkerhetskopiera Azure-filresurs med Hjälp av Azure Backup via REST API

  • Artikel

Den här artikeln beskriver hur du säkerhetskopierar en Azure-filresurs med hjälp av Azure Backup via REST API.

Den här artikeln förutsätter att du redan har skapat ett Recovery Services-valv och en princip för att konfigurera säkerhetskopiering för filresursen. Om du inte har gjort det kan du läsa självstudierna skapa ett valv och skapa princip-REST API för att skapa nya valv och principer.

I den här artikeln använder vi följande resurser:

  • RecoveryServicesVault: azurefilesvault

  • Politik: schedule1

  • Resursgrupp: azurefiles

  • Lagringskonto: testvault2

  • Filresurs: testshare

Konfigurera säkerhetskopiering för en oskyddad Azure-filresurs med hjälp av REST API

Identifiera lagringskonton med oskyddade Azure-filresurser

Valvet måste identifiera alla Azure-lagringskonton i prenumerationen med filresurser som kan säkerhetskopieras till Recovery Services-valvet. Detta utlöses med uppdateringsåtgärden. Det är en asynkron POST-åtgärd som säkerställer att valvet hämtar den senaste listan över alla oskyddade Azure-filresurser i den aktuella prenumerationen och "cachelagrar" dem. När filresursen har cachelagrats kan Recovery Services komma åt filresursen och skydda den.

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:n har {subscriptionId}parametrarna , {vaultName}, {vaultresourceGroupName}och {fabricName} . I vårt exempel är värdet för de olika parametrarna följande:

  • {fabricName} är Azure

  • {vaultName} är azurefilesvault

  • {vaultresourceGroupName} är azurefiles

  • $filter=backupManagementType eq "AzureStorage"

Eftersom alla obligatoriska parametrar anges i URI:n behöver du ingen separat begärandetext.

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'

Svar på uppdateringsåtgärden

Uppdateringsåtgärden är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

Exempel på svar på uppdateringsåtgärden

När POST-begäran har skickats returneras ett 202-svar (godkänt).

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'

Spåra den resulterande åtgärden med hjälp av "Plats"-huvudet med ett enkelt GET-kommando

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

När alla Azure Storage-konton har identifierats returnerar GET-kommandot ett 204-svar (inget innehåll). Valvet kan nu identifiera alla lagringskonton med filresurser som kan säkerhetskopieras i prenumerationen.

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

Hämta lista över lagringskonton med filresurser som kan säkerhetskopieras med Recovery Services-valv

Bekräfta att "cachelagring" är klar genom att visa en lista över alla lagringskonton i prenumerationen med filresurser som kan säkerhetskopieras med Recovery Services-valvet. Leta sedan upp det önskade lagringskontot i svaret. Detta görs med hjälp av åtgärden 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'

GET-URI:n har alla nödvändiga parametrar. Ingen ytterligare begärandetext behövs.

Exempel på svarstext:

{

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

​      }

​    }

  ]

}

Eftersom vi kan hitta testvault2-lagringskontot i svarstexten med det egna namnet lyckades uppdateringsåtgärden ovan. Recovery Services-valvet kan nu identifiera lagringskonton med oskyddade filresurser i samma prenumeration.

Registrera lagringskonto med Recovery Services-valv

Det här steget behövs bara om du inte registrerade lagringskontot med valvet tidigare. Du kan registrera valvet via åtgärden 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

Ange variablerna för URI:n enligt följande:

  • {resourceGroupName} – azurefiles
  • {fabricName} – Azure
  • {vaultName} – azurefilesvault
  • {containerName} – det här är namnattributet i svarstexten för åtgärden GET ProtectableContainers. I vårt exempel är det StorageContainer;Storage;AzureFiles;testvault2

Kommentar

Ta alltid namnattributet för svaret och fyll i det i den här begäran. Hårdkoda inte eller skapa inte formatet containernamn. Om du skapar eller hårdkodar det misslyckas API-anropet om containernamnformatet ändras i framtiden.


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

Brödtexten för skapa begäran är följande:

{

 "properties": {


  "containerType": "StorageContainer",


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


  "resourceGroup": "AzureFiles",


  "friendlyName": "testvault2",


  "backupManagementType": "AzureStorage"

 }
}

Den fullständiga listan över definitioner av begärandetexten och annan information finns i ProtectionContainers-Register.

Det här är en asynkron åtgärd och returnerar två svar: "202 Accepted" när åtgärden godkänns och "200 OK" när åtgärden är klar. Om du vill spåra åtgärdsstatusen använder du platsrubriken för att hämta den senaste statusen för åtgärden.

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

Exempel på svarstext när åtgärden är klar:

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

Du kan kontrollera om registreringen lyckades från värdet för parametern registrationstatus i svarstexten. I vårt fall visar den statusen som registrerad för testvault2, så registreringsåtgärden lyckades.

Fråga alla oskyddade filresurser under ett lagringskonto

Du kan fråga om skyddsbara objekt i ett lagringskonto med hjälp av åtgärden Protection Containers-Inquire . Det är en asynkron åtgärd och resultatet bör spåras med hjälp av platsrubriken.

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

Ange variablerna för ovanstående URI enligt följande:

  • {vaultName} – azurefilesvault
  • {fabricName} – Azure
  • {containerName}– Referera till namnattributet i svarstexten för åtgärden GET ProtectableContainers. I vårt exempel är det StorageContainer; Lagring; 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

När begäran har slutförts returneras statuskoden "OK"

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

Välj den filresurs som du vill säkerhetskopiera

Du kan lista alla skyddsbara objekt under prenumerationen och leta upp den önskade filresursen som ska säkerhetskopieras med hjälp av åtgärden GET backupprotectableItems .

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

Konstruera URI:n på följande sätt:

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

Exempelsvar:

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

Svaret innehåller listan över alla oskyddade filresurser och innehåller all information som krävs av Azure Recovery Service för att konfigurera säkerhetskopian.

Aktivera säkerhetskopiering för filresursen

När den relevanta filresursen har "identifierats" med det egna namnet väljer du den princip som ska skyddas. Mer information om befintliga principer i valvet finns i listan princip-API. Välj sedan relevant princip genom att referera till principnamnet. Information om hur du skapar principer finns i självstudien Skapa princip.

Aktivering av skydd är en asynkron PUT-åtgärd som skapar ett "skyddat objekt".

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

Ange variablerna containername och protecteditemname med hjälp av ID-attributet i svarstexten för åtgärden GET backupprotectableitems.

I vårt exempel är ID:t för filresursen som vi vill skydda:

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

Eller så kan du referera till namnattributet för skyddscontainern och svar på skyddsbara objekt.

Kommentar

Ta alltid namnattributet för svaret och fyll i det i den här begäran. Hårdkoda inte eller skapa formatet containernamn eller skyddat objektnamn. Om du skapar eller hårdkodar det misslyckas API-anropet om formatet för containernamn eller skyddat objektnamn ändras i framtiden.


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

Skapa en begärandetext:

Följande begärandetext definierar egenskaper som krävs för att skapa ett skyddat objekt.

{
  "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 är parentcontainerFabricID som svar på GET backupprotectableItems.

Exempelsvar

Skapandet av ett skyddat objekt är en asynkron åtgärd som skapar en annan åtgärd som måste spåras. Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

När du har skickat PUT-begäran om att skapa eller uppdatera skyddade objekt är det första svaret 202 (accepterad) med en platsrubrik.

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

Spåra sedan den resulterande åtgärden med hjälp av platsrubriken eller Azure-AsyncOperation-huvudet med ett GET-kommando .

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

När åtgärden är klar returneras 200 (OK) med det skyddade objektinnehållet i svarstexten.

Exempel på svarstext:

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

Detta bekräftar att skyddet är aktiverat för filresursen och att den första säkerhetskopieringen utlöses enligt principschemat.

Utlös en säkerhetskopiering på begäran för filresurs

När en Azure-filresurs har konfigurerats för säkerhetskopiering körs säkerhetskopieringar enligt principschemat. Du kan vänta på den första schemalagda säkerhetskopieringen eller utlösa en säkerhetskopiering på begäran när som helst.

Att utlösa en säkerhetskopiering på begäran är en POST-åtgärd.

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} och {protectedItemName} är som konstruerade ovan när du aktiverar säkerhetskopiering. I vårt exempel översätts detta till:

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

Skapa begärandetext

Om du vill utlösa en säkerhetskopiering på begäran följer du komponenterna i begärandetexten.

Namn Type Beskrivning
Egenskaper AzurefilesharebackupReques Egenskaper för BackupRequestResource

En fullständig lista över definitioner av begärandetexten och annan information finns i utlösarsäkerhetskopior för REST API-dokument för skyddade objekt.

Exempel på begärandetext

{

  "properties":{

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

}

Svar på säkerhetskopieringen på begäran

Att utlösa en säkerhetskopiering på begäran är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas och 200 (OK) när åtgärden slutförs.

Exempel på svar på säkerhetskopiering på begäran

När du skickar POST-begäran om en säkerhetskopiering på begäran är det första svaret 202 (accepterad) med en platsrubrik eller 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'

Spåra sedan den resulterande åtgärden med hjälp av platsrubriken eller Azure-AsyncOperation-huvudet med ett GET-kommando .

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

När åtgärden är klar returneras 200 (OK) med ID:t för det resulterande säkerhetskopieringsjobbet i svarstexten.

Exempelsvarstext

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

Eftersom säkerhetskopieringsjobbet är en tidskrävande åtgärd måste det spåras enligt beskrivningen i övervakningsjobben med hjälp av REST API-dokumentet.

Nästa steg