AWS Descoberta de Gateway de API com padrões

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • . ServiceNow Descoberta e. Mapeamento de serviços As aplicações podem encontrar gateways de API da AWS e conexões com outras entidades. Descobrir alguns desses recursos requer a atualização do Padrões de descoberta e mapeamento de serviços aplicação do ServiceNow Store.

    Descoberta e. Mapeamento de serviços use Amazon AWS API Gatewaypadrão para executar a descoberta horizontal e de cima para baixo.

    Você pode usar esse padrão na plataforma ServiceNow usando a versão Kingston ou posterior.

    Solicitar aplicativos na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

    Pré-requisitos

    Conta de serviço da AWS com credenciais
    Em ServiceNow AI Platform®, configure a conta de serviço com o seguinte:
    • Um ID da conta , Que é o ID da conta da Amazon à qual o Gateway de API pertence. Use o ID da conta como ele aparece no Console de Gerenciamento AWS. Você pode executar a descoberta no formulário de conta de serviço.
    • As credenciais apropriadas da AWS necessárias para que o ID da conta alcance a nuvem da AWS.

    Consulte Contas de serviço para Descoberta e. Mapeamento de serviços na documentação do produto.

    Conjunto de atualizações
    Se sua instância estiver nas versões Jakarta ou Istanbul, importe o conjunto de atualizações fornecido em KB0679927 Conjunto de atualizações de descoberta de cima para baixo do AWS Lambda. Este conjunto de atualizações é necessário para Mapeamento de serviços.
    Acesso de usuário
    No Console da AWS, forneça a um usuário permissões para executar o. Apiggateway:GET Função apenas para a ação GET no Gateway de API.

    Verifique as permissões do REST API

    Baixe o. Descoberta na nuvem planilha de padrões para que você possa conceder as permissões de usuário necessárias para executar o. Descoberta padrões. Além das permissões, a planilha também inclui informações úteis, como nomes de padrões, tipos, classes de IC e links para a documentação do fornecedor. Novos padrões são disponibilizados trimestralmente; por isso, verifique periodicamente para ter certeza de que está usando a versão mais recente da planilha.

    Nota:
    Você pode testar AWS REST APIs usando Plataforma da API Postman. Para obter mais informações, consulte Como testar REST API da AWS usando o POSTMAN [KB0782183] artigo no Now Support Base de conhecimento.

    Dados coletados pelo Descoberta durante a descoberta horizontal

    Tabela e campo Informações adicionais
    Gateway em Nuvem [cmdb_ci_cloud_gateway]
    ID do objeto O ID do gateway.
    Descrição resumida A descrição resumida do gateway.
    Nome DNS [cmdb_ci_dns_name]
    Nome O nome exclusivo ou o endereço IP do host DNS.
    Endereço IP O endereço IP do host DNS.
    Endpoint do nome do recurso da AWS [cmdb_ci_endpoint_arn]
    Host O nome de host ou o endereço IP do endpoint.
    ARN O ID (nome do recurso da Amazon) de outras entidades da AWS às quais o gateway se conecta.

    Relacionamentos de item de configuração (IC)

    Esses relacionamentos são criados para oferecer suporte à descoberta do Gateway de API da AWS:
    IC Relacionamento IC
    Gateway de Nuvem

    [cmdb_ci_cloud_gateway]

    		 Uses:Used by Nome DNS

    [cmdb_ci_dns_name]
    Hosted on:Hosts Datacenter da AWS [cmdb_ci_aws_datacenter]

    O datacenter da AWS tem relacionamentos com outros ICs da AWS, como zonas de disponibilidade, contas de serviço e assim por diante. AWS e Azure Cloud Discovery na documentação do produto para obter detalhes adicionais.

    Conexões descobertas pelo Mapeamento de serviços durante a descoberta de cima para baixo

    Mapeamento de serviços Executa a descoberta de cima para baixo dos gateways de API da AWS no contexto dos serviços de aplicações. Ele descobre conexões de saída dos gateways de API da AWS:
    • AWS Lambda
    • Link do VPC para Virtual Private Cloud
    • Endpoint HTTP definido como o URL configurado no Gateway de API

    Solução de problemas

    Se o processo de mapeamento não prosseguir conforme o esperado, siga as sugestões a seguir.
    Sintoma Causa Solução
    A Descoberta falha. A mensagem de descoberta contém as informações sobre um erro causado pelo tempo limite de REST. Há muitos ICs enviando a resposta da chamada REST na implantação. O MID Server não pode processar a resposta da chamada REST sem exceder o limite de tempo controlado pelo parâmetro mid.sa.cloud.request_timeout. Por padrão, o parâmetro mid.sa.cloud.request_timeout é definido como 30000 milissegundos.
    Aumente o valor deste parâmetro no relevante MID Server e execute a descoberta novamente.
    Nota:
    Se a lista relacionada Parâmetros de configuração para o MID Server relevante não mostrar este parâmetro, talvez seja necessário adicioná-lo.
    O Designer de padrões falha durante uma sessão de depuração. A mensagem do Designer de padrões contém informações sobre um erro causado por um tempo limite. O Designer de padrões falha devido a um tempo limite durante a depuração de padrão (e não durante a descoberta). Por padrão, o parâmetro sa.debugger.max_timeout é definido como 240 segundos.

    Aumente o valor desse parâmetro no MID Server relevante.