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

Como parte da criação ou modificação de um padrão de descoberta, você pode usar a operação de consulta REST na nuvem para extrair informações de itens de configuração (ICs) do tipo PaaS (plataforma como serviço), como Microsoft Azure ou Amazon Web Services.

Antes de Iniciar

• Verifique se o sistema operacional dos ICs para os quais você deseja usar a operação de Consulta REST na nuvem estende o tipo de SO de datacenter lógico [cmdb_ci_logical_datacenter]:
  1. Navegar até Designer de padrões > Padrões de descoberta.
  2. Clique duas vezes no padrão relevante para abri-lo no Designer de padrões.
  3. Clique na guia Básica.
  4. Observe o sistema operacional deste IC.
  5. Navegar até Definição do Sistema > Tabelas.
  6. Defina o campo de pesquisa como Rótulo e insira o nome do sistema operacional conforme indicado na guia Básica do padrão.
  7. Encontre o sistema operacional na lista e verifique se o Datacenter 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 ícone Adicionar uma etapa acima para adicionar uma etapa.

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

Função necessária: pd_admin

Por Que e Quando Desempenhar Esta Tarefa

Implante a operação de consulta REST na nuvem em padrões usados para descoberta de ICs de PaaS. Esta operação personalizada baseada em Java script está disponível somente após o download de padrões versão 1.0.24 ou posterior da ServiceNow Store. Use esta operação em vez da operação de Chamada REST em Nuvem disponível no sistema de base.

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 de consulta REST na nuvem. Por exemplo:

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

Procedimento

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

   Se você personalizou esta operaçã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ê também pode inserir um valor do campo específico em uma variável tabular.
   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 não mencionar especificamente o método de consulta HTTP, use o método GET.
   Corpo da mensagem	(Opcional) Insira um corpo de solicitação como uma cadeia de caracteres. Se a cadeia de caracteres contiver aspas, use a barra invertida antes das aspas para indicar que a cadeia de caracteres não termina entre aspas.
   Cabeçalhos	(Opcional) Se a documentação relevante da API determinar que os cabeçalhos HTTP devem ser enviados, insira-os no seguinte formato: Nome_do_cabeçalho1:valor_do_cabeçalho1,nome_do_cabeçalho2:valor_do_cabeçalho2 Por exemplo, Content-Type:xml.
   Formatado	JSON formatado ou não

3. Para salvar a saída do comando inteira como uma variável, selecione NONE na lista Definir análise e defina a variável.
4. Selecione a estratégia de análise na lista Definir Análise.
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 em Modo de Depuração, defina os critérios de análise da seguinte forma:
   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.

Exemplo

Esta operação é usada em	Este item
Hierarquia	Aplicação
Tipo de IC	Armazenamento de Objetos em Nuvem [cmdb_ci_cloud_object_storage]
Padrão	Amazon AWS S3
Seção	Identificação do AWS S3
Número e nome da etapa	3. Listar buckets

Use a operação de consulta REST na nuvem para extrair informações sobre buckets da AWS, seus nomes e datas de criação.