Definir uma consulta REST em 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 Cloud REST Query para extrair informações de itens de configuração (ICs) do tipo PaaS (Platform as a Service), 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 em nuvem estende o tipo de sistema operacional 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ásico.
  4. Observe o sistema operacional para este 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 declarado na guia Básico do padrão.
  7. 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 do 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 em 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 em 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 em 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	(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.
   Formatado	JSON formatado ou não

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.
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	Cloud Object Storage [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 Cloud REST Query para extrair informações sobre buckets do AWS, seus nomes e datas de criação.