Aktualizowanie konfiguracji magazynu usługi Azure Recovery Services przy użyciu interfejsu API REST

W tym artykule opisano sposób aktualizowania konfiguracji powiązanych z kopiami zapasowymi w magazynie usługi Azure Recovery Services przy użyciu interfejsu API REST.

Stan usuwania nietrwałego

Usuwanie kopii zapasowych chronionego elementu jest znaczącą operacją, która musi być monitorowana. Aby chronić przed przypadkowymi usunięciami, magazyn usługi Azure Recovery Services ma możliwość usuwania nietrwałego. Ta funkcja umożliwia przywrócenie usuniętych kopii zapasowych, w razie potrzeby, w czasie po usunięciu.

Istnieją jednak scenariusze, w których ta funkcja nie jest wymagana. Nie można usunąć magazynu usługi Azure Recovery Services, jeśli w nim znajdują się elementy kopii zapasowej, nawet usunięte nietrwale. Może to stanowić problem, jeśli magazyn musi zostać natychmiast usunięty. Na przykład: operacje wdrażania często oczyszczają utworzone zasoby w tym samym przepływie pracy. Wdrożenie może utworzyć magazyn, skonfigurować kopie zapasowe dla elementu, wykonać przywracanie testowe, a następnie przejść do usunięcia elementów kopii zapasowej i magazynu. Jeśli usunięcie magazynu zakończy się niepowodzeniem, całe wdrożenie może zakończyć się niepowodzeniem. Wyłączenie usuwania nietrwałego jest jedynym sposobem zagwarantowania natychmiastowego usunięcia.

Dlatego należy starannie wybrać, czy należy wyłączyć usuwanie nietrwałe dla określonego magazynu w zależności od scenariusza. Aby uzyskać więcej informacji, zobacz artykuł dotyczący usuwania nietrwałego.

Pobieranie stanu usuwania nietrwałego przy użyciu interfejsu API REST

Domyślnie stan usuwania nietrwałego zostanie włączony dla każdego nowo utworzonego magazynu usługi Recovery Services. Aby pobrać/zaktualizować stan usuwania nietrwałego dla magazynu, użyj dokumentu interfejsu API REST powiązanego z konfiguracją magazynu kopii zapasowych

Aby pobrać bieżący stan usuwania nietrwałego dla magazynu, użyj następującej operacji GET

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

Identyfikator URI GET ma {subscriptionId}parametry , . {vaultresourceGroupName}{vaultName} W tym przykładzie {vaultName} jest to "testVault" i {vaultresourceGroupName} "testVaultRG". Ponieważ wszystkie wymagane parametry są podane w identyfikatorze URI, nie ma potrzeby oddzielnej treści żądania.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Odpowiedzi

Pomyślna odpowiedź dla operacji "GET" jest pokazana poniżej:

Nazwa Typ Opis
200 OK BackupResourceVaultConfig OK
Przykładowa odpowiedź

Po przesłaniu żądania "GET" zwracana jest odpowiedź 200 (pomyślna).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Aktualizowanie stanu usuwania nietrwałego przy użyciu interfejsu API REST

Aby zaktualizować stan usuwania nietrwałego magazynu usługi Recovery Services przy użyciu interfejsu API REST, użyj następującej operacji PUT

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

Identyfikator URI PUT ma {subscriptionId}parametry , {vaultName}. {vaultresourceGroupName} W tym przykładzie {vaultName} jest to "testVault" i {vaultresourceGroupName} "testVaultRG". Jeśli zastąpimy identyfikator URI powyższymi wartościami, identyfikator URI będzie wyglądać następująco.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Tworzenie treści żądania

Poniższe typowe definicje służą do tworzenia treści żądania

Aby uzyskać więcej informacji, zapoznaj się z dokumentacją interfejsu API REST

Nazwa Wymagany Typ Opis
Etag Ciąg Opcjonalny tag eTag
location true Ciąg Lokalizacja zasobu
properties VaultProperties Właściwości magazynu
tags Obiekt Tagi zasobów

Przykładowa treść żądania

Poniższy przykład służy do aktualizowania stanu usuwania nietrwałego na wartość "disabled".

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Odpowiedzi na operację PATCH

Poniżej przedstawiono pomyślną odpowiedź dla operacji "PATCH":

Nazwa Typ Opis
200 OK BackupResourceVaultConfig OK
Przykładowa odpowiedź dla operacji PATCH

Po przesłaniu żądania "PATCH" zostanie zwrócona odpowiedź 200 (pomyślna).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Następne kroki

Utwórz zasady tworzenia kopii zapasowych na potrzeby tworzenia kopii zapasowych maszyny wirtualnej platformy Azure w tym magazynie.

Aby uzyskać więcej informacji na temat interfejsów API REST platformy Azure, zobacz następujące dokumenty: