Sichern eines virtuellen Azure-Computers mithilfe von Azure Backup über die REST-APIBack up an Azure VM using Azure Backup via REST API

In diesem Artikel wird beschrieben, wie Sicherungen für einen virtuellen Azure-Computer mithilfe von Azure Backup über die REST-API verwaltet werden.This article describes how to manage backups for an Azure VM using Azure Backup via REST API. Konfigurieren Sie entsprechend den Beschreibungen in diesem Artikel den erstmaligen Schutz für einen zuvor nicht geschützten virtuellen Azure-Computer, lösen Sie eine bedarfsgesteuerte Sicherung für einen geschützten virtuellen Azure-Computer aus, und ändern Sie die Sicherungseigenschaften eines gesicherten virtuellen Computers über die REST-API.Configure protection for the first time for a previously unprotected Azure VM, trigger an on-demand backup for a protected Azure VM and modify backup properties of a backed-up VM via REST API as explained here.

Informationen zum Erstellen neuer Tresore und Richtlinien finden Sie in den REST-API-Tutorials zum Erstellen eines Tresors und zum Erstellen einer Richtlinie.Refer to create vault and create policy REST API tutorials for creating new vaults and policies.

Angenommen, Sie möchten den virtuellen Computer „testVM“ unter der Ressourcengruppe „testRG“ im Recovery Services-Tresor „testVault“ schützen, der in der Ressourcengruppe „testVaultRG“ mit der Standardrichtlinie („DefaultPolicy“) vorhanden ist.Let's assume you want to protect a VM "testVM" under a resource group "testRG" to a Recovery Services vault "testVault", present within the resource group "testVaultRG", with the default policy (named "DefaultPolicy").

Konfigurieren der Sicherung für einen nicht geschützten virtuellen Azure-Computer über die REST-APIConfigure backup for an unprotected Azure VM using REST API

Ermitteln nicht geschützter virtueller Azure-ComputerDiscover unprotected Azure VMs

Zunächst muss der Tresor den virtuellen Azure-Computer ermitteln können.First, the vault should be able to identify the Azure VM. Dies wird über den „refresh“-Vorgang ausgelöst.This is triggered using the refresh operation. Es handelt sich um einen asynchronen POST-Vorgang, mit dem sichergestellt wird, dass der Tresor die neueste Liste aller nicht geschützten virtuellen Computer im aktuellen Abonnement abruft und „zwischenspeichert“.It is an asynchronous POST operation that makes sure the vault gets the latest list of all unprotected VM in the current subscription and 'caches' them. Wenn der virtuelle Computer „zwischengespeichert“ wurde, kann in Recovery Services auf ihn zugegriffen werden, um ihn zu schützen.Once the VM is 'cached', Recovery services will be able to access the VM and protect it.

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

Der POST-URI enthält die Parameter {subscriptionId}, {vaultName}, {vaultresourceGroupName} und {fabricName}.The POST URI has {subscriptionId}, {vaultName}, {vaultresourceGroupName}, {fabricName} parameters. Für {fabricName} ist „Azure“ festgelegt.The {fabricName} is "Azure". In unserem Beispiel ist „testVault“ für {vaultName} und „testVaultRG“ für {vaultresourceGroupName} festgelegt.As per our example, {vaultName} is "testVault" and {vaultresourceGroupName} is "testVaultRG". Da alle erforderlichen Parameter im URI angegeben sind, besteht keine Notwendigkeit eines separaten Anforderungstexts.As all the required parameters are given in the URI, there is no need for a separate request body.

POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/refreshContainers?api-version=2016-12-01

AntwortenResponses

Der „refresh“-Vorgang ist ein asynchroner Vorgang.The 'refresh' operation is an asynchronous operation. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss.It means this operation creates another operation that needs to be tracked separately.

Er gibt zwei Antworten zurück: „202 (Akzeptiert)“, wenn ein anderer Vorgang erstellt wird, und dann „200 (OK)“, wenn dieser Vorgang abgeschlossen ist.It returns two responses: 202 (Accepted) when another operation is created and then 200 (OK) when that operation completes.

NameName typeType BESCHREIBUNGDescription
204 Kein Inhalt204 No Content OK, wird ohne Inhalt zurückgegebenOK with No content returned
202 – Akzeptiert202 Accepted ZulässigAccepted
BeispielantwortenExample responses

Nachdem die POST-Anforderung gesendet wurde, wird die Antwort „202 (Akzeptiert)“ zurückgegeben.Once the POST request is submitted, a 202 (Accepted) response is returned.

HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
X-Content-Type-Options: nosniff
x-ms-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-client-request-id: 4910609f-bb9b-4c23-8527-eb6fa2d3253f; 4910609f-bb9b-4c23-8527-eb6fa2d3253f
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-routing-request-id: SOUTHINDIA:20180521T105701Z:43cf550d-e463-421c-8922-37e4766db27d
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:57:00 GMT
Location: https://management.azure.com/subscriptions//00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13
X-Powered-By: ASP.NET

Verfolgen Sie den resultierenden Vorgang mithilfe des „Location“-Headers mit einem einfachen GET-Befehl nach.Track the resulting operation using the "Location" header with a simple GET command

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13

Nachdem alle virtuellen Azure-Computer ermittelt wurden, gibt der GET-Befehl die Antwort „204 (Kein Inhalt)“ zurück.Once all the Azure VMs are discovered, the GET command returns a 204 (No Content) response. Der Tresor kann nun alle virtuellen Computer im Abonnement ermitteln.The vault is now able to discover any VM within the subscription.

HTTP/1.1 204 NoContent
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-client-request-id: 25bb6345-f9fc-4406-be1a-dc6db0eefafe; 25bb6345-f9fc-4406-be1a-dc6db0eefafe
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14997
x-ms-correlation-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-routing-request-id: SOUTHINDIA:20180521T105825Z:cf6cd73b-9189-4942-a61d-878fcf76b1c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:58:25 GMT
X-Powered-By: ASP.NET

Auswählen des entsprechenden virtuellen Azure-ComputersSelecting the relevant Azure VM

Sie können überprüfen, ob die „Zwischenspeicherung“ erfolgt ist, indem Sie alle schützbaren Elemente unter dem Abonnement auflisten und den gewünschten virtuellen Computer in der Antwort suchen.You can confirm that "caching" is done by listing all protectable items under the subscription and locate the desired VM in the response. Die Antwort dieses Vorgangs enthält auch Informationen dazu, wie Recovery Services einen virtuellen Computer identifiziert.The response of this operation also gives you information on how Recovery Services identifies a VM. Wenn Sie mit dem Muster vertraut sind, können Sie diesen Schritt überspringen und direkt mit dem Aktivieren des Schutzes fortfahren.Once you are familiar with the pattern, you can skip this step and directly proceed to enabling protection.

Dieser Vorgang ist ein GET-Vorgang.This operation is a GET operation.

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

Der GET-URI enthält alle erforderlichen Parameter.The GET URI has all the required parameters. Es ist kein zusätzlicher Anforderungstext erforderlich.No additional request body is needed.

AntwortenResponses

NameName typeType BESCHREIBUNGDescription
200 – OK200 OK WorkloadProtectableItemResourceListWorkloadProtectableItemResourceList OKOK

BeispielantwortenExample responses

Nachdem die GET-Anforderung gesendet wurde, wird die Antwort „200 (OK)“ zurückgegeben.Once the GET request is submitted, a 200 (OK) response is returned.

HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-client-request-id: 40c8601a-c217-4c68-87da-01db8dac93dd; 40c8601a-c217-4c68-87da-01db8dac93dd
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14979
x-ms-correlation-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-routing-request-id: SOUTHINDIA:20180521T071408Z:7c2cf56a-e6be-4345-96df-c27ed849fe36
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:14:08 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG;testVM/protectableItems/vm;iaasvmcontainerv2;testRG;testVM",
      "name": "iaasvmcontainerv2;testRG;testVM",
      "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
      "properties": {
        "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
        "virtualMachineVersion": "Compute",
        "resourceGroup": "testRG",
        "backupManagementType": "AzureIaasVM",
        "protectableItemType": "Microsoft.Compute/virtualMachines",
        "friendlyName": "testVM",
        "protectionState": "NotProtected"
      }
    },……………..

