Compartilhar via

Operações de tarefas de armazenamento

  • Artigo

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.

Importante

As Ações de Armazenamento do Azure estão atualmente em VERSÃO PRÉVIA e estão disponíveis nestas regiões. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

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.

Element 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. continue é o único valor permitido durante a visualização.
onFailure A ação a ser tomada quando a operação falha para um objeto. break é o único valor permitido durante a visualização.

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 Frequente | Esporádico | Arquivos
SetBlobExpiry expiryTime, expiryOption (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