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.

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 .
onFailure Azione da eseguire quando l'operazione non riesce per un oggetto .

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 tempo di scadenza, opzione di scadenza (expiryTime): numero di millisecondi
(expiryOption): Assoluto | MaiScade | RelativoAllaCreazione | RelativoAdOra
EliminaBlob Nessuno Nessuno
UndeleteBlob Nessuno Nessuno
SetBlobTags Nometag 1 Valore del tag
SetBlobImmutabilityPolicy (Imposta la politica di immutabilità del blob) 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