Defina 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 Consulta REST na nuvem Operação 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 lógico do datacenter [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 em Básico guia.
  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 em Básico do padrão.
  7. Encontre o sistema operacional na lista e verifique se o Datacenter lógico aparece no Estende a tabela coluna.

• 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 em Adicione uma etapa acima ícone 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 Consulta REST na nuvem em padrões usados para descoberta de ICs 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 Chamada REST na 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 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 em Operação lista.
2. Defina 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 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 na frente das aspas para indicar que a cadeia de caracteres não termina entre aspas.
   Cabeçalhos	(Opcional) Se a documentação da API relevante declarar que os cabeçalhos HTTP devem ser enviados, insira esses cabeçalhos no seguinte formato: Header_name1:header_value1,header_name2:header_value2 Por exemplo, Content-Type: xml .
   Formatado	JSON formatado ou não

3. Para salvar a saída do comando em sua totalidade como uma variável, selecione NENHUM em Definir Análise liste 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 em Saída painel.
   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	Buckets de lista 3

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