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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

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

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

    모든 CMDB CI 클래스 모델 릴리스에 대한 전체 릴리스 정보는 다음에서 찾을 수 있습니다. https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/it-operations-management/store-rn-itom-cmdb-class-models.html?emcs_t=S2h8ZW1haWx8Ym9hcmRfc3Vic2NyaXB0aW9ufE1FMlVTSFREVDc3S0hTfDMzNDcxMjV8U1VCU0NSSVBUSU9OU3xoSw

    스토어에서 앱 요청

    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 엔드포인트[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 메서드입니다. 예제:
    • 임포트
    • 게시
    • DELETE
    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를 알고 있는 경우 일반적으로 수동으로 참조로 지정됩니다.