Condividi tramite

Operazioni delle attività di archiviazione

  • Articolo

Un'attività di archiviazione contiene un set di condizioni e operazioni. Un'operazione è un'azione eseguita da un'attività di archiviazione su ogni oggetto che soddisfa i requisiti di ogni condizione. Questo articolo descrive il formato JSON di un'operazione dell'attività di archiviazione. Tenere presente che il formato è importante se si prevede di creare un'attività di archiviazione usando uno strumento diverso dal portale di Azure (ad esempio, Azure PowerShell o l'interfaccia della riga di comando di Azure). Questo articolo elenca anche le operazioni, i parametri dell'operazione e i valori consentiti di ogni parametro.

Questo articolo è incentrato sulle operazioni. Per altre informazioni sulle condizioni, vedere Condizioni delle attività di archiviazione.

Importante

Azioni di Archiviazione di Azure + attualmente in ANTEPRIMA ed è disponibile in queste aree. 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.

Formato operazione

Un'operazione ha un nome insieme a zero, uno o più parametri. L'immagine seguente mostra come questi elementi vengono visualizzati per un'operazione nel modello JSON di un'attività di archiviazione.

Diagramma che mostra il formato di un'operazione.

La tabella seguente descrive i singoli elementi.

Elemento Descrizione
name Nome dell'operazione.1
parameters Raccolta di uno o più parametri. Ogni parametro ha il nome del parametro e un valore di parametro.1
onSuccess Azione da eseguire quando l'operazione ha esito positivo per un oggetto . continue è l'unico valore consentito durante l'anteprima.
onFailure Azione da eseguire quando l'operazione non riesce per un oggetto . break è l'unico valore consentito durante l'anteprima.

1 Per un elenco completo dei nomi delle operazioni, dei parametri dell'operazione e dei valori dei parametri, vedere la sezione Operazioni supportate di questo articolo.

L'operazione seguente applica un criterio di immutabilità basato sul tempo all'oggetto .

{
    "operations": [
        {
            "name": "SetBlobImmutabilityPolicy",
            "parameters": {
                "untilDate": "2024-11-15T21:54:22",
                "mode": "locked"
            },
            "onSuccess": "continue",
            "onFailure": "break"
        }
    ]
}

Più operazioni

Separare più operazioni usando una virgola. L'immagine seguente mostra la posizione di due operazioni nell'elenco di operazioni.

Diagramma che mostra il formato di due operazioni.

Il codice JSON seguente mostra due operazioni separate da una virgola.

"operations": [
    {
        "name": "SetBlobImmutabilityPolicy",
        "parameters": {
            "untilDate": "2024-11-15T21:54:22",
            "mode": "locked"
        },
        "onSuccess": "continue",
        "onFailure": "break"
    },
    {
        "name": "SetBlobTags",
        "parameters": {
            "ImmutabilityUpdatedBy": "contosoStorageTask"
        },
        "onSuccess": "continue",
        "onFailure": "break"
    }
]

Operazioni supportate

La tabella seguente illustra le operazioni, i parametri e i valori dei parametri supportati:

Operazione Parametri Valori
SetBlobTier livello Caldo | Cool | Archivio
SetBlobExpiry expiryTime, expiryOption (expiryTime): numero di millisecondi
(expiryOption): Absolute | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob None None
UndeleteBlob None None
SetBlobTags Nometag 1 Valore del tag
SetBlobImmutabilityPolicy untilDate, modalità (untilDate): DateTime di quando termina il criterio

(modalità): bloccato | Sbloccato
SetBlobLegalHold legalHold true | falso

1 Il nome di questo parametro è il nome del tag.

Vedi anche