Tipp

Die Anzahl der Werte in einer GET-Antwort ist für eine „Seite“ auf 200 beschränkt.The number of values in a GET response is limited to 200 for a 'page'. Verwenden Sie das Feld „nextLink“, um die URL für die nächste Gruppe von Antworten abzurufen.Use the 'nextLink' field to get the URL for next set of responses.

Die Antwort enthält die Liste aller nicht geschützten virtuellen Azure-Computer, und jedes {value}-Feld enthält alle Informationen, die in Azure Recovery Services zum Konfigurieren der Sicherung erforderlich sind.The response contains the list of all unprotected Azure VMs and each {value} contains all the information required by Azure Recovery Service to configure backup. Notieren Sie zum Konfigurieren der Sicherung das Feld {name} und das Feld {virtualMachineId} im Abschnitt {properties}.To configure backup, note the {name} field and the {virtualMachineId} field in {properties} section. Erstellen Sie wie im Folgenden aufgeführt zwei Variablen aus diesen Feldwerten.Construct two variables from these field values as mentioned below.

  • containerName = "iaasvmcontainer;"+{name}containerName = "iaasvmcontainer;"+{name}
  • protectedItemName = "vm;"+ {name}protectedItemName = "vm;"+ {name}
  • {virtualMachineId} wird später im Anforderungstext verwendet.{virtualMachineId} is used later in the request body

Im Beispiel ergeben die Werte oben Folgendes:In the example, the above values translate to:

  • containerName = "iaasvmcontainer;iaasvmcontainerv2;testRG;testVM"containerName = "iaasvmcontainer;iaasvmcontainerv2;testRG;testVM"
  • protectedItemName = "vm;iaasvmcontainerv2;testRG;testVM"protectedItemName = "vm;iaasvmcontainerv2;testRG;testVM"

Aktivieren des Schutzes für den virtuellen Azure-ComputerEnabling protection for the Azure VM

Nachdem der entsprechende virtuelle Computer zwischengespeichert und ermittelt wurde, wählen Sie die Richtlinie zum Schutz aus.After the relevant VM is "cached" and "identified", select the policy to protect. Weitere Informationen zu vorhandenen Richtlinien im Tresor finden Sie in der Liste der Sicherungsrichtlinien.To know more about existing policies in the vault, refer to list Policy API. Wählen Sie dann die entsprechende Richtlinie aus, indem Sie auf den Richtliniennamen verweisen.Then select the relevant policy by referring to the policy name. Informationen zum Erstellen von Richtlinien finden Sie im Tutorial zum Erstellen von Richtlinien.To create policies, refer to create policy tutorial. Im Beispiel unten wurde „DefaultPolicy“ ausgewählt."DefaultPolicy" is selected in the below example.

Beim Aktivieren des Schutzes handelt es sich um einen asynchronen PUT-Vorgang, mit dem ein „geschütztes Element“ erstellt wird.Enabling protection is an asynchronous PUT operation that creates a 'protected item'.

https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13

{containerName} und {protectedItemName} entsprechen der Erstellung oben.The {containerName} and {protectedItemName} are as constructed above. Für {fabricName} ist „Azure“ festgelegt.The {fabricName} is "Azure". In unserem Beispiel ergibt dies Folgendes:For our example, this translates to:

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13

Erstellen des AnforderungstextsCreate the request body

Zum Erstellen eines geschützten Elements werden die folgenden Komponenten des Anforderungstexts verwendet.To create a protected item, following are the components of the request body.

NameName typeType BESCHREIBUNGDescription
propertiesproperties AzureIaaSVMProtectedItemAzureIaaSVMProtectedItem ProtectedItem-RessourceneigenschaftenProtectedItem Resource properties

Die vollständige Liste mit Definitionen des Anforderungstexts und weitere Einzelheiten finden Sie im Dokument zur REST-API zum Erstellen eines geschützten Elements.For the complete list of definitions of the request body and other details, refer to create protected item REST API document.

