스키마

Panther GraphQL API 스키마 작업

개요

Panther API는 다음 스키마 작업을 지원합니다:

• 사용자 지정 스키마 만들기 또는 업데이트

• 스키마 나열

콘솔의 API Playground 또는 GraphQL-over-HTTP API를 사용하여 Panther의 API를 호출할 수 있습니다. 이러한 방법에 대해 자세히 알아보려면 Panther API.

다음을 참조하세요 사용자 지정 로그 Panther에서 사용자 지정 스키마에 대해 자세히 알아보려면.

필수 API 토큰 권한

API 호출을 시작하기 전에 API 토큰에 필요한 권한이 연결되어 있는지 확인하세요:

• 로그 소스 보기: 모든 스키마 작업에 필요합니다.

• 로그 소스 관리: 변경 작업인 스키마 관리 작업에 필요합니다(즉, CreateOrUpdateSchema).

• 사용자 정보 읽기: 생성자와 관련된 통합 필드를 검색하려면 필요합니다. 예: createdBy.

일반적인 스키마 작업

사용자 지정 스키마 만들기

mutation addSchema {
  createOrUpdateSchema(input:{
    description: "description"
    name:"Custom.NewSchema",
    isFieldDiscoveryEnabled: true,
    spec:"""
    fields:
     - name: foo
       type: string
    """
  }) {
    schema {
      createdAt
      description
      isArchived
      isManaged
      name
      referenceURL
      revision
      isFieldDiscoveryEnabled
      spec
      discoveredSpec
      updatedAt
      version
    }
  }
}

스키마 나열

이 쿼리는 사용자 지정 및 Panther에서 관리하는 스키마를 포함한 모든 스키마를 나열합니다.

현재는 페이지 매김이 스키마를 지원하지 않습니다. 모든 스키마가 결과의 첫 페이지에 반환됩니다. 아래의 cursor 필드를 통해 입력 객체는 향후 페이지 매김이 지원될 때를 위한 자리 표시자입니다.

query ListSchemas {
  schemas(input:{cursor:""}) {
    edges {
      node {
        createdAt
        description
        isArchived
        isManaged
        name
        referenceURL
        revision
        isFieldDiscoveryEnabled
        spec
        discoveredSpec
        updatedAt
        version
      }
    }
  }
}