Miękkie usuwanie w Azure Compute Gallery (wersja zapoznawcza)

Funkcja usuwania nietrwałego w Azure Compute Gallery umożliwia odzyskanie przypadkowo usuniętych wersji obrazów przed ich trwałym usunięciem. Usuwanie nietrwałe jest dostępne od wersji 2024-03-03interfejsu API . Wersja interfejsu API 2026-03-03 dodaje dostosowywalne okresy przechowywania i karencji i zmienia moment, w którym można użyć obrazu usuniętego nietrwale. Ta funkcja jest obecnie dostępna tylko dla obrazów Azure Compute Gallery.

Ważne

Funkcja miękkiego usuwania jest obecnie dostępna w wersji zapoznawczej. Zobacz dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta, wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane w wersji ogólnodostępnej.

Soft Delete jest dostępny dla następujących typów galerii:

  • Prywatne
  • Galeria bezpośredniego udostępniania
  • Galeria społeczności

Gdy wersja obrazu zostanie usunięta przy użyciu funkcji Soft delete, nie zostanie natychmiast usunięta z systemu. Zamiast tego przechodzi w stan miękkiego usunięcia i przechodzi przez następujący cykl życia:

  • Okres przechowywania: W przypadku wersji 2026-03-03 interfejsu API obraz pozostaje możliwy do odzyskania i dostępny do wykorzystania. Obraz umożliwia tworzenie maszyn wirtualnych i zestawów skalowania maszyn wirtualnych oraz skalowanie istniejących zestawów skalowania maszyn wirtualnych w poziomie. Okres przechowywania może wynosić do 365 dni i domyślnie wynosi siedem dni.
  • Okres karencji: Okres karencji rozpoczyna się po wygaśnięciu okresu przechowywania. Obraz pozostaje możliwy do odzyskania, ale nie można go już wykorzystywać. Próby użycia tego do tworzenia maszyn wirtualnych, zestawów skalowania maszyn wirtualnych lub skalowania istniejących zestawów skalowania maszyn wirtualnych kończą się niepowodzeniem. Okres karencji może wynosić do 90 dni i domyślnie wynosi siedem dni.
  • Trwałe usunięcie: Platforma trwale usuwa plik obrazu po zakończeniu okresu karencji.

W przypadku wersji interfejsu API wcześniejszych niż 2026-03-03 nie można użyć obrazu usuniętego nietrwale do utworzenia maszyny wirtualnej lub zestawu skalowania maszyn wirtualnych ani do skalowania istniejącego zestawu skalowania w okresie przechowywania. Wersja interfejsu API 2026-03-03 umożliwia wykonywanie tych operacji w okresie przechowywania i blokuje je dopiero po rozpoczęciu okresu karencji.

Miękkie usuwanie jest przydatne w środowiskach, w których przypadkowe usunięcia mogą zakłócać przepływy pracy lub powodować utratę danych. Jeśli nie potrzebujesz okna odzyskiwania, możesz pominąć funkcję Soft delete i trwale usunąć wersję obrazu.

Wymagania wstępne

  • Zarejestruj funkcję miękkiego usuwania usuwania galerii obliczeniowej Azure w portalu Azure.
  • Możesz też zarejestrować funkcję Soft Delete galerii Azure Compute, uruchamiając następujące az feature register polecenie w interfejsie wiersza polecenia: 
    az feature register --name SIGSoftDelete --namespace Microsoft.Compute
  • Minimalna wersja interfejsu API wymagana do używania miękkiego usuwania to 2024-03-03.
  • Użyj interfejsu API w wersji 2026-03-03, aby dostosować okresy przechowywania i prolongaty, korzystać z obrazów w okresie przechowywania i używać nowych właściwości cyklu życia obrazu.

Ograniczenia

  • Obsługa Soft Delete jest dostępna tylko w portalu Azure lub REST API, ale ma pewne ograniczenia.
  • Odzyskiwanie Virtual Machine Apps nie jest obsługiwane.
  • Usuwanie galerii lub definicji obrazu z tymczasowo usuniętymi zasobami nie jest obsługiwane.
  • Tylko następujący użytkownicy mogą włączyć miękkie usuwanie: właściciel subskrypcji, użytkownik lub jednostka usługi przypisani do roli administratora udostępniania galerii obliczeniowej na poziomie subskrypcji lub galerii
  • Nie można włączyć Soft Delete, jeśli galeria lub definicja obrazu i wersja obrazu znajdują się w różnych regionach.
  • Odzyskiwanie obrazu nie jest możliwe, jeśli galeria, definicja obrazu lub wersja obrazu znajdują się w różnych regionach.
  • Zestawy skalowania maszyn wirtualnych w ramach elastycznej orkiestracji nie są zgodne z funkcją Soft Delete.
  • Jeśli obraz w galerii z włączonym usuwaniem nietrwałym ma stan aprowizacji zakończony niepowodzeniem, możesz pominąć usuwanie nietrwałe i trwale usunąć obraz.

Fakturowanie

Soft Delete jest bezpłatne. Liczba replik nie zmniejsza się, gdy obraz przechodzi w stan miękkiego usunięcia. Opłaty są naliczane za wszystkie zachowane repliki w okresach przechowywania i prolongaty, dopóki obraz systemu nie zostanie trwale usunięty. Te opłaty można zatrzymać wcześniej, trwale usuwając obraz systemu.

Możesz włączyć miękkie usuwanie w nowej lub istniejącej galerii.

Aby włączyć funkcję Soft Delete w istniejącej galerii, wyślij następujące żądanie PUT. W ramach żądania uwzględnij właściwość softDeletePolicy, ustaw isSoftDeleteEnabled na true i określ retentionPeriodInDays oraz gracePeriodInDays. Ustaw okres przechowywania z zakresu od 1 do 365 dni i okres karencji z zakresu od 1 do 90 dni. Oba okresy są domyślnie ustawione na siedem dni. W poniższym przykładzie użyto siedmiodniowego okresu przechowywania i 30-dniowego okresu karencji.

PUT 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}?api-version=2026-03-03 
{
    "properties": {
        "softDeletePolicy": {
            "isSoftDeleteEnabled": true,
            "retentionPeriodInDays": 7,
            "gracePeriodInDays": 30
        }
    },
    "location": "{location}"
}

Tymczasowe usunięcie obrazu

Po włączeniu tymczasowego usuwania w galerii wszystkie obrazy w galerii są usuwane tymczasowo.

Aby miękko usunąć obraz, wyślij następujące DELETE żądanie do zasobu, który chcesz usunąć. Pomiń opcjonalny parametr bypassSoftDelete lub ustaw go na false.

DELETE 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}/images/{image-definition-name}/versions/{version-name}?api-version=2026-03-03

Lista wszystkich miękko usuniętych obrazów

Wyświetl listę miękko usuniętych obrazów w galerii lub definicji obrazu. Począwszy od wersji interfejsu API 2026-03-03, odpowiedź zawiera następujące właściwości cyklu życia:

Property Opis
softDeleteTime Czas przejścia obrazu do stanu usunięcia nietrwałego.
consumptionEndTime Czas, w którym kończy się okres przechowywania i rozpoczyna się okres prolongaty. Po tym czasie próby użycia obrazu do utworzenia maszyn wirtualnych lub skalowania w poziomie zestawów skalowania maszyn wirtualnych kończą się niepowodzeniem. Ta wartość zależy od skonfigurowanego okresu przechowywania.
hardDeletionTargetTime Docelowy termin, gdy okres prolongaty wygaśnie, a platforma trwale usunie obraz systemu. Obraz można odzyskać do tego czasu. Ta wartość zależy od skonfigurowanego okresu karencji.
imageState Bieżący stan obrazu. Active oznacza, że image jest aktywny i nie został usunięty miękko. SoftDeleted oznacza, że obraz przeszedł do stanu miękkiego usunięcia. Obraz usunięty logicznie pozostaje dostępny do użycia do consumptionEndTime, a można go odzyskać do hardDeletionTargetTime. W okresie prolongaty między tymi okresami obraz systemu pozostaje w stanie SoftDeleted i można go odzyskać, ale nie można go użyć.

Wyślij następujące GET żądanie na zasób definicji obrazu, aby wyświetlić listę wszystkich tymczasowo usuniętych obrazów.

GET 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}/softDeletedArtifactTypes/Images/artifacts/{image-definition-name}/versions?api-version=2026-03-03

Odzyskiwanie miękko usuniętego obrazu

Możesz odzyskać obraz usunięty programowo w okresie przechowywania i karencji, aż do hardDeletionTargetTime. W tym przykładzie pokażemy, jak odzyskać obraz usunięty tymczasowo.

Aby odzyskać tymczasowo usunięte obrazy w galerii, wyślij następujące PUT żądanie dotyczące wersji obrazu do odzyskania wraz z regionem macierzystym obrazu.

PUT 
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}/images/{image-definition-name}/versions/{version-name}?api-version=2026-03-03
{
    "location": "eastus2euap"
}

Twarde usuwanie obrazu

Trwałe usunięcie trwale usuwa plik obrazu bez możliwości odzyskania. Możesz trwale usunąć obraz, który jest już w stanie usunięcia miękkiego, bez oczekiwania na zakończenie okresu przechowywania i okresów karencji. Alternatywnie można pominąć Soft Delete i trwale usunąć aktywny obraz bez umieszczania go w stanie Soft Delete.

Trwale usuń obrazek w stanie miękkiego usunięcia

Aby trwale usunąć obraz, który jest już w stanie usunięcia nietrwałego, wyślij następujące żądanie. Ta operacja natychmiast usuwa miękko usunięty artefakt bez oczekiwania na zakończenie okresu przechowywania i okresów karencji.

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{rgName}/providers/Microsoft.Compute/galleries/{gallery-name}/softDeletedArtifactTypes/Images/artifacts/{image-definition-name}/versions/{version-name}?api-version=2024-03-03

Pomiń usunięcie miękkie aktywnego obrazu

Opcjonalny bypassSoftDelete parametr zapytania jest wartością logiczną. Ustaw tę opcję na true, aby trwale usunąć aktywną wersję obrazu galerii bez przechowywania jej w koszu. Ta operacja jest nieodwracalna.

bypassSoftDelete Zasady miękkiego usuwania galerii Result
true Włączone lub wyłączone Trwale usuwa wersję obrazu z galerii. Wersja nie jest zachowywana w koszu i nie można jej przywrócić.
false lub pominięto Enabled Wykonuje miękkie usunięcie wersji. Wersja jest przechowywana w koszu i może zostać przywrócona w skonfigurowanym okresie odzyskiwania.
false lub pominięto Disabled Trwale usuwa wersję, ponieważ nie obowiązują żadne zasady usuwania programowego.

Aby pominąć funkcję Soft Delete i trwale usunąć aktywną wersję obrazu, wyślij następujące żądanie:

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{galleryImageName}/versions/{galleryImageVersionName}?api-version=2026-03-03&bypassSoftDelete=true

Często zadawane pytania

Tak, o ile operacja miękkiego usuwania zakończy się pomyślnie.

Tak, o ile operacja miękkiego usuwania zakończy się pomyślnie.

Czy mogę zaktualizować okres przechowywania dłuższy niż siedem dni?

Yes. Korzystając z wersji 2026-03-03interfejsu API, można skonfigurować okres przechowywania przez maksymalnie 365 dni. Domyślny okres przechowywania wynosi siedem dni.

Czy aktualizacja okresu przechowywania ma wpływ na istniejące wersje obrazów miękko usuniętych?

No. Okres przechowywania nie jest resetowany dla istniejących wersji obrazów miękko usuniętych. Zaktualizowany okres przechowywania dotyczy tylko wersji obrazów, które zostały miękko usunięte po aktualizacji.

Yes. Wersja obrazu usunięta, gdy usuwanie nietrwałe było włączone, pozostaje dostępna do odzyskania w okresie przechowywania, nawet jeśli później wyłączysz usuwanie nietrwałe w galerii.

Czy mogę zaktualizować okres karencji?

Yes. W wersji 2026-03-03interfejsu API można skonfigurować okres karencji przez maksymalnie 90 dni. Domyślny okres karencji wynosi siedem dni.

Nie, można albo usunąć wszystkie miękko usunięte obrazy, albo wyłączyć miękkie usuwanie w galerii, aby usunąć definicję obrazu.

  • Ostatnia aktualizacja o