Skip to main content
OnCommand Workflow Automation 5.1
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Como você mapeia parâmetros de comando

Colaboradores
PDFs

Os parâmetros nos comandos do Workflow Automation (WFA) são mapeados para atributos específicos e referências de entrada de dicionário com base em certas regras. Você deve estar ciente das regras para mapear parâmetros de comando ao criar ou editar um comando WFA.

O mapeamento de parâmetros de comando define como os detalhes do comando são definidos nos fluxos de trabalho. Os parâmetros de comando mapeados de um comando são exibidos em abas quando você está especificando os detalhes do comando para comandos em fluxos de trabalho. As guias são nomeadas com base no nome do grupo especificado na coluna Nome do objeto da guia Mapeamento de parâmetros. Os parâmetros que não são mapeados são exibidos na guia outros parâmetros quando você está especificando os detalhes do comando em fluxos de trabalho.

As regras para mapeamento de parâmetros de comando são aplicáveis com base na categoria de comando e como os comandos são representados no editor de fluxo de trabalho.

A seguir estão as categorias de comando:

  • Comandos que criam objetos

  • Comandos que atualizam objetos

  • Comandos que removem objetos

  • Comandos que lidam com objetos pai e filho opcionais

  • Comandos que atualizam associações entre objetos

As regras estão listadas abaixo para cada categoria:

Todas as categorias de comandos

Ao mapear um parâmetro de comando, você deve usar o caminho natural com base em como o comando é usado em fluxos de trabalho.

Os exemplos a seguir mostram como você pode definir um caminho natural:

  • Para o ArrayIP parâmetro, dependendo do comando, você deve usar o aggregate.array.ip atributo da Volume entrada do dicionário e não o array.ip atributo.

    Isso é importante quando um fluxo de trabalho cria um volume e, em seguida, executa uma etapa adicional com o volume criado consultando-o. Os seguintes exemplos são semelhantes:

    • volume.aggregate.array.ip da Qtree entrada do dicionário

    • volume.aggregate.array.ip da LUN entrada do dicionário

  • Para Cluster os comandos usados em, você deve usar um dos seguintes:

    • vserver.cluster.primary_address da Volume entrada do dicionário

    • volume.vserver.cluster.primary_address da Qtree entrada do dicionário

Comandos que criam objetos

Esta categoria de comandos é usada para um dos seguintes:

  • Encontrando um objeto pai e definindo novos objetos

  • Procurar um objeto e criar o objeto se o objeto não existir

Você deve usar as seguintes regras de mapeamento de parâmetros para esta categoria de comandos:

  • Mapeie os parâmetros relevantes do objeto que é criado para a entrada do dicionário do objeto.

  • Mapeie o objeto pai através das referências da entrada do dicionário criada.

  • Certifique-se de que o atributo relevante esteja presente na entrada do dicionário ao adicionar um novo parâmetro.

    A seguir estão os cenários de exceção para esta regra:

    • Alguns objetos que são criados não têm uma entrada de dicionário correspondente e apenas o objeto pai é mapeado para a entrada relevante do dicionário pai - por exemplo, o comando Create VIF - no qual apenas uma matriz pode ser mapeada para a entrada do dicionário de matriz.

    • O mapeamento de parâmetros não é necessário

      Por exemplo, o ExecutionTimeout parâmetro no comando criar ou redimensionar agregado é um parâmetro não mapeado.

Os seguintes comandos certificados são exemplos para esta categoria:

  • Criar volume

  • Criar LUN

Comandos que atualizam objetos

Esta categoria de comandos é usada para encontrar um objeto e atualizar os atributos.

Você deve usar as seguintes regras de mapeamento de parâmetros para esta categoria de comandos:

  • Mapeie os objetos que são atualizados para a entrada do dicionário.

  • Não mapeie os parâmetros que são atualizados para o objeto.

    Por exemplo, no comando Set volume State, o Volume parâmetro é mapeado, mas o novo não é mapeado State.

Comandos que removem objetos

Esta categoria de comandos é usada para encontrar um objeto e excluí-lo.

Você deve mapear o objeto que é excluído pelo comando para sua entrada de dicionário. Por exemplo, no comando Remover volume, o Volume a ser excluído é mapeado para os atributos e referências relevantes da Volume entrada do dicionário.

Comandos que lidam com objetos pai e filho opcionais

Você deve usar as seguintes regras de mapeamento de parâmetros para esta categoria de comandos:

  • Não mapeie qualquer parâmetro obrigatório de um comando como referência a partir de um parâmetro opcional do comando.

    Essa regra é mais relevante quando um comando lida com objetos filho opcionais de um objeto pai específico. Nesse caso, o objeto filho e pai devem ser mapeados explicitamente. Por exemplo, no comando Stop Deduplication jobs, o comando pára uma tarefa de deduplicação em execução em um volume específico quando especificado junto Array com ou em todos os volumes do dado Array. Neste caso, o parâmetro array deve ser mapeado diretamente para a array entrada do dicionário e não para Volume.Array porque Volume é um parâmetro opcional neste comando.

  • Se existir uma relação pai e filho entre entradas de dicionário no nível lógico, mas não entre as instâncias reais em um comando específico, esses objetos devem ser mapeados separadamente.

    Por exemplo, no comando mover volume, Volume é movido de seu agregado pai atual para um novo agregado de destino. Portanto, Volume os parâmetros são mapeados para uma Volume entrada de dicionário e os parâmetros agregados de destino são mapeados separadamente para a Aggregate entrada do dicionário, mas não como volume.aggregate.name.

Comandos que atualizam associações entre objetos

Para esta categoria de comandos, você deve mapear tanto a associação quanto os objetos para entradas relevantes do dicionário. Por exemplo, no Add Volume to vFiler comando, os Volume parâmetros e vFiler são mapeados para os atributos relevantes das Volume entradas do dicionário e. vFiler