Partilhar via


Definir condições e operações de tarefas de armazenamento

Você pode usar um editor visual para definir as condições e operações de uma 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.

Uma operação é uma ação executada em cada objeto que atende às condições definidas na tarefa. Uma condição contém uma ou mais cláusulas condicionais. Cada cláusula define a relação entre uma propriedade e um valor. Para executar uma operação definida na tarefa de armazenamento, os termos dessa relação devem ser atendidos por cada objeto.

Para saber mais, consulte Propriedades, operadores e operações em condições de tarefas de armazenamento.

Abra o editor de condições

Navegue até a tarefa de armazenamento no portal do Azure e, em Gerenciamento de tarefas de armazenamento, selecione Condições.

Screenshot of the Conditions button and the Conditions editor.

A guia Construtor visual do painel Condições é exibida.

Definir condições

Defina uma condição adicionando cláusulas. Uma cláusula define a relação entre uma propriedade e um valor. Para executar uma operação definida na tarefa de armazenamento, os termos dessa relação devem ser atendidos por cada objeto.

Adicionar e remover cláusulas

Para adicionar uma cláusula, selecione Adicionar nova cláusula e, para remover uma cláusula, selecione o ícone de exclusão( ) que aparece ao lado dela.

Screenshot of the Add new clause button and three clauses that were added to the list of clauses.

Especificar os termos de uma cláusula

Para definir uma cláusula, escolha uma propriedade, especifique um valor para essa propriedade e, em seguida, escolha um operador que as relacione.

Escolha um imóvel

Na lista suspensa Propriedade Blob, escolha uma propriedade. Consulte Propriedades de blob suportadas.

O exemplo a seguir seleciona a propriedade Blob name .

Screenshot of the property drop-down list of a clause.

Escolha um valor e um operador

Na caixa Valor da propriedade , insira um valor e, na lista suspensa Operador , escolha um operador. Consulte Operadores suportados.

O exemplo a seguir especifica um valor de .log junto com o operador Ends with . Essa condição permite que a operação definida nesta tarefa de armazenamento seja executada somente em blobs que tenham uma .log extensão de arquivo.

Screenshot of an example condition in the visual editor.

Usar um curinga em valores de cadeia de caracteres

Você pode usar os caracteres curinga * e ? no valor de uma propriedade string. O * caractere representa zero ou mais caracteres, enquanto um caractere representa exatamente um ? caractere.

Por exemplo, se você quiser que sua cláusula seja avaliada como true somente para blobs que são documentos do Word, use a cadeia de caracteres *.docx. No entanto, se você quiser que apenas os documentos sejam nomeados com um único caractere, como 1.docx ou 2.docx, use a cadeia de caracteres ?.docx.

Você pode usar o * ou ? em qualquer lugar em uma cadeia de caracteres. Você pode escapar desses caracteres adicionando um \ pouco antes do personagem.

Fazer referência a um valor de metadados de objeto

As cláusulas que incluem uma propriedade de data e hora podem fazer referência a um valor dos metadados de um contêiner ou a uma marca de índice de um blob. Esses valores são obtidos dinamicamente no tempo de execução quando a tarefa é executada.

Na sua conta de armazenamento, você pode adicionar uma chave aos metadados de um contêiner ou às tags de índice de um blob. O valor dessa chave deve ser um intervalo de tempo formatado pela ISO 8601. Por exemplo, você pode adicionar uma chave nomeada retainfor junto com um valor de cadeia de caracteres que representa um intervalo de PT5M cinco minutos.

Para fazer referência a uma chave, selecione o link Editar que aparece na coluna Valor da propriedade . Em seguida, na caixa de diálogo Selecionar um valor , selecione Metadados de contêiner ou tags de índice de Blob.

O exemplo a seguir adiciona a propriedade Creation time, o operador Earlier than e faz referência a uma chave nomeada retainFor nas marcas de índice de cada blob avaliado.

Screenshot of specifying a key in container metadata as part of the condition definition.

Esta condição testa se um blob foi criado antes de uma determinada duração de tempo em relação a agora (a data e hora atuais). Por exemplo, se o retainFor valor recuperado da tag for de cinco minutos, essa condição verificará se o blob foi criado há mais de 5 minutos.

Nota

Na guia Código, você verá a lógica deste exemplo representada de uma maneira ligeiramente diferente. O código gerado testa se o tempo atual é maior do que o tempo de criação mais o intervalo de tempo. Ambas as representações produzem o mesmo resultado.

Se a chave não estiver presente para um objeto avaliado, a condição será avaliada como false. Se o valor da chave for uma cadeia de caracteres que não esteja em conformidade com a norma ISO 8601 , um erro será relatado no relatório de execução.

Aplicar e/ou a uma cláusula

Você adiciona And ou Or a uma cláusula. Especifique E se você deseja direcionar objetos que atendem aos critérios da cláusula atual e da cláusula anterior da condição. Especifique Or para objetos de destino que atendam ao critério na cláusula atual ou na cláusula anterior.

O exemplo a seguir mostra cláusulas que usam And. Neste exemplo, a tarefa de armazenamento destina-se a objetos que têm uma extensão e que têm uma .log marca chamada Archive-Status definida como Ready.

Screenshot of clauses that use the AND operators.

Alterar a ordem das cláusulas

Você pode organizar cláusulas em uma ordem que você acredita que melhorará o desempenho de uma execução de tarefa. Por exemplo, em vez de testar primeiro todos os blobs de uma conta em relação a um filtro de nome, você pode elevar uma cláusula direcionada a um contêiner específico. Esse pequeno ajuste pode evitar que a tarefa realize avaliações desnecessárias.

Primeiro, selecione a cláusula. Em seguida, selecione Mover cláusula para cima ou Mover cláusula para baixo para alterar sua posição na lista.

O exemplo a seguir mostra o resultado da seleção de uma cláusula e, em seguida, da seleção de Mover cláusula para cima.

Screenshot of clause appearing in a new position in the list.

Cláusulas de grupo e de desagrupamento

As cláusulas agrupadas funcionam como uma unidade única, separada das restantes cláusulas. Agrupar cláusulas é semelhante a colocar parênteses em torno de uma equação matemática ou expressão lógica. O operador And ou Or para a primeira cláusula do grupo aplica-se a todo o grupo.

Marque a caixa de seleção que aparece ao lado de cada cláusula que você deseja agrupar. Em seguida, selecione Grupo.

O exemplo a seguir mostra duas condições agrupadas. Neste exemplo, a operação é executada se um blob tiver a .log extensão e uma tag nomeada Archive-Status for definida como o valor de ou o arquivo não tiver sido acessado Ready em 120 dias.

Screenshot of clauses grouped together.

Para desagrupar cláusulas, selecione o ícone desagrupar ( ) ou selecione cada cláusula no grupo e selecione Desagrupar.

Visualizar o efeito das condições

Você pode exibir uma lista de blobs que seriam afetados pelas condições que você definiu. No editor de condições, selecione Visualizar condições.

Screenshot of the Preview Conditions button.

Nas Condições de visualização, você pode especificar uma assinatura de destino, uma conta de armazenamento e um contêiner. Como uma visualização só pode mostrar até 5000 blobs, você também pode especificar um prefixo para restringir a lista.

Screenshot of the Preview Conditions page.

Definir operações

Uma operação é uma ação executada em cada objeto que atende às condições definidas na tarefa.

Adicionar e remover operações

Para adicionar uma operação, selecione Adicionar nova operação e, para remover uma operação, selecione o ícone de exclusão( ) que aparece ao lado dela.

Screenshot of the Add new operation button and three operations that were added to the list of operations.

Escolher uma operação

Na lista suspensa Operação, escolha uma operação. Consulte Operações suportadas.

O exemplo a seguir seleciona a propriedade set blob tags .

Screenshot of the Operation drop-down list of an operation.

Escolha um parâmetro

Insira ou selecione os parâmetros apropriados para a operação.

O exemplo a seguir define a Archive-Status tag como o valor Archived.

Screenshot of an example condition.

Alterar a ordem das operações

Você pode organizar as operações em qualquer ordem.

Neste exemplo, a ordem existente faz sentido. Os blobs são arquivados primeiro e as tags são definidas. Não faria sentido definir a tag antes de alterar a camada apenas no caso de a tentativa de alterar a camada de um blob não ter sucesso. Se a operação set blob tag apareceu primeiro na lista, você pode considerar mover essa operação abaixo da operação set blob tier.

Para mover uma operação, marque a caixa de seleção que aparece ao lado dela. Em seguida, selecione Mover operação para cima ou Mover operação para baixo para alterar sua posição na lista.

Consulte também