Partilhar 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. Este 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). Este artigo também lista as operações, parâmetros de operação e os valores permitidos de cada parâmetro.

Este artigo concentra-se nas operações. Para saber mais sobre condições, consulte Condições da tarefa de armazenamento.

Importante

As Ações de Armazenamento do Azure estão atualmente em PREVIEW e estão disponíveis nessas regiões. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Formato da operação

Uma operação tem um nome junto 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 Description
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 executada quando a operação for 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 falhar para um objeto. break é o único valor permitido durante a visualização.

1 Para obter uma lista completa de nomes de operação, parâmetros de operação e valores de parâmetros, consulte a seção Operações suportadas deste artigo.

A operação a seguir aplica uma política de imutabilidade baseada no 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 suportadas

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

Operação Parâmetros Valores
SetBlobTier escalão Quente | Legal | Arquivo
SetBlobExpiry expiryTime, expiryOption (expiryTime): Número de milissegundos
(expiryOption): Absoluto | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob Nenhuma Nenhuma
UndeleteBlob Nenhuma Nenhuma
SetBlobTags Nome da etiqueta1 Valor da tag
SetBlobImmutabilityPolicy untilDate, modo (untilDate): Data/hora de quando a política termina

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

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

Consulte também