Eliminazione temporanea nella Raccolta di calcolo di Azure (anteprima)

Importante

La funzionalità Eliminazione temporanea è attualmente disponibile in ANTEPRIMA. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

La funzionalità di eliminazione temporanea di Raccolta di calcolo di Azure consente di recuperare le versioni delle immagini eliminate accidentalmente prima che vengano eliminate definitivamente. Il soft delete è disponibile a partire dalla versione 2024-03-03 dell'API. La versione dell'API 2026-03-03 aggiunge periodi di conservazione e di tolleranza personalizzabili e modifica il momento in cui è possibile utilizzare un'immagine eliminata temporaneamente. Questa funzionalità è attualmente disponibile solo per le immagini di Azure Compute Gallery.

L'eliminazione temporanea è disponibile per i seguenti tipi di raccolta:

  • Privato
  • Raccolta condivisa diretta
  • Raccolta della community

Quando una versione dell'immagine viene eliminata usando Soft delete, non viene rimossa immediatamente dal sistema. Invece, passa a uno stato di eliminazione temporanea e attraversa le seguenti fasi del ciclo di vita:

  • Periodo di conservazione: Con la versione 2026-03-03dell'API , l'immagine rimane recuperabile e disponibile per l'utilizzo. È possibile usare l'immagine per creare macchine virtuali e set di scalabilità di macchine virtuali ed è possibile aumentare il numero di istanze dei set di scalabilità di macchine virtuali esistenti. Il periodo di conservazione può essere fino a 365 giorni e il valore predefinito è sette giorni.
  • Periodo di tolleranza: Il periodo di tolleranza inizia alla scadenza del periodo di conservazione. L'immagine può ancora essere recuperata, ma non può più essere utilizzata. I tentativi di usarlo per creare macchine virtuali o set di scalabilità di macchine virtuali o per aumentare il numero di istanze dei set di scalabilità di macchine virtuali esistenti non riescono. Il periodo di tolleranza può essere fino a 90 giorni e il valore predefinito è sette giorni.
  • Eliminazione permanente: La piattaforma elimina definitivamente l'immagine al termine del periodo di tolleranza.

Con le versioni dell'API precedenti 2026-03-03a , non è possibile usare un'immagine eliminata esistente per creare una macchina virtuale o un set di scalabilità di macchine virtuali o aumentare il numero di istanze di un set di scalabilità esistente durante il periodo di conservazione. La versione 2026-03-03 dell'API consente queste operazioni durante il periodo di conservazione e le blocca solo dopo l'inizio del periodo di grazia.

Il soft delete è utile negli ambienti in cui le eliminazioni accidentali possono interrompere i flussi di lavoro o causare la perdita di dati. Se non è necessaria la finestra di ripristino, è possibile ignorare Soft delete ed eliminare definitivamente una versione dell'immagine.

Prerequisiti

  • Registrare la funzionalità di Soft Delete della Azure Compute Gallery nel portale di Azure.
  • In alternativa, registrare la funzionalità di Soft Delete della Azure Compute Gallery eseguendo il comando seguente az feature register dalla CLI: 
    az feature register --name SIGSoftDelete --namespace Microsoft.Compute
  • La versione minima dell'API necessaria per usare l'eliminazione temporanea è 2024-03-03.
  • Usare la versione dell'API 2026-03-03 per personalizzare i periodi di conservazione e di tolleranza, utilizzare le immagini durante il periodo di conservazione e usare le nuove proprietà del ciclo di vita dell'immagine.

Limitazioni

  • "Soft Delete" è supportato solo nel portale di Azure o nell'API REST con alcune limitazioni.
  • Il ripristino delle applicazioni delle macchine virtuali non è supportato.
  • L'eliminazione di una galleria o di una definizione d'immagine con risorse 'soft deleted' non è supportata.
  • Solo i seguenti utenti possono abilitare l'eliminazione temporanea: il proprietario di una sottoscrizione, un utente o un'entità servizio assegnata al ruolo di amministratore della condivisione della raccolta di calcolo a livello di sottoscrizione o di raccolta
  • Non è possibile abilitare l'eliminazione temporanea se la raccolta o la definizione dell'immagine e la versione dell'immagine si trovano in aree diverse.
  • Non è possibile recuperare l'immagine se la raccolta o la definizione dell'immagine si trova in un'area diversa da quella della versione dell'immagine.
  • I set di scalabilità di macchine virtuali nell'orchestrazione flessibile non sono compatibili con la funzionalità Soft Delete.
  • Quando un'immagine in una galleria con eliminazione temporanea abilitata ha uno stato di provisioning non riuscito, è possibile ignorare l'eliminazione temporanea ed eliminare definitivamente l'immagine.

Billing

Soft Delete è gratuito. Il numero di repliche non si riduce quando un'immagine entra nello stato di eliminazione temporanea. Vengono addebitati i costi per tutte le repliche conservate durante i periodi di conservazione e di tolleranza, fino a quando l'immagine non viene eliminata definitivamente. È possibile interrompere prima questi addebiti eliminando definitivamente l'immagine.

È possibile abilitare l'eliminazione temporanea in una raccolta nuova o esistente.

Per abilitare l'eliminazione temporanea su una galleria esistente, inviare la seguente richiesta PUT. Come parte della richiesta, includere la proprietà softDeletePolicy, impostare isSoftDeleteEnabled su true e specificare retentionPeriodInDays e gracePeriodInDays. Impostare il periodo di conservazione da 1 a 365 giorni e il periodo di tolleranza compreso tra 1 e 90 giorni. Per impostazione predefinita, entrambi i periodi sono impostati su sette giorni. L'esempio seguente usa un periodo di conservazione di sette giorni e un periodo di tolleranza di 30 giorni.

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}"
}

Soft delete un'immagine

Dopo aver abilitato l'eliminazione temporanea in una raccolta, tutte le immagini nella raccolta vengono eliminate temporaneamente.

Per eseguire una soft delete di un'immagine, inviare la richiesta seguente DELETE sulla risorsa da eliminare. Omettere il parametro facoltativo bypassSoftDelete o impostarlo su 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

Elencare tutte le immagini eliminate in modo non definitivo

Visualizzare un elenco di immagini eliminate temporaneamente in una raccolta o in una definizione di immagine. A partire dalla versione 2026-03-03dell'API , la risposta include le proprietà del ciclo di vita seguenti:

Property Description
softDeleteTime Data e ora in cui l'immagine è passata allo stato di eliminazione temporanea.
consumptionEndTime Il momento in cui il periodo di conservazione scade e il periodo di tolleranza inizia. Dopo questo momento, i tentativi di utilizzare l'immagine per creare macchine virtuali o aumentare il numero di istanze dei set di scalabilità di macchine virtuali avranno esito negativo. Questo valore dipende dal periodo di conservazione configurato.
hardDeletionTargetTime Momento in cui scade il periodo di tolleranza e la piattaforma elimina definitivamente l'immagine. È possibile recuperare l'immagine fino a questo momento. Questo valore dipende dal periodo di tolleranza configurato.
imageState Stato dell'immagine corrente. Active significa che l'immagine è attiva e non è eliminata logicamente. SoftDeleted significa che l'immagine è entrata nello stato di eliminazione temporanea. Un'immagine eliminata temporaneamente rimane utilizzabile fino a consumptionEndTime e recuperabile fino a hardDeletionTargetTime. Durante il periodo di tolleranza compreso tra questi due momenti, l'immagine rimane nello stato SoftDeleted ed è recuperabile, ma non può essere utilizzata.

Invia la seguente richiesta GET alla risorsa della definizione dell'immagine per elencare tutte le immagini eliminate temporaneamente.

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

Recuperare un'immagine eliminata temporaneamente

È possibile recuperare un'immagine eliminata temporaneamente durante i periodi di conservazione e di tolleranza, fino al momento indicato da hardDeletionTargetTime. In questo esempio viene illustrato come ripristinare un'immagine eliminata temporaneamente.

Per ripristinare le immagini eliminate temporaneamente in una raccolta, inviare la seguente richiesta PUT alla versione dell'immagine da recuperare insieme all'area geografica di origine dell'immagine.

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"
}

Eliminare definitivamente un'immagine

L'eliminazione definitiva elimina definitivamente un'immagine senza la possibilità di ripristino. È possibile eliminare definitivamente un'immagine già nello stato di eliminazione temporanea senza attendere la scadenza dei periodi di conservazione e di tolleranza. In alternativa, è possibile ignorare Soft Delete ed eliminare definitivamente un'immagine attiva senza inserirla nello stato Soft Delete.

Eliminare definitivamente un'immagine nello stato di eliminazione temporanea

Per eliminare definitivamente un'immagine già nello stato eliminato temporaneamente, inviare la richiesta seguente. Questa operazione elimina immediatamente l'artefatto eliminato in modo logico, senza attendere il termine dei periodi di conservazione e di tolleranza.

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

Escludere un'immagine attiva dall'eliminazione temporanea

Il facoltativo bypassSoftDelete parametro di query è un valore booleano. Impostarlo su true per eliminare definitivamente una versione dell'immagine della raccolta attiva senza conservarla nel Cestino. Questa operazione è irreversibile.

bypassSoftDelete Criterio di eliminazione temporanea della raccolta Result
true Abilitato o disabilitato Elimina definitivamente la versione dell'immagine della raccolta. La versione non viene mantenuta nel Cestino e non può essere ripristinata.
false o omesso Enabled Elimina temporaneamente la versione. La versione viene mantenuta nel Cestino e può essere ripristinata durante il periodo di recupero configurato.
false o omesso Disabled Elimina definitivamente la versione perché non viene applicato alcun criterio di eliminazione software.

Per ignorare Soft Delete ed eliminare definitivamente una versione attiva dell'immagine, inviare la richiesta seguente:

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

Domande frequenti

Sì, purché l'operazione di eliminazione temporanea venga completata correttamente.

Sì, purché l'operazione di eliminazione temporanea venga completata correttamente.

È possibile aggiornare il periodo di conservazione oltre sette giorni?

Yes. Usando la versione 2026-03-03dell'API , è possibile configurare il periodo di conservazione per un massimo di 365 giorni. Il periodo di conservazione predefinito è di sette giorni.

La modifica del periodo di conservazione influisce sulle versioni delle immagini già eliminate temporaneamente?

No. Il periodo di conservazione non viene reimpostato per le versioni delle immagini già eliminate temporaneamente. Il periodo di conservazione aggiornato si applica solo alle versioni delle immagini eliminate temporaneamente dopo l'aggiornamento.

Yes. Una versione dell'immagine eliminata mentre Soft Delete era abilitato rimane recuperabile durante il periodo di conservazione, anche se successivamente si disabilita Soft Delete nella galleria.

È possibile aggiornare il periodo di tolleranza?

Yes. Con la versione 2026-03-03dell'API è possibile configurare il periodo di tolleranza per un massimo di 90 giorni. Il periodo di tolleranza predefinito è di sette giorni.

No, è possibile eliminare tutte le immagini eliminate temporaneamente o disabilitare l'eliminazione temporanea nella galleria per eliminare la definizione dell'immagine.

  • Ultimo aggiornamento: