Configurar parâmetros de entrada do bloco de recursos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. 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 de 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 em Operações guia.

      Guia Operações para blocos de recursos

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

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

      As interfaces nesta lista de seleção são derivadas de Interface de Convidado de Recurso lista no Informações gerais guia que você já configurou quando criou 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 em Adicionar operação ícone.

        Adicionando 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 do catálogo quando um usuário gerencia uma pilha que ele 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 inicia 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 blueprints.

        Como exemplo, convém marcar Desprovisionar Operação como privada para uma VM individual, mas não para toda a pilha. Isso permite que o usuário desprovisione tudo de uma só vez e impede que o usuário 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, do parâmetro CloudAccount e do parâmetro Local 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 Operações da AWS permitidas em buckets E os elementos de solicitação para coisas como criar um bucket ( A operação COLOCAR Bucket ). Normalmente, você pode encontrar esses recursos na documentação da AWS e do Azure.

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

        adicionar parâmetros de entrada

      2. Adicione Nome Do parâmetro que você obteve da API do provedor de nuvem.
        Neste exemplo, você pode adicionar CreateBucket Configuration para um Bucket do AWS S3 .
      3. Em 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.
        • Pools : a consulta que você deseja executar em um pool para obter um valor de volta dele. O pool Valor da fonte de dados deve seguir esta convenção: ServiceNow::Pools::PoolName.Pool-Filter-Name . Consulte Pools e filtros para Cloud Provisioning para obter mais informações sobre pools.
        • CSVList valores de uma lista de valores separados por vírgulas que você insere em 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 Mapeamento campo:

          (Script:script-name.function[arg1]

        • 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. Em Mapeamento , você pode exibir os valores de mapeamento gerados automaticamente.
        Os mapeamentos especificam para onde extrair as informações no sistema. Você não precisa mudar os valores de mapeamento, exceto ResourceScript parâmetros de tipo, onde você deve inserir a expressão.
      6. Em 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 inseriu nada em Valor da fonte de dados .
      7. Selecione Criar formulário 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 forçar o usuário a inserir um valor.
      8. Em Restrito a , clique no ícone restrito ( restrito ae 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 por VmFolderName atributo). Outros tipos de datacenter não precisam do nome da pasta da VM. Portanto, você pode restringir VmFolderName Para o bloco de recursos do datacenter do vSphere.

        Esta imagem ilustra como o atributo VMFolderName é restrito ao Datacenter do vSphere.VMFolderName

        Restrição a um datacenter do vSphere