Compartilhar via

Operações de tarefas de armazenamento

Uma tarefa de armazenamento contém um conjunto de condições e operações. Uma operação é uma ação que uma tarefa de armazenamento executa em cada objeto que atende aos requisitos de cada condição. Esse artigo descreve o formato JSON de uma operação de tarefa de armazenamento. Entender esse formato é importante se você planeja criar uma tarefa de armazenamento usando uma ferramenta diferente do portal do Azure (por exemplo: Azure PowerShell ou CLI do Azure). Esse artigo também lista as operações, os parâmetros de operação e os valores permitidos de cada parâmetro.

Esse artigo se concentra em operações. Para saber mais sobre as condições, veja Condições da tarefa de armazenamento.

Formato de operação

Uma operação tem um nome juntamente com zero, um ou vários parâmetros. A imagem a seguir mostra como esses elementos aparecem para uma operação no modelo JSON de uma tarefa de armazenamento.

Diagrama que mostra o formato de uma operação.

A tabela a seguir descreve cada elemento.

Elemento Descrição
name O nome da operação.1
parameters Uma coleção de um ou mais parâmetros. Cada parâmetro tem um nome de parâmetro e um valor de parâmetro.1
onSuccess A ação a ser tomada quando a operação é bem-sucedida para um objeto.
onFailure A ação a ser tomada quando a operação falha para um objeto.

1 Para obter uma lista completa de nomes de operações, parâmetros de operação e valores de parâmetros, veja a seção Operações com suporte desse artigo.

A operação a seguir aplica uma política de imutabilidade baseada em tempo ao objeto.

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

Operações múltiplas

Separe várias operações usando uma vírgula. A imagem a seguir mostra a posição de duas operações na lista de operações.

Diagrama que mostra o formato de duas operações.

O JSON a seguir mostra duas operações separadas por uma vírgula.

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

Operações com suporte

A tabela a seguir mostra as operações, parâmetros e valores de parâmetro com suporte:

Operação Parâmetros Valores
SetBlobTier nível Quente | Fresco | Frio | Arquivo
SetBlobExpiry expirayTime, expirayOption (expiryTime): Número de milissegundos
(expiryOption): Absoluto | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Nenhum Nenhum
UndeleteBlob Nenhum Nenhum
SetBlobTags Nome da marca1 Valor da marca
SetBlobImmutabilityPolicy untilDate, modo (untilDate): Data e hora de término da política

(mode): bloqueado | desbloqueado
SetBlobLegalHold legalHold verdadeiro | falso

1 O nome desse parâmetro é o nome da marca.

Confira também