일치하지 않는 API 확장 클래스

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • CMDB CI 클래스 모델 앱이 일치하지 않는 API에 대한 클래스를 추가하거나 업데이트합니다. API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component] 클래스를 채울 만큼 구조화되지 않은 API 엔드포인트는 대신 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 클래스를 채웁니다. 일치하지 않는 API는 일반적으로 보안 스캐너 또는 관찰 가능성 도구와 같은 통합에서 사용됩니다.

    CMDB CI 클래스 모델 는 클래스 계층 구조를 확장하는 클래스 모델을 추가하는 앱입니다 ServiceNow StoreCMDB . 새 클래스나 업데이트된 클래스에는 클래스 설명, 식별 규칙, 식별자 항목 및 종속 관계(해당하는 경우)가 포함됩니다. 추가된 클래스는 다른 CMDB 클래스와 마찬가지로 사용할 수 있습니다. 같은 디스커버리 및 서비스 매핑 패턴 애플리케이션은 클래스 확장을 사용하여 CI를 채우고 기술 및 소프트웨어를 검색할 수 있습니다.

    모든 에 대한 전체 릴리스 정보를 CMDB CI 클래스 모델참조하십시오.

    스토어에서 앱 요청

    사용 가능한 모든 앱을 보고 스토어에 요청을 제출하는 방법에 대한 자세한 내용을 보려면 다음을 ServiceNow Store 방문하십시오. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

    일치하지 않는 API

    API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component] 클래스를 채울 만큼 구조화되지 않은 API 엔드포인트는 대신 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 클래스를 채웁니다. 일치하지 않는 API는 일반적으로 보안 스캐너 또는 관찰 가능성 도구와 같은 통합에서 사용됩니다.

    클래스

    이 섹션에는 앱이 추가하거나 업데이트하는 CMDB CI 클래스 모델 클래스가 나열됩니다.

    CMDB CI 클래스 모델: 릴리스 1.49.0은 일치하지 않는 API 엔드포인트에 대해 다음 클래스를 추가합니다. 이 앱이 확장할 수 있는 클래스를 포함하여 의 클래스 기본 시스템목록은 다음 문서를 참조하십시오 CMDB 테이블 설명.

    클래스 확장 설명
    일치하지 않는 API 엔드포인트

    [cmdb_ci_unmatched_api_endpoint]

    		 구성 항목

    [cmdb_ci]

    		 cmdb_ci_api 또는 cmdb_ci_api_component 채울 수 없는 구조화되지 않은 엔드포인트가 있는 API입니다.

    클래스 속성

    CMDB CI 클래스 모델: 릴리스 1.49.0은 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 클래스에 다음 속성을 추가합니다.

    표 1. 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint]
    속성 데이터 유형 설명
    방법 문자열 API의 백엔드 프로토콜 유형입니다. 예제:
    • Lambda
    • HTTP
    • 논리 앱
    프로토콜 문자열 통신 프로토콜입니다. 예: HTTP, HTTPS
    URL 문자열 (1024) 호출 중인 자원의 URL입니다.
    ID 문자열 (1024) 소스 시스템의 고유 식별자입니다.
    인터넷 커넥트 부울 공용 인터넷에서 구성요소에 연결할 수 있는지 여부를 나타내는 부울입니다. 구성요소에 연결할 수 있는 경우 1 또는 "예"를 지정합니다.
    권한 부여 문자열 권한 부여 또는 인증 방법의 유형입니다. 예제:
    • 기본
    • 키
    • OAuth
    • 없음
    요청 데이터 유형 문자열 (255) 요청의 데이터 유형 목록입니다. 예제:
    • 참조
    • 이메일
    • 주소
    응답 데이터 유형 문자열 (255) 응답의 데이터 유형 목록입니다. 예제:
    • 참조
    • 이메일
    • 주소

    키 관계 구조

    일치하지 않는 API 엔드포인트[cmdb_ci_unmatched_api_endpoint] CMDB 클래스 및 검색된 [api_endpoint_discovered] 비 CMDB 테이블은 구조화되지 않은 API 데이터가 수집되고 통합 허브-ETL의 기능을 벗어나 처리해야 하는 시나리오를 위한 것입니다.

    검색된 API 엔드포인트 [api_endpoint_discovered]는 API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component] 클래스에 대한 원시 데이터에 대한 준비 테이블 역할을 할 수 있습니다. 잘 구조화된 데이터 소스에서 제공되지 않거나 표준 식별 규칙을 적용할 수 없는 API 데이터는 먼저 검색된 API 엔드포인트 [api_endpoint_discovered] 테이블을 채울 수 있습니다. 그런 다음 고객 정의 통합을 사용하여 API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component]에 대한 품질 및 조건 요구 사항과 일치하는 올바른 형식의 데이터를 승격하여 가장 적합한 테이블을 채울 수 있습니다.

    데이터를 올바르게 구문 분석할 수 없거나 예기치 않은 방식으로 구조화된 경우 대신 고객 정의 통합을 사용하여 일치하지 않는 API 엔드포인트[cmdb_ci_unmatched_api_endpoint] 테이블을 채울 수 있습니다.

    검색된 API 엔드포인트 [api_endpoint_discovered] 테이블을 채우는 데이터는 30일마다 제거됩니다.

    표 2. 검색된 API 엔드포인트 [api_endpoint_discovered]
    속성 데이터 유형 설명
    이름 문자열 (100) API 엔드포인트의 이름입니다.
    방법 문자열 REST API 메서드입니다. 예제:
    • 임포트
    • 게시
    • 삭제
    URL 문자열 (1024) 호출 중인 자원의 URL입니다.
    유형 선택 목록 API의 유형입니다. 다음을 지정할 수 있습니다.
    • REST
    • SOAP
    • HTTP
    • gRPC
    • GraphQL
    • 웹소켓
    권한 부여 문자열 권한 부여 또는 인증 방법의 유형입니다. 예제:
    • 기본
    • 키
    • OAuth
    • 없음
    인터넷 커넥트 부울 공용 인터넷에서 구성요소에 연결할 수 있는지 여부를 나타내는 부울입니다. 구성요소에 연결할 수 있는 경우 1 또는 "예"를 지정합니다.
    요청 데이터 유형 문자열 (255) 요청의 데이터 유형 목록입니다. 예제:
    • 참조
    • 이메일
    • 주소
    응답 데이터 유형 문자열 (255) 응답의 데이터 유형 목록입니다. 예제:
    • 참조
    • 이메일
    • 주소
    헤더 문자열 (255) 쉼표로 구분된 헤더 이름 목록입니다.
    구성 항목 참조 일치 CMDB 하는 CI(API 구성요소 또는 일치하지 않는 API 엔드포인트)에 대한 참조입니다.

    관련 비CMDB 테이블

    일치하지 않는 API 확장 클래스는 API 배포 [api_deployment] 비 CMDB 테이블을 관련 목록으로 사용합니다.

    표 3. API 배포 [api_deployment]
    속성 데이터 유형 설명
    이름 문자열 (100) API 배포의 이름입니다.
    API 참조 배포된 API(cmdb_ci_api)에 대한 참조입니다.
    일치하지 않는 API 엔드포인트 참조 API가 기존 API(cmdb_ci_unmatched_api_endpoint)와 일치하지 않는 경우 일치하지 않는 API 엔드포인트에 대한 참조입니다.
    구성 항목 참조 구성 항목에 대한 참조입니다. API가 배포되는 CI를 알고 있는 경우 일반적으로 참조로 수동으로 지정합니다.