Definir uma consulta de API para dispositivos de computação em nuvem

Como parte da criação ou modificação de um padrão de descoberta, é possível usar a operação Cloud REST Call para extrair informações de itens de configuração do tipo PaaS (Platform as a Service), como Microsoft Azure ou Amazon Web Services.

Antes de Iniciar

Função necessária: pd_admin

• Verifique se o sistema operacional do item de configuração (IC) para o qual você deseja usar a operação de Chamada REST em nuvem estende o tipo de SO de datacenter lógico [cmdb_ci_logical_datacenter]:
  1. Navegue até a guia Básico do padrão de IC.
  2. Observe o sistema operacional para este IC.
  3. Navegar até Definição do Sistema > Tabelas.
  4. Defina o campo de pesquisa como Rótulo e insira o nome do sistema operacional conforme declarado na guia Básico do padrão.
  5. Encontre o sistema operacional na lista e verifique se o Centro de dados lógico aparece na coluna da tabela Estende.
• Navegue até a etapa do padrão relevante:
  1. No formulário padrão, selecione a seção de identificação relevante para Descoberta.

     Como alternativa, selecione a identificação relevante ou a seção de conexão para Mapeamento de serviços.

  2. Selecione a etapa de padrão relevante ou clique no botão para adicionar uma etapa.

Conhecimento básico de programação é desejável.

Por Que e Quando Desempenhar Esta Tarefa

Implante a operação de Chamada REST em nuvem em padrões usados para descoberta de ICs de PaaS.

Consulte a documentação oficial relacionada à API fornecida pelos fabricantes para obter a sintaxe de consulta do dispositivo que você deseja consultar usando a operação Cloud REST Call. Por exemplo:

• http://docs.aws.amazon.com/AWSEC2/latest/APIReference/Welcome.html
• https://docs.microsoft.com/en-us/rest/api/apimanagement/

Procedimento

1. Selecione Chamada REST em nuvem na lista Operação.
2. Defina os parâmetros de consulta conforme necessário:
   Aviso:

   Se você personalizou esta operação conforme descrito em Personalizar operações padrão, os parâmetros de consulta podem ser diferentes.

   Campo	Descrição
   URL	Especifique o URL conforme descrito na documentação oficial do Microsoft Azure ou do Amazon Web Services. Você pode usar variáveis. Você pode usar variáveis. Você também pode inserir um valor do campo específico em uma variável tabular, conforme descrito em Insira valores e variáveis em padrões.
   Método	Insira o valor do método como uma cadeia de caracteres usando todas as letras maiúsculas, por exemplo, "GET". Os métodos compatíveis são: GET POST PUT Consulte o guia de API relevante para obter informações. Se a documentação da API mencionar especificamente o método de consulta HTTP, use o método GET.
   Corpo	(Opcional) Insira um corpo de solicitação como uma cadeia de caracteres. Se a cadeia de caracteres contiver aspas, use a barra invertida na frente das aspas para indicar que a cadeia de caracteres não termina entre aspas.
   Cabeçalhos	(Opcional) Se a documentação relevante da API declarar que os cabeçalhos HTTP devem ser enviados, insira esses cabeçalhos no seguinte formato: Cabeçalho_name1: cabeçalho_valor1, cabeçalho_nome2: cabeçalho_valor2 Por exemplo, Content-Type:xml.

3. Para salvar a saída do comando integralmente como uma variável, selecione NENHUM na lista Definir análise e defina a variável conforme descrito em 6.
4. Selecione a estratégia de análise na lista Definir Análise.

   Estratégia de análise	Descrição
   Oracle Arquivo LDAP Arquivo XML Arquivo INI Arquivo de propriedades Arquivo JSON (personalizado)	Estratégia de análise de arquivo horizontal (não vertical). Você pode usar esta estratégia de análise somente para arquivos de texto. Para obter mais informações, consulte Analisar texto de um arquivo horizontal.
   Arquivo vertical	Recupere o texto de um arquivo de texto estruturado em que cada conjunto de dados se estende por várias linhas. Para obter mais informações, consulte Como analisar texto de um arquivo vertical.
   Após a palavra-chave	Recupere o texto diretamente após uma palavra-chave específica. Para obter mais informações, consulte Analisar texto usando palavra-chave, comando e tipo de posição.
   Estilo Java de linha de comando	Recupere o valor de um parâmetro de linha de comando usando parâmetros de estilo Java. Para obter mais informações, consulte Analisar texto usando palavra-chave, comando e tipo de posição.
   Estilo Unix de linha de comando	Recupere o valor de um parâmetro de linha de comando usando parâmetros Unix padrão. Para obter mais informações, consulte Analisar texto usando palavra-chave, comando e tipo de posição.
   Posição final	Recupera o texto especificado por sua posição no final da linha. Para obter mais informações, consulte Analisar texto usando palavra-chave, comando e tipo de posição.
   Posição do início	Recupera o texto especificado por sua posição no início da linha. Para obter mais informações, consulte Analisar texto usando palavra-chave, comando e tipo de posição.
   Expressão regular	Recupere o texto especificado por uma expressão regular. Esta opção requer familiaridade com a sintaxe Regex Java. Para obter mais informações, consulte Analisar texto usando uma expressão regular.
   Texto delimitado	Recupere texto especificado por delimitadores e posição dentro da linha (a maneira mais comum de recuperar texto de arquivos de texto genéricos). Consulte Analisar texto usando texto delimitado.

5. Se estiver trabalhando no Modo de Depuração, defina os critérios de análise da seguinte forma:
   1. Clique em Executar operação para ver o resultado no painel Saída.
   2. No painel Saída, marque o texto ou os símbolos que você deseja que uma variável contenha.
   3. Na caixa de nome da variável, insira o nome da nova variável, por exemplo, 'process_name'.
      
      
      
   4. Pressione Enter.
      A nova variável é adicionada ao painel Variáveis.
6. Se não estiver trabalhando no Modo de depuração, siga estas etapas para definir os critérios de análise.
   1. No painel Variáveis, clique em Adicionar Variável e insira o nome da nova variável.
   2. Clique no ícone Avançado.
      
      
      
   3. Clique em Adicionar rótulo de coluna.
   4. Insira a consulta de análise.
   5. Insira um valor para o delimitador.
   6. Insira um valor para a posição.
7. Selecione Encerrar para parar a descoberta se nenhum resultado for encontrado.
8. Se estiver no modo de depuração, teste a etapa clicando em Testar e verificando se a operação apresenta o resultado esperado.

Exemplo

Esta operação é usada em	Este item
Hierarquia	Aplicação
Tipo de IC	Serviço de balanceador de carga [cmdb_ci_lb_service]
Padrão	Serviço de balanceador de carga do Amazon AWS Elastic
Seção	Serviço de balanceador de carga da AWS
Número e nome da etapa	2. Obtenha as primeiras 100 instâncias RDS

Use a operação Chamada REST em nuvem para extrair informações sobre instâncias de banco de dados em execução na região us-west-2 na nuvem da Amazon.

O que Fazer Depois

• Continue editando o padrão adicionando uma nova etapa e definindo sua operação.
• Finalize o padrão.

Tarefas relacionadas

• Ativar modo de Depuração de padrão
• Tornar uma etapa condicional

Referência relacionada

• Insira valores e variáveis em padrões
• Variáveis padrão