Configurar parâmetros de entrada do bloco de recursos

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura

    • Você pode configurar operações para cada interface de um bloco de recursos especificando parâmetros de entrada, etapas e atributos de saída. Os parâmetros de entrada contêm valores que o sistema requer para identificar e gerenciar um recurso virtual, como o datacenter e o grupo de recursos em que o recurso está.

    Antes de Iniciar

    Função necessária: sn_cmp.cloud_service_designer

    Por Que e Quando Desempenhar Esta Tarefa

    O sistema associa automaticamente as operações padrão da API da nuvem (CAPI) ao bloco de recursos quando você adiciona interfaces a ele. Ele também fornece parâmetros de entrada padrão para cada operação.

    Procedimento

    1. Abra um bloco de recursos e clique na guia Operações.

      Guia Operações para blocos de recursos

      A subguia Parâmetros de entrada aparece por padrão.

    2. Selecione a interface na lista de seleção Interface.

      As interfaces nesta lista de seleção são derivadas da lista Interface de Convidado de Recursos na guia Informações Gerais que você já configurou ao criar um bloco de recursos.

      Seleção de uma interface de bloco de recursos

    3. Selecione a operação na qual você deseja modificar os parâmetros de entrada.
      Você também pode criar uma nova operação.
      1. Clique no ícone Adicionar operação.

        Como adicionar uma operação

      2. Preencha o formulário (ver tabela):
        Campo Descrição
        Nome Insira um nome descritivo.
        Tipo de operação Selecione o tipo de operação na lista de seleção.
        Tipo de acesso

        Selecione Público para disponibilizar a operação de bloco de recursos no formulário de pedido de catálogo quando um usuário gerencia uma pilha que possui. As operações reais aparecem em uma lista no formulário de pedido do catálogo:

        Operações para o usuário

        Selecione Privado para impedir que a operação seja usada quando um usuário iniciar uma pilha.

        Esta configuração se aplica ao nível do item do catálogo, não ao nível da pilha inteira. Você pode controlar o tipo de acesso em toda a pilha ao configurar planos gráficos.

        Por exemplo, você pode marcar a operação de desprovisionamento como privada para uma VM individual, mas não para a pilha inteira. Isso permite que o usuário desprovisione tudo de uma vez e evita que ele apenas desprovisione a VM.
      3. Clique em Enviar.
    4. Configure os parâmetros de entrada para fornecer uma maneira de inserir os itens necessários para executar a operação selecionada.

      Por exemplo, se você adicionar uma operação de provisionamento para um recurso da AWS, precisará, no mínimo, dos parâmetros CloudAccount e Location para executar a operação. Você precisa conhecer a API dos provedores para saber o que passar para ela. Por exemplo, se você quiser adicionar uma operação de provisionamento para um bucket do S3 na AWS, precisará conhecer as operações permitidas da AWS em buckets e os elementos de solicitação para coisas como criar um bucket (a operação PUT Bucket). Normalmente, você pode encontrar esses recursos na documentação da AWS e do Azure.

      1. Clique no ícone Adicionar parâmetros de entrada.

        adicionar parâmetros de entrada

      2. Adicione o Nome do parâmetro que você obteve da API do provedor de nuvem.
        Neste exemplo, você pode adicionar CreateBucketConfiguration para um bucket S3 da AWS.
      3. Na coluna Fonte de dados, selecione o tipo de parâmetro de entrada que você está configurando.
        Este valor especifica a origem ou o local de onde o valor do parâmetro vem:
        • Texto: um valor de texto que o usuário passa.
        • Grupos: a consulta que você deseja executar em um grupo para obter um valor dele. O valor da fonte de dados do pool deve seguir esta convenção: ServiceNow::Pools::PoolName.Pool-Filter-Name. Consulte Pools e filtros para Cloud Provisioning para obter mais informações sobre grupos.
        • CSVList: valores de uma lista de valores separados por vírgula que você insere no valor da fonte de dados.
        • Matriz: uma matriz de valores. Você pode enviar programaticamente uma matriz em JavaScript. O formato é o seguinte: ['abc','def'].
        • FormData: dados enviados do formulário configurado no plano gráfico.
        • ResourceScript: uma expressão que passa um valor. A expressão deve seguir esta convenção no campo Mapeamento :

          $(Script:script-name.function[arg1=${value-to-pass},arg2=${value-to-pass}])

        • TLR: o valor herdado do contêiner de recursos de nível superior acima deste bloco de recursos no plano gráfico.
      4. Clique em Salvar.
      5. Na coluna Mapeamento, você pode exibir os valores de mapeamento gerados automaticamente.
        Os mapeamentos especificam onde extrair as informações no sistema. Você não precisa alterar os valores de mapeamento, exceto para parâmetros de tipo ResourceScript, em que você deve inserir a expressão.
      6. Na coluna Valor padrão, especifique um valor que você deseja que o sistema use se o usuário não passar nenhum valor ou se você não tiver inserido nada no Valor da fonte de dados.
      7. Selecione Criar formulário para disponibilizar este atributo no formulário de pedido que o usuário vê ao tentar provisionar o item de pilha.
        Você também pode selecionar Obrigatório para forçar o usuário a inserir um valor.
      8. Na coluna Restrito a, clique no ícone restrito ( restrito a) e selecione um bloco de recursos para restringir o atributo a ser passado para um host específico.

        Neste exemplo, você está configurando um bloco de recursos para um servidor virtual no vSphere, que requer o nome da pasta da VM (representada pelo atributo VmFolderName ). Outros tipos de datacenter não precisam do nome da pasta da VM. Portanto, você pode restringir VmFolderName ao bloco de recursos do datacenter do vSphere.

        Esta imagem ilustra como o atributo VMFolderName está restrito ao vSphere Datacenter.VMFolderName

        Restrição a um datacenter do vSphere