Beispiel für AnforderungstextExample request body

Der folgende Anforderungstext definiert zum Erstellen eines geschützten Elements erforderliche Eigenschaften.The following request body defines properties required to create a protected item.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy"
  }
}

Bei {sourceResourceId} handelt es sich um die oben genannte {virtualMachineId} aus der Antwort der Liste der schützbaren Elemente.The {sourceResourceId} is the {virtualMachineId} mentioned above from the response of list protectable items.

AntwortenResponses

Die Erstellung eines geschützten Elements ist ein asynchroner Vorgang.The creation of a protected item is an asynchronous operation. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss.It means this operation creates another operation that needs to be tracked separately.

Er gibt zwei Antworten zurück: „202 (Akzeptiert)“, wenn ein anderer Vorgang erstellt wird, und dann „200 (OK)“, wenn dieser Vorgang abgeschlossen ist.It returns two responses: 202 (Accepted) when another operation is created and then 200 (OK) when that operation completes.

NameName typeType BESCHREIBUNGDescription
200 – OK200 OK ProtectedItemResourceProtectedItemResource OKOK
202 – Akzeptiert202 Accepted ZulässigAccepted
BeispielantwortenExample responses

Nachdem Sie die PUT-Anforderung für die Erstellung oder Aktualisierung eines geschützten Elements gesendet haben, wird als erste Antwort „202 (Akzeptiert)“ mit einem location- oder Azure-async-Header zurückgegeben.Once you submit the PUT request for protected item creation or update, the initial response is 202 (Accepted) with a location header or Azure-async-header.

HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-client-request-id: e1f94eef-9b2d-45c4-85b8-151e12b07d03; e1f94eef-9b2d-45c4-85b8-151e12b07d03
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-routing-request-id: SOUTHINDIA:20180521T073907Z:db785be0-bb20-4598-bc9f-70c9428b170b
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:39:06 GMT
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationResults/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
X-Powered-By: ASP.NET

Verfolgen Sie anschließend den resultierenden Vorgang mithilfe des location- oder Azure-AsyncOperation-Headers mit einem einfachen GET-Befehl nach.Then track the resulting operation using the location header or Azure-AsyncOperation header with a simple GET command.

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13

Wenn der Vorgang abgeschlossen ist, wird „200 (OK)“ mit dem Inhalt des geschützten Elements im Antworttext zurückgegeben.Once the operation completes, it returns 200 (OK) with the protected item content in the response body.

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM",
  "name": "VM;testRG;testVM",
  "type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems",
  "properties": {
    "friendlyName": "testVM",
    "virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "protectionStatus": "Healthy",
    "protectionState": "IRPending",
    "healthStatus": "Passed",
    "lastBackupStatus": "",
    "lastBackupTime": "2001-01-01T00:00:00Z",
    "protectedItemDataId": "17592691116891",
    "extendedInfo": {
      "recoveryPointCount": 0,
      "policyInconsistent": false
    },
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "backupManagementType": "AzureIaasVM",
    "workloadType": "VM",
    "containerName": "iaasvmcontainerv2;testRG;testVM",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy",
    "policyName": "DefaultPolicy"
  }
}

Dies bestätigt, dass der Schutz für den virtuellen Computer aktiviert ist und die erste Sicherung entsprechend dem Richtlinienzeitplan ausgelöst wird.This confirms that protection is enabled for the VM and the first backup will be triggered as per the policy schedule.

Auslösen einer bedarfsgesteuerten Sicherung für einen geschützten virtuellen Azure-ComputerTrigger an on-demand backup for a protected Azure VM

Nachdem ein virtueller Azure-Computer für die Sicherung konfiguriert wurde, werden Sicherungen entsprechend dem Richtlinienzeitplan durchgeführt.Once an Azure VM is configured for backup, backups happen as per the policy schedule. Sie können warten, bis die erste geplante Sicherung durchgeführt wird, oder jederzeit eine bedarfsgesteuerte Sicherung auslösen.You can wait for the first scheduled backup or trigger an on-demand backup anytime. Die Aufbewahrung für bedarfsgesteuerte Sicherungen unterscheidet sich von der Aufbewahrung bei der Sicherungsrichtlinie und kann für ein bestimmtes Datum und eine bestimmte Uhrzeit angegeben werden.Retention for on-demand backups is separate from backup policy's retention and can be specified to a particular date-time. Wenn sie nicht angegeben ist, wird von 30 Tagen ab dem Tag, an dem die bedarfsgesteuerte Sicherung ausgelöst wurde, ausgegangen.If not specified, it's assumed to be 30 days from the day of the trigger of on-demand backup.

