Condividi tramite

Creare criteri di backup di Servizi di ripristino di Azure usando l'API REST

Questo articolo descrive come creare criteri per il backup di macchine virtuali di Azure, database SQL in macchine virtuali di Azure, database SAP HANA in macchine virtuali di Azure e File di Azure.

Altre informazioni su come creare o modificare un criterio di backup per un insieme di credenziali di Servizi di ripristino di Azure usando l'API REST.

Creare o aggiornare un criterio nell'insieme di credenziali di Servizi di ripristino di Azure

Per creare o aggiornare un criterio di Backup di Azure, usare l'operazione PUT seguente.

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

I parametri {policyName} e {vaultName} vengono forniti nell'URI. Informazioni aggiuntive vengono fornite nel corpo della richiesta.

Creare il corpo della richiesta per i criteri di backup delle macchine virtuali di Azure

Se si vuole creare un criterio per il backup di macchine virtuali di Azure, il corpo della richiesta deve avere i componenti seguenti:

Nome Obbligatorio TIPO Descrzione
properties Vero ProtectionPolicy:AzureIaaSVMProtectionPolicy Proprietà ProtectionPolicyResource
tags Oggetto Tag delle risorse

Per l'elenco completo delle definizioni nel corpo della richiesta, vedere l'articolo sull'API REST dei criteri di backup.

Esempio di corpo della richiesta

Questa sezione fornisce il corpo della richiesta di esempio per creare criteri per il backup della macchina virtuale di Azure, del database SQL nella macchina virtuale di Azure, del database SAP HANA nella macchina virtuale di Azure e di File di Azure.

Scegliere un'origine dati:

Il corpo della richiesta seguente definisce un criterio di backup standard per i backup delle macchine virtuali di Azure.

Questo criterio:

  • Esegue un backup settimanale ogni lunedì, mercoledì, giovedì alle 10:00 ora standard del Pacifico.
  • Conserva i backup eseguiti ogni lunedì, mercoledì, giovedì per una settimana.
  • Conserva i backup eseguiti ogni primo mercoledì e terzo giovedì di un mese per due mesi (sostituisce le condizioni di conservazione precedenti, se presenti).
  • Conserva i backup eseguiti il quarto lunedì e il quarto giovedì di febbraio e novembre per quattro anni (sostituisce le condizioni di conservazione precedenti, se presenti).
{
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "timeZone": "Pacific Standard Time",
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Weekly",
      "scheduleRunTimes": [
        "2018-01-24T10:00:00Z"
      ],
      "scheduleRunDays": [
        "Monday",
        "Wednesday",
        "Thursday"
      ]
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": {
        "daysOfTheWeek": [
          "Monday",
          "Wednesday",
          "Thursday"
        ],
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Weeks"
        }
      },
      "monthlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Wednesday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "First",
            "Third"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        }
      },
      "yearlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "monthsOfYear": [
          "February",
          "November"
        ],
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Monday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "Fourth"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 4,
          "durationType": "Years"
        }
      }
    }
  }
}

Il corpo della richiesta seguente definisce un criterio di backup avanzato per i backup delle macchine virtuali di Azure che creano più backup al giorno.

Questo criterio:

  • Esegue un backup ogni 4 ore dalle 13:30 UTC ogni giorno
  • Mantiene lo snapshot di ripristino istantaneo per 7 giorni
  • Conserva i backup giornalieri per 180 giorni
  • Conserva i backup eseguiti la domenica di ogni settimana per 12 settimane
  • Conserva i backup eseguiti la prima domenica di ogni mese per 12 mesi
{
	"properties": {
		"backupManagementType": "AzureIaasVM",
		"policyType": "V2",
		"instantRPDetails": {},
		"schedulePolicy": {
			"schedulePolicyType": "SimpleSchedulePolicyV2",
			"scheduleRunFrequency": "Hourly",
			"hourlySchedule": {
				"interval": 4,
				"scheduleWindowStartTime": "2023-02-06T15:30:00Z",
				"scheduleWindowDuration": 24
			}
		},
		"retentionPolicy": {
			"retentionPolicyType": "LongTermRetentionPolicy",
			"dailySchedule": {
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 180,
					"durationType": "Days"
				}
			},
			"weeklySchedule": {
				"daysOfTheWeek": [
					"Sunday"
				],
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 12,
					"durationType": "Weeks"
				}
			},
			"monthlySchedule": {
				"retentionScheduleFormatType": "Weekly",
				"retentionScheduleWeekly": {
					"daysOfTheWeek": [
						"Sunday"
					],
					"weeksOfTheMonth": [
						"First"
					]
				},
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 12,
					"durationType": "Months"
				}
			}
		},
		"tieringPolicy": {
			"ArchivedRP": {
				"tieringMode": "DoNotTier",
				"duration": 0,
				"durationType": "Invalid"
			}
		},
		"instantRpRetentionRangeInDays": 7,
		"timeZone": "UTC",
		"protectedItemsCount": 0
	}
}

Importante

I formati di ora per la pianificazione e la conservazione supportano solo DateTime. Non supportano il solo formato Time.

Risposte per la creazione o l'aggiornamento dei criteri di backup

La creazione/aggiornamento dei criteri di backup è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente.

L'operazione restituisce due risposte: 202 (Accepted) quando viene creata un'altra operazione e 200 (OK) quando tale operazione viene completata.

Nome TIPO Descrzione
200 Va bene Criteri di protezioneRisorse Va bene
202 - Accettato Accettato

Risposte di esempio

Dopo aver inviato la richiesta PUT per la creazione o l'aggiornamento dei criteri, la risposta iniziale è 202 (accettata) con un'intestazione location o 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/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operations/00000000-0000-0000-0000-000000000000?api-version=2016-06-01
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/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2019-05-13
X-Powered-By: ASP.NET

Tenere quindi traccia dell'operazione risultante usando l'intestazione location o Azure-AsyncOperation con un semplice comando GET.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2019-05-13

Al termine dell'operazione, viene restituita la risposta 200 (OK) con il contenuto dei criteri nel corpo della risposta.

{
  "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1",
  "name": "testPolicy1",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Weekly",
      "scheduleRunDays": [
        "Monday",
        "Wednesday",
        "Thursday"
      ],
      "scheduleRunTimes": [
        "2018-01-24T10:00:00Z"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": {
        "daysOfTheWeek": [
          "Monday",
          "Wednesday",
          "Thursday"
        ],
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Weeks"
        }
      },
      "monthlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Wednesday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "First",
            "Third"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        }
      },
      "yearlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "monthsOfYear": [
          "February",
          "November"
        ],
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Monday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "Fourth"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 4,
          "durationType": "Years"
        }
      }
    },
    "timeZone": "Pacific Standard Time",
    "protectedItemsCount": 0
  }
}

Se un criterio è già in uso per proteggere un elemento, qualsiasi aggiornamento nei criteri comporterà la modifica della protezione per tutti gli elementi associati.

Passaggi successivi

Abilitare la protezione per una macchina virtuale di Azure non protetta.

Per altre informazioni sulle API REST di Backup di Azure, vedere i documenti seguenti:

  • Last updated on