AWS API 게이트웨이 검색

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 3분

    • ServiceNow 검색 및 서비스 매핑 애플리케이션은 AWS API 게이트웨이와 다른 개체에 대한 연결을 찾을 수 있습니다. 이러한 자원을 검색하려면 ServiceNow Store에서 검색 및 서비스 매핑 패턴 애플리케이션을 업데이트해야 합니다.

    검색와 서비스 매핑은 Amazon AWS API Gateway 패턴을 사용하여 수평 및 하향식 검색을 실행합니다.

    Kingston 릴리스 이상을 사용하는 ServiceNow 플랫폼에서 이 패턴을 사용할 수 있습니다.

    스토어에서 앱 요청

    ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

    필요 조건

    자격 증명이 포함된 AWS 서비스 계정
    Now Platform®에서 다음으로 서비스 계정을 설정합니다.
    • 계정 ID - API 게이트웨이가 속한 Amazon 계정 ID입니다. 계정 ID를 AWS 관리 콘솔에 표시되는 대로 사용합니다. 서비스 계정 양식에서 검색을 실행할 수 있습니다.
    • 계정 ID가 AWS 클라우드에 도달하는 데 필요한 적절한 AWS 자격 증명.

    제품 설명서에서 검색 및 서비스 매핑의 서비스 계정을 참조하십시오.

    업데이트 세트
    인스턴스가 Jakarta 또는 Istanbul 버전에 있는 경우 KB0679927: AWS Lambda 하향식 검색 업데이트 세트에서 제공하는 업데이트 세트를 임포트하십시오. 이 업데이트 세트는 서비스 매핑에 필요합니다.
    사용자 접근
    AWS 콘솔에서 API 게이트웨이의 GET 작업에 대해서만 apigateway:GET 함수를 실행할 수 있는 권한을 사용자에게 제공하십시오.

    가로 검색 중 검색에서 수집하는 데이터

    테이블 및 필드 추가 정보
    클라우드 게이트웨이 [cmdb_ci_cloud_gateway]
    객체 ID 게이트웨이의 ID입니다.
    짧은 설명 게이트웨이에 대한 간단한 설명입니다.
    DNS 이름 [cmdb_ci_dns_name]
    이름 DNS 호스트의 고유 이름 또는 IP 주소입니다.
    IP 주소 DNS 호스트의 IP 주소입니다.
    AWS 자원 이름 엔드포인트 [cmdb_ci_endpoint_arn]
    호스트 엔드포인트의 호스트 이름 또는 IP 주소입니다.
    ARN 게이트웨이가 연결하는 다른 AWS 개체의 ID(Amazon 자원 이름)입니다.

    CI(구성 항목) 관계

    이러한 관계는 AWS API 게이트웨이 검색을 지원하기 위해 생성됩니다.
    CI 관계 CI
    클라우드 게이트웨이

    [cmdb_ci_cloud_gateway]

    		 Uses:Used by DNS 이름

    [cmdb_ci_dns_name]
    Hosted on:Hosts AWS 데이터센터 [cmdb_ci_aws_datacenter]

    AWS 데이터센터는 가용 영역, 서비스 계정 등의 다른 AWS CI와 관계가 있습니다. 자세한 내용은 제품 문서에서 AWS 및 Azure 클라우드 검색을 참조하십시오.

    하향식 검색 중 서비스 매핑에서 검색하는 연결

    서비스 매핑은 애플리케이션 서비스의 컨텍스트에서 AWS API 게이트웨이의 하향식 검색을 수행합니다. AWS API 게이트웨이의 나가는 연결을 검색합니다.
    • AWS Lambda
    • 가상 사설 클라우드에 대한 VPC 링크
    • API 게이트웨이에 구성된 URL로 정의된 HTTP 엔드포인트

    문제 해결

    매핑 프로세스가 예상대로 진행되지 않으면 다음 제안을 따릅니다.
    증상 원인 솔루션
    검색에 실패했습니다. 검색 메시지에는 REST 시간 제한으로 인해 발생한 오류 정보가 포함되어 있습니다. 배포에는 REST 호출 응답을 보내는 CI가 많습니다. MID 서버에서는 mid.sa.cloud.request_timeout 매개변수로 제어되는 시간 제한을 초과하지 않고 REST 호출 응답을 처리할 수 없습니다. 기본적으로 mid.sa.cloud.request_timeout 매개변수는 3만 밀리초로 설정되어 있습니다.
    관련 MID 서버에 대한 이 매개변수의 값을 늘리고 검색을 다시 실행합니다.
    주:
    관련 MID 서버의 구성 매개변수 관련 목록에 이 매개변수가 표시되지 않으면 추가해야 할 수 있습니다.
    세션 디버그 중에 패턴 디자이너가 실패합니다. 패턴 디자이너 메시지에는 시간 제한으로 인해 발생한 오류 정보가 포함되어 있습니다. 패턴 디버깅 중(검색 중 아님) 시간 초과로 인해 패턴 디자이너가 실패합니다. 기본적으로 sa.debugger.max_timeout 매개변수는 240초로 설정되어 있습니다.

    관련 MID 서버에 대한 이 매개변수의 값을 늘립니다.