Das Auslösen einer bedarfsgesteuerten Sicherung ist ein POST-Vorgang.Triggering an on-demand backup is a POST operation.

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} und {protectedItemName} entsprechen der Erstellung oben.The {containerName} and {protectedItemName} are as constructed above. Für {fabricName} ist „Azure“ festgelegt.The {fabricName} is "Azure". In unserem Beispiel ergibt dies Folgendes:For our example, this translates to:

POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM/backup?api-version=2016-12-01

Erstellen des AnforderungstextsCreate the request body

Zum Auslösen einer bedarfsgesteuerten Sicherung werden die folgenden Komponenten des Anforderungstexts verwendet.To trigger an on-demand backup, following are the components of the request body.

NameName typeType BESCHREIBUNGDescription
propertiesproperties IaaSVMBackupRequestIaaSVMBackupRequest BackupRequestResource-EigenschaftenBackupRequestResource properties

Die vollständige Liste mit Definitionen des Anforderungstexts und weitere Einzelheiten finden Sie im Dokument zur REST-API zum Auslösen von Sicherungen für geschützte Elemente.For the complete list of definitions of the request body and other details, refer to trigger backups for protected items REST API document.

Beispiel für AnforderungstextExample request body

Der folgende Anforderungstext definiert Eigenschaften, die zum Auslösen einer Sicherung für ein geschütztes Element erforderlich sind.The following request body defines properties required to trigger a backup for a protected item. Wenn die Aufbewahrungsdauer nicht angegeben wird, wird die Sicherung ab dem Zeitpunkt, an dem der Sicherungsauftrag ausgelöst wurde, 30 Tage lang aufbewahrt.If the retention is not specified, it will be retained for 30 days from the time of trigger of the backup job.

{
   "properties": {
    "objectType": "IaasVMBackupRequest",
    "recoveryPointExpiryTimeInUTC": "2018-12-01T02:16:20.3156909Z"
  }
}

AntwortenResponses

Das Auslösen einer bedarfsgesteuerten Sicherung ist ein asynchroner Vorgang.Triggering an on-demand backup is an asynchronous operation. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss.It means this operation creates another operation that needs to be tracked separately.

Er gibt zwei Antworten zurück: „202 (Akzeptiert)“, wenn ein anderer Vorgang erstellt wird, und dann „200 (OK)“, wenn dieser Vorgang abgeschlossen ist.It returns two responses: 202 (Accepted) when another operation is created and then 200 (OK) when that operation completes.

NameName typeType BESCHREIBUNGDescription
202 – Akzeptiert202 Accepted ZulässigAccepted

BeispielantwortenExample responses

Nachdem Sie die POST-Anforderung für eine bedarfsgesteuerte Sicherung gesendet haben, wird als erste Antwort „202 (Akzeptiert)“ mit einem location- oder Azure-async-Header zurückgegeben.Once you submit the POST request for an on-demand backup, the initial response is 202 (Accepted) with a location header or Azure-async-header.

HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-client-request-id: 7df8e874-1d66-4f81-8e91-da2fe054811d; 7df8e874-1d66-4f81-8e91-da2fe054811d
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-routing-request-id: SOUTHINDIA:20180521T083541Z:7885ca75-c7c6-43fb-a38c-c0cc437d8810
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:35:41 GMT
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationResults/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?api-version=2019-05-13
X-Powered-By: ASP.NET

Verfolgen Sie anschließend den resultierenden Vorgang mithilfe des location- oder Azure-AsyncOperation-Headers mit einem einfachen GET-Befehl nach.Then track the resulting operation using the location header or Azure-AsyncOperation header with a simple GET command.

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13

Wenn der Vorgang abgeschlossen ist, wird „200 (OK)“ mit der ID des resultierenden Sicherungsauftrags im Antworttext zurückgegeben.Once the operation completes, it returns 200 (OK) with the ID of the resulting backup job in the response body.

HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-client-request-id: 5a63209d-3708-4e69-a75f-9499f4c8977c; 5a63209d-3708-4e69-a75f-9499f4c8977c
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14995
x-ms-correlation-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-routing-request-id: SOUTHINDIA:20180521T083723Z:a8b13524-2c95-445f-b107-920806f385c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:37:22 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "00000000-0000-0000-0000-000000000000",
  "status": "Succeeded",
  "startTime": "2018-05-21T08:35:40.9488967Z",
  "endTime": "2018-05-21T08:35:40.9488967Z",
  "properties": {
    "objectType": "OperationStatusJobExtendedInfo",
    "jobId": "7ddead57-bcb9-4269-ac31-6a1b57588700"
  }
}

Da es sich bei dem Sicherungsauftrag um einen Vorgang mit langer Ausführungsdauer handelt, muss er wie im Dokument zum Überwachen von Aufträgen mit der REST-API erläutert nachverfolgt werden.Since the backup job is a long running operation, it needs to be tracked as explained in the monitor jobs using REST API document.

Ändern der Sicherungskonfiguration für einen geschützten virtuellen Azure-ComputerModify the backup configuration for a protected Azure VM

Ändern der Richtlinie für den SchutzChanging the policy of protection

Zum Ändern der Richtlinie, mit der der virtuelle Computer geschützt wird, können Sie das gleiche Format wie beim Aktivieren des Schutzes verwenden.To change the policy with which VM is protected, you can use the same format as enabling protection. Geben Sie einfach die neue Richtlinien-ID im Anforderungstext an, und senden Sie die Anforderung.Just provide the new policy ID in the request body and submit the request. Beispiel: Geben Sie zum Ändern der Richtlinie für „testVM“ von „DefaultPolicy“ in „ProdPolicy“ die ID von „ProdPolicy“ im Anforderungstext an.For example: To change the policy of testVM from 'DefaultPolicy' to 'ProdPolicy', provide the 'ProdPolicy' ID in the request body.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/ProdPolicy"
  }
}

Die Antwort erfolgt im gleichen Format wie beim Aktivieren des Schutzes.The response will follow the same format as mentioned for enabling protection

Beenden des Schutzes, jedoch Beibehalten vorhandener DatenStop protection but retain existing data

Um den Schutz für einen geschützten virtuellen Computer zu entfernen, die bereits gesicherten Daten jedoch beizubehalten, entfernen Sie die Richtlinie im Anforderungstext und senden die Anforderung.To remove protection on a protected VM but retain the data already backed up, remove the policy in the request body and submit the request. Nachdem die Zuordnung zur Richtlinie entfernt wurde, werden keine Sicherungen mehr ausgelöst und keine neuen Wiederherstellungspunkte erstellt.Once the association with policy is removed, backups are no longer triggered and no new recovery points are created.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "policyId": ""
  }
}

Die Antwort erfolgt im gleichen Format wie beim Auslösen einer bedarfsgesteuerten Sicherung.The response will follow the same format as mentioned for triggering an on-demand backup. Der resultierende Auftrag muss wie im Dokument zum Überwachen von Aufträgen mit der REST-API erläutert nachverfolgt werden.The resultant job should be tracked as explained in the monitor jobs using REST API document.

Beenden des Schutzes und Löschen der DatenStop protection and delete data

Um den Schutz für einen geschützten virtuellen Computer zu entfernen und auch die Sicherungsdaten zu löschen, führen Sie wie hier beschrieben einen Löschvorgang durch.To remove the protection on a protected VM and delete the backup data as well, perform a delete operation as detailed here.

Das Beenden des Schutzes und das Löschen der Daten ist ein DELETE-Vorgang.Stopping protection and deleting data is a DELETE operation.

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} und {protectedItemName} entsprechen der Erstellung oben.The {containerName} and {protectedItemName} are as constructed above. {fabricName} ist „Azure“.{fabricName} is "Azure". In unserem Beispiel ergibt dies Folgendes:For our example, this translates to:

DELETE https://management.azure.com//Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13

AntwortenResponses

Der DELETE-Vorgang für den Schutz ist ein asynchroner Vorgang.DELETE protection is an asynchronous operation. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss.It means this operation creates another operation that needs to be tracked separately.

Er gibt zwei Antworten zurück: „202 (Akzeptiert)“, wenn ein anderer Vorgang erstellt wird, und dann „204 (NoContent)“, wenn dieser Vorgang abgeschlossen ist.It returns two responses: 202 (Accepted) when another operation is created and then 204 (NoContent) when that operation completes.

NameName typeType BESCHREIBUNGDescription
204 Kein Inhalt204 NoContent Kein InhaltNoContent
202 – Akzeptiert202 Accepted ZulässigAccepted

Wichtig

Zum Schutz vor versehentlichen Löschungen steht für den Recovery Services-Tresor ein Feature für vorläufiges Löschen zur Verfügung.In order to protect against accidental delete scenarios, there is a soft-delete feature available for Recovery services vault. Wenn der Status „Vorläufiges Löschen“ für den Tresor auf „Aktiviert“ festgelegt ist, werden die Daten durch den Löschvorgang NICHT sofort gelöscht.If the soft-delete state of the vault is set to enabled, then the delete operation will NOT immediately delete the data. Sie werden 14 Tage lang aufbewahrt und dann dauerhaft gelöscht.It will be kept for 14 days and then permanently purged. Für diesen Zeitraum von 14 Tagen wird dem Kunden kein Speicher in Rechnung gestellt.Customer is not charged for storage for this 14 days period. Informationen dazu, wie Sie den Löschvorgang rückgängig machen, finden Sie im Abschnitt zum Rückgängigmachen des Löschens.To undo the deletion operation, refer to the undo-delete section.

Rückgängigmachen des Beendens des Schutzes und des Löschens der DatenUndo the stop protection and delete data

Das Rückgängigmachen eines versehentlichen Löschens ähnelt dem Erstellen des Sicherungselements.Undoing the accidental deletion is similar to creating the backup item. Nachdem der Löschvorgang rückgängig gemacht wurde, wird das Element aufbewahrt, aber es werden keine zukünftigen Sicherungen ausgelöst.After undoing the deletion, the item is retained but no future backups are triggered.

Das Rückgängigmachen einer Löschung ist ein PUT-Vorgang, der dem Ändern der Richtlinie und/oder dem Aktivieren des Schutzes sehr ähnlich ist.Undo deletion is a PUT operation which is very similar to changing the policy and/or enabling the protection. Geben Sie einfach die Absicht, den Löschvorgang rückgängig zu machen, mit der Variablen isRehydrate im Anforderungstext an, und übermitteln Sie die Anforderung.Just provide the intent to undo the deletion with the variable isRehydrate in the request body and submit the request. Beispiel: Zum Rückgängigmachen der Löschung von „testVM“ verwenden Sie den folgenden Anforderungstext.For example: To undo the deletion for testVM, the following request body should be used.

{
  "properties": {
    "protectedItemType": "Microsoft.Compute/virtualMachines",
    "protectionState": "ProtectionStopped",
    "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
    "isRehydrate": true
  }
}

Die Antwort erfolgt im gleichen Format wie beim Auslösen einer bedarfsgesteuerten Sicherung.The response will follow the same format as mentioned for triggering an on-demand backup. Der resultierende Auftrag muss wie im Dokument zum Überwachen von Aufträgen mit der REST-API erläutert nachverfolgt werden.The resultant job should be tracked as explained in the monitor jobs using REST API document.

Nächste SchritteNext steps

Wiederherstellen von Daten aus der Sicherung eines virtuellen Azure-Computers.Restore data from an Azure Virtual machine backup.

Weitere Informationen zu den Azure Backup-REST-APIs finden Sie in den folgenden Dokumenten:For more information on the Azure Backup REST APIs, see the following documents: