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

呼び出し元にサービス アカウントの権限を借用する権限がないことを示します。

一般的な例外とユーティリティの例外

このセクションには、Content Hub 統合内の一般的なシステム エラー、パラメータ検証、特殊なデータ処理の例外が含まれています。

例外
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 インスタンスの障害を示します。