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órą należy monitorować. 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 przedziale czasu 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 istnieją w nim 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ć wyłączenie funkcji usuwania nietrwałego dla określonego magazynu w zależności od scenariusza. Dowiedz się więcej na temat usuwania nietrwałego.
Pobieranie stanu usuwania nietrwałego przy użyciu interfejsu API REST
Domyślnie dla każdego nowo utworzonego magazynu usługi Recovery Services zostanie włączony stan usuwania nietrwałego. Aby pobrać/zaktualizować stan usuwania nietrwałego 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} jest "testVaultRG". Ponieważ wszystkie wymagane parametry są podane w identyfikatorze URI, nie ma potrzeby oddzielnej treści żądania.
GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15
Odpowiedzi
Poniżej przedstawiono pomyślną odpowiedź dla operacji "GET":
| Nazwisko | Pisz | Opis |
|---|---|---|
| 200 OK | BackupResourceVaultConfig | OK |
Przykładowa odpowiedź
Po przesłaniu żądania "GET" zostanie zwrócona odpowiedź 200 (pomyślna).
{
"id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 , . {vaultresourceGroupName} {vaultName} W tym przykładzie {vaultName} jest to "testVault" i {vaultresourceGroupName} jest "testVaultRG". Jeśli zastąpimy identyfikator URI wartościami powyżej, identyfikator URI będzie wyglądać następująco.
PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15
Tworzenie treści żądania
Następujące typowe definicje służą do tworzenia treści żądania
Aby uzyskać więcej informacji, zapoznaj się z dokumentacją interfejsu API REST
| Nazwisko | Wymagania | Type | Opis |
|---|---|---|---|
| Etag | String | Opcjonalny element eTag | |
| lokalizacja | prawda | String | Lokalizacja zasobu |
| właściwości | Właściwości magazynu | Właściwości magazynu | |
| tags | Objekt | Tagi zasobów |
Przykładowa treść żądania
Użyj poniższego przykładu, aby zaktualizować stan usuwania nietrwałego na wartość "disabled".
{
"properties": {
"enhancedSecurityState": "Enabled",
"softDeleteFeatureState": "Disabled"
}
}
Odpowiedzi na operację PATCH
Poniżej przedstawiono pomyślną odpowiedź dla operacji "PATCH":
| Nazwisko | Pisz | 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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
"name": "vaultconfig",
"type": "Microsoft.RecoveryServices/vaults/backupconfig",
"properties": {
"enhancedSecurityState": "Enabled",
"softDeleteFeatureState": "Disabled"
}
}
Następne kroki
Aby uzyskać więcej informacji na temat interfejsów API REST platformy Azure, zobacz następujące dokumenty: