Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit dem Feature „Soft Delete“ in Azure Compute Gallery können Sie versehentlich gelöschte Bildversionen wiederherstellen, bevor sie endgültig gelöscht werden. Soft Delete ist ab API-Version 2024-03-03 verfügbar. Die API-Version 2026-03-03 fügt anpassbare Aufbewahrungs- und Karenzzeiten hinzu und ändert, wann ein soft-gelöschtes Image genutzt werden kann. Dieses Feature ist derzeit nur für Azure Compute Gallery-Bilder verfügbar.
Von Bedeutung
Das Feature Vorläufiges Löschen befindet sich derzeit im PREVIEW. Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.
Soft Delete ist für die folgenden Katalogtypen verfügbar:
- Privat
- Direkt freigegebener Katalog
- Community-Galerie
Wenn eine Bildversion mithilfe von Soft delete gelöscht wird, wird sie nicht sofort aus dem System entfernt. Stattdessen wechselt es in einen vorläufig gelöschten Zustand und durchläuft den folgenden Lebenszyklus:
-
Aufbewahrungszeitraum: Bei der API-Version
2026-03-03bleibt das Image wiederherstellbar und für den Verbrauch verfügbar. Sie können das Image verwenden, um VMs und VM-Skalierungsgruppen zu erstellen, und Sie können vorhandene VM-Skalierungsgruppen horizontal hochskalieren. Der Aufbewahrungszeitraum kann bis zu 365 Tage betragen und ist standardmäßig auf sieben Tage festgelegt. - Toleranzzeitraum: der Toleranzzeitraum beginnt, wenn der Aufbewahrungszeitraum abläuft. Das Bild bleibt wiederherstellbar, kann aber nicht mehr genutzt werden. Versuche, virtuelle Computer oder Skalierungsgruppen für virtuelle Computer zu erstellen oder vorhandene VM-Skalierungssätze zu skalieren, schlagen fehl. Die Karenzzeit kann bis zu 90 Tage betragen und ist standardmäßig auf sieben Tage festgelegt.
- Dauerhafte Löschung: Die Plattform löscht das Bild dauerhaft, wenn die Nachfrist endet.
Bei API-Versionen vor 2026-03-03 kann ein vorläufig gelöschtes Image nicht verwendet werden, um eine VM-Skalierungsgruppe oder einen Virtual Machine Scale Set zu erstellen oder eine vorhandene Skalierungsgruppe während des Aufbewahrungszeitraums zu skalieren. Die API-Version 2026-03-03 ermöglicht diese Vorgänge während des Aufbewahrungszeitraums und blockiert sie erst nach Beginn der Nachfrist.
Das Soft-Delete ist in Umgebungen nützlich, in denen versehentliche Löschungen Workflows stören oder Datenverlust verursachen können. Wenn Sie das Wiederherstellungsfenster nicht benötigen, können Sie Soft Delete umgehen und eine Bildversion endgültig löschen.
Voraussetzungen
- Registrieren Sie die Azure Compute Gallery Soft Delete-Funktion im Azure-Portal.
- Alternativ können Sie das Feature "Soft Delete" im Azure Compute Gallery registrieren, indem Sie den folgenden
az feature registerBefehl über CLI ausführen:az feature register --name SIGSoftDelete --namespace Microsoft.Compute - Die mindeste API-Version, die für die Verwendung von Soft Delete erforderlich ist, ist
2024-03-03. - Verwenden Sie die API-Version
2026-03-03, um die Aufbewahrungs- und Nachfristen anzupassen, Bilder während des Aufbewahrungszeitraums zu nutzen und die neuen Bildlebenszykluseigenschaften zu verwenden.
Einschränkungen
- Soft Delete wird nur im Azure-Portal oder der Rest-API mit einigen Einschränkungen unterstützt.
- Die Wiederherstellung virtueller Computer-Apps wird nicht unterstützt.
- Das Löschen einer Galerie- oder Bilddefinition mit soft-gelöschten Ressourcen wird nicht unterstützt.
- Nur die folgenden Benutzer können Vorläufiges Löschen aktivieren: der Besitzer eines Abonnements oder ein Benutzer bzw. Dienstprinzipal, dem die Rolle Administrator für die Freigabe von Compute-Gallery auf Abonnement- oder Galerieebene zugeordnet ist
- Sie können „Soft Delete“ nicht aktivieren, wenn sich die Galerie- oder Bilddefinition und Bildversion in verschiedenen Regionen befinden.
- Die Imagewiederherstellung ist nicht möglich, wenn sich der Katalog oder die Imagedefinition und die Imageversion in verschiedenen Regionen befinden.
- Skalierungssätze für virtuelle Computer in flexiblen Orchestrierungssätzen sind nicht mit der Funktion "Soft Delete" kompatibel.
- Wenn ein Bild in einer Galerie mit aktivierter Soft Delete-Funktion einen fehlerhaften Bereitstellungsstatus aufweist, können Sie Soft Delete umgehen und das Bild endgültig löschen.
Abrechnung
Soft Delete ist kostenlos. Die Replikatanzahl wird nicht reduziert, wenn ein Bild in den Soft-Delete-Status wechselt. Ihnen werden alle aufbewahrten Replikate während der Aufbewahrungs- und Nachfristzeiträume berechnet, bis das Image endgültig gelöscht wird. Sie können diese Gebühren früher beenden, indem Sie das Bild dauerhaft löschen.
Aktivieren Sie "Soft Delete" in einer Galerie
Sie können "Soft Delete" für eine neue oder vorhandene Galerie aktivieren.
Um Soft Delete in einer vorhandenen Galerie zu aktivieren, senden Sie die folgende PUT Anforderung. Schließen Sie als Teil der Anforderung die softDeletePolicy-Eigenschaft ein, setzen Sie isSoftDeleteEnabled auf true und geben Sie retentionPeriodInDays und gracePeriodInDays an. Legen Sie den Aufbewahrungszeitraum von 1 bis 365 Tagen und die Karenzzeit von 1 bis 90 Tagen fest. Beide Zeiträume werden standardmäßig auf sieben Tage festgelegt. Im folgenden Beispiel wird ein Aufbewahrungszeitraum von sieben Tagen und ein 30-tägiger Toleranzzeitraum verwendet.
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}"
}
Vorläufiges Löschen eines Bilds
Sobald "Vorläufiges Löschen" in einem Katalog aktiviert ist, werden alle Bilder im Katalog vorläufig gelöscht.
Um ein Bild vorläufig zu löschen, senden Sie die folgende DELETE-Anforderung an die Ressource, die Sie löschen möchten. Lassen Sie den optionalen bypassSoftDelete Parameter aus, oder legen Sie ihn auf 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
Alle soft gelöschten Bilder auflisten
Zeigen Sie eine Liste der vorläufig gelöschten Bilder in einem Katalog oder in einer Bilddefinition an. Beginnend mit der API-Version 2026-03-03enthält die Antwort die folgenden Lebenszykluseigenschaften:
| Property | Description |
|---|---|
softDeleteTime |
Der Zeitpunkt, zu dem das Bild in den Soft-Delete-Zustand überging. |
consumptionEndTime |
Der Zeitpunkt, zu dem der Aufbewahrungszeitraum abläuft und die Nachfrist beginnt. Nach diesem Zeitpunkt schlägt die Verwendung des Images zum Erstellen von virtuellen Computern oder zum Skalieren von VM-Skalierungssätzen fehl. Dieser Wert hängt vom konfigurierten Aufbewahrungszeitraum ab. |
hardDeletionTargetTime |
Der Zeitpunkt, zu dem die Nachfrist abläuft und die Plattform das Image endgültig löscht. Das Bild kann bis zu diesem Zeitpunkt wiederhergestellt werden. Dieser Wert hängt von der konfigurierten Karenzzeit ab. |
imageState |
Der aktuelle Bildzustand.
Active bedeutet, dass das Bild aktiv und nicht vorläufig gelöscht ist.
SoftDeleted bedeutet, dass das Bild in den Soft-Delete-Zustand übergegangen ist. Ein vorläufig gelöschtes Bild bleibt bis consumptionEndTime nutzbar und kann bis hardDeletionTargetTime wiederhergestellt werden. Während des Toleranzzeitraums zwischen diesen Zeitpunkten verbleibt das Bild im SoftDeleted Zustand und kann wiederhergestellt werden, ist aber nicht nutzbar. |
Senden Sie die folgende GET Anforderung an die Ressource der Bilddefinition, um alle vorläufig gelöschten Bilder aufzulisten.
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
Wiederherstellen eines weich gelöschten Bilds
Sie können ein vorläufig gelöschtes Bild während des Aufbewahrungs- und Toleranzzeitraums wiederherstellen, bis hardDeletionTargetTime. In diesem Beispiel zeigen wir, wie Sie ein vorläufig gelöschtes Bild wiederherstellen können.
Um vorläufig gelöschte Bilder in einem Katalog wiederherzustellen, senden Sie die folgende PUT Anforderung an die Bildversion, die zusammen mit der Heimatregion des Bilds wiederhergestellt werden soll.
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"
}
Endgültiges Löschen eines Bilds
Das endgültige Löschen löscht ein Bild dauerhaft, ohne dass eine Wiederherstellung möglich ist. Sie können ein Bild, das sich bereits im Zustand „vorläufig gelöscht“ befindet, endgültig löschen, ohne auf die Aufbewahrungs- und Toleranzzeiträume warten zu müssen. Alternativ können Sie Soft Delete umgehen und ein aktives Bild endgültig löschen, ohne es in den Soft-Delete-Status zu versetzen.
Ein Bild im Status „vorläufig gelöscht“ endgültig löschen
Um ein Bild, das sich bereits im Status „vorläufig gelöscht“ befindet, endgültig zu löschen, senden Sie die folgende Anforderung. Dieser Vorgang löscht das soft-gelöschte Artefakt sofort, ohne auf das Ende der Aufbewahrungs- und Karenzfristen zu warten.
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
Vorläufiges Löschen für ein aktives Bild umgehen
Der optionale bypassSoftDelete Abfrageparameter ist ein boolescher Wert. Legen Sie es auf true, um eine aktive Katalogbildversion dauerhaft zu löschen, ohne sie im Papierkorb beizubehalten. Dieser Vorgang kann nicht rückgängig gemacht werden.
bypassSoftDelete |
Richtlinie zum vorläufigen Löschen im Katalog | Result |
|---|---|---|
true |
„Aktiviert“ oder „Deaktiviert“ | Löscht die Galeriebildversion endgültig. Die Version wird nicht im Papierkorb aufbewahrt und kann nicht wiederhergestellt werden. |
false oder weggelassen |
Enabled | Die Version wird als gelöscht markiert. Die Version wird im Papierkorb aufbewahrt und kann während des konfigurierten Wiederherstellungszeitraums wiederhergestellt werden. |
false oder weggelassen |
Disabled | Löscht die Version dauerhaft, da keine Soft-Delete-Richtlinie gilt. |
Um soft Delete zu umgehen und eine aktive Bildversion endgültig zu löschen, senden Sie die folgende Anforderung:
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
Häufig gestellte Fragen
Wird "Soft Delete" sofort wirksam, sobald sie im Katalog aktiviert wird?
Ja, solange der Soft-Löschvorgang erfolgreich abgeschlossen ist.
Kann ich "Vorläufiges Löschen" in einem vorhandenen Katalog aktivieren und bilder sofort löschen und wiederherstellen oder gibt es eine Verzögerung?
Ja, solange der Soft-Löschvorgang erfolgreich abgeschlossen ist.
Kann ich den Aufbewahrungszeitraum über sieben Tage hinaus aktualisieren?
Yes. Mithilfe der API-Version 2026-03-03können Sie den Aufbewahrungszeitraum für bis zu 365 Tage konfigurieren. Der Standardaufbewahrungszeitraum ist 7 Tage.
Wirkt sich das Aktualisieren des Aufbewahrungszeitraums auf vorhandene soft-gelöschte Imageversionen aus?
No. Der Aufbewahrungszeitraum wird für vorhandene softgelöschte Imageversionen nicht zurückgesetzt. Der aktualisierte Aufbewahrungszeitraum gilt nur für Bildversionen, die nach dem Update weichgelöscht wurden.
Kann ich eine Bildversion nach dem Deaktivieren von Soft Delete in der Galerie wiederherstellen?
Yes. Eine Bildversion, die Sie gelöscht haben, während Soft Delete aktiviert war, bleibt während des Aufbewahrungszeitraums wiederherstellbar, auch wenn Sie Soft Delete später in der Galerie deaktivieren.
Kann ich die Nachfrist aktualisieren?
Yes. Mit DER API-Version 2026-03-03können Sie die Karenzzeit für bis zu 90 Tage konfigurieren. Die standardmäßige Kulanzfrist beträgt sieben Tage.
Kann ich eine Galerie- oder Bilddefinition löschen, die vorübergehend gelöschte Bilder enthält?
Nein, Sie können entweder alle vorläufig gelöschten Bilder löschen oder das vorläufige Löschen in der Galerie deaktivieren, um die Bilddefinition zu löschen.