exceptions 모듈

exceptions 모듈은 플랫폼 내에서 오류 처리를 위한 표준화된 프레임워크를 제공합니다. 작업, 커넥터, 작업, Google Cloud 작업을 위한 특수 예외 클래스가 포함되어 있어 개발자가 특정 실패 시나리오를 정확하게 포착하고 대응할 수 있습니다.

다음 예에서는 이 모듈에서 특정 오류를 가져오고 발생시키는 방법을 보여줍니다.

from TIPCommon.exceptions import ConnectorProcessingError
raise ConnectorProcessingError('spam and eggs')

작업 예외

이러한 예외는 초기화부터 데이터 보고에 이르기까지 작업의 수명 주기 중에 발생하는 오류를 처리합니다.

예외
GeneralActionException 기지: Exception

모든 작업 관련 예외의 기본 클래스 역할을 합니다.

ActionSetupError 기지: GeneralActionException

작업 초기화 중 오류를 나타냅니다.

CaseResultError 기지: GeneralActionException

케이스 결과에 데이터를 전송하는 중에 오류가 발생할 때 발생합니다.

EnrichActionError 기지: GeneralActionException

강화 작업에서 오류가 발생할 때 발생합니다.

SDKWrapperError 기지: GeneralActionException

SDK 메서드 래퍼에서 오류가 발생할 때 발생합니다.

JobSetupError 기지: GeneralActionException

작업 초기화 오류를 나타냅니다.

커넥터 예외

이러한 예외는 데이터 커넥터 및 해당 처리 로직과 관련된 실패 상태를 관리합니다.

예외
GeneralConnectorException 기지: Exception

모든 커넥터 관련 예외의 기본 클래스 역할을 합니다.

ConnectorSetupError 기지: GeneralConnectorException

커넥터 초기화 중 실패를 나타냅니다.

ConnectorContextError 기지: GeneralConnectorException

커넥터 컨텍스트 내의 오류를 나타냅니다.

ConnectorProcessingError 기지: GeneralConnectorException

커넥터의 데이터 처리 단계 중에 발생한 오류를 나타냅니다.

ConnectorValidationError 기지: GeneralConnectorException

커넥터에 유효성 검사 오류가 발생했음을 나타냅니다.

Google Cloud 예외

이러한 예외는Google Cloud 리소스와 상호작용할 때 발생하는 특정 오류 상태에 매핑됩니다.

예외
GoogleCloudException 기지: Exception

Google Cloud 오류의 일반적인 기본 클래스 역할을 합니다.

AlreadyExistsError 기지: GoogleCloudException

리소스가 이미 있는 경우 발생합니다. Google Cloud

NotFoundError 기지: GoogleCloudException

Google Cloud 리소스를 찾을 수 없는 경우 발생합니다.

PermissionDeniedError 기지: GoogleCloudException

클라이언트에게 리소스에 대한 작업을 실행할 권한이 없는 경우 발생합니다.

UnauthenticatedError 기지: GoogleCloudException

클라이언트가 올바르게 인증되지 않은 경우 발생합니다.

DeadlineExceededError 기지: GoogleCloudException

할당된 시간 내에 요청이 완료되지 않으면 발생합니다.

ResourceExhaustedError 기지: GoogleCloudException

클라우드 프로젝트의 할당량이 초과되었거나 클라이언트에서 동시 요청이 너무 많음을 나타냅니다.

BadGatewayError 기지: GoogleCloudException

클라이언트와 백엔드 Google Cloud 서버 사이의 서버에서 일시적인 문제를 감지했음을 나타냅니다.

UnavailableError 기지: GoogleCloudException

Google Cloud 서비스에서 요청을 처리할 수 없음을 나타냅니다.

InvalidArgumentError 기지: GoogleCloudException

Google Cloud 리소스에 대한 잘못된 요청을 나타냅니다.

FailedPreconditionError 기지: GoogleCloudException

Google Cloud 요청의 실패한 전제 조건 오류를 나타냅니다.

ImpersonationUnauthorizedError 기지: GoogleCloudException

호출자에게 서비스 계정을 가장할 권한이 없음을 나타냅니다.

일반 및 유틸리티 예외

이 섹션에는 일반 시스템 오류, 매개변수 유효성 검사, 콘텐츠 허브 통합 내 전문 데이터 처리에 대한 예외가 포함되어 있습니다.

예외
ParameterValidationError 기지: Exception

매개변수가 잘못된 경우 발생합니다.

EmptyMandatoryValues 기지: Exception

필수 값이 비어 있는 예외를 나타냅니다.

ParameterExtractionError 기지: Exception

매개변수 추출 오류를 나타냅니다.

OauthError 기지: Exception

OAuth 2.0 흐름에서 일반 예외가 발생할 때 발생합니다.

SMIMEMailError 기지: Exception

S/MIME 이메일 처리 오류의 맞춤 예외를 나타냅니다.

InternalJSONDecoderError 기지: Exception

json.load 또는 json.dump을 사용하는 내부 JSON 파싱 오류를 나타냅니다.

InvalidTimeException 기지: Exception

잘못된 시간에 대한 예외를 나타냅니다.

NotSupportedPlatformVersion 기지: Exception

지원되지 않는 플랫폼 버전 오류의 맞춤 예외를 나타냅니다.

GeneralJobException 기지: Exception

작업 관련 예외의 일반 기본 클래스 역할을 합니다.

RefreshTokenRenewalJobException 기지: GeneralJobException

RefreshTokenRenewalJob 인스턴스의 실패를 나타냅니다.