# nominal.exceptions

## Exceptions

Errors raised by the client, from `nominal.exceptions`. All errors derive from
[`NominalError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalError.md#nominal.exceptions.NominalError "nominal.exceptions.NominalError").

| [`ExtractorError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.ExtractorError.md#nominal.exceptions.ExtractorError "nominal.exceptions.ExtractorError") | Raised when the extractor contract is violated (missing input, wrong output count, ...). |
| --- | --- |
| [`HeaderConflictError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.HeaderConflictError.md#nominal.exceptions.HeaderConflictError "nominal.exceptions.HeaderConflictError") | A header provider attempted to override an explicit request header. |
| [`NominalAlreadyExistsError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalAlreadyExistsError.md#nominal.exceptions.NominalAlreadyExistsError "nominal.exceptions.NominalAlreadyExistsError") | The resource being created already exists (e.g. a container image tag already registered). |
| [`NominalAuthenticationError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalAuthenticationError.md#nominal.exceptions.NominalAuthenticationError "nominal.exceptions.NominalAuthenticationError") | The request was not authenticated (missing, expired, or invalid credentials). |
| [`NominalChecklistNotPublishedError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalChecklistNotPublishedError.md#nominal.exceptions.NominalChecklistNotPublishedError "nominal.exceptions.NominalChecklistNotPublishedError") | The requested checklist version has not been published. |
| [`NominalComputeError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalComputeError.md#nominal.exceptions.NominalComputeError "nominal.exceptions.NominalComputeError") | An error occurred during a compute request. |
| [`NominalConfigError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalConfigError.md#nominal.exceptions.NominalConfigError "nominal.exceptions.NominalConfigError") | An error occurred reading or writing the configuration. |
| [`NominalContainerImageError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalContainerImageError.md#nominal.exceptions.NominalContainerImageError "nominal.exceptions.NominalContainerImageError") | A containerized extractor's container image is in a failed or unusable state. |
| [`NominalDataScopeNotFoundError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalDataScopeNotFoundError.md#nominal.exceptions.NominalDataScopeNotFoundError "nominal.exceptions.NominalDataScopeNotFoundError") | No readable resource has this data scope name on an asset, or this ref name on a run. |
| [`NominalError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalError.md#nominal.exceptions.NominalError "nominal.exceptions.NominalError") | Base class for Nominal exceptions. |
| [`NominalIngestError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalIngestError.md#nominal.exceptions.NominalIngestError "nominal.exceptions.NominalIngestError") | An error occurred during ingest. |
| [`NominalIngestFailed`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalIngestFailed.md#nominal.exceptions.NominalIngestFailed "nominal.exceptions.NominalIngestFailed") | The ingest failed. |
| [`NominalIngestMultiError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalIngestMultiError.md#nominal.exceptions.NominalIngestMultiError "nominal.exceptions.NominalIngestMultiError") | Error(s) occurred during ingest. |
| [`NominalIngestTimeout`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalIngestTimeout.md#nominal.exceptions.NominalIngestTimeout "nominal.exceptions.NominalIngestTimeout") | Ingest did not reach a terminal state before the caller's deadline. |
| [`NominalIngestUploadFailed`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalIngestUploadFailed.md#nominal.exceptions.NominalIngestUploadFailed "nominal.exceptions.NominalIngestUploadFailed") | One or more files in an ingest batch failed to upload; nothing was ingested. |
| [`NominalInvalidArgumentError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalInvalidArgumentError.md#nominal.exceptions.NominalInvalidArgumentError "nominal.exceptions.NominalInvalidArgumentError") | The server rejected the request as malformed or invalid. |
| [`NominalMethodRemovedError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalMethodRemovedError.md#nominal.exceptions.NominalMethodRemovedError "nominal.exceptions.NominalMethodRemovedError") | An error raised when a method has been deprecated and now removed. |
| [`NominalMultipartUploadError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalMultipartUploadError.md#nominal.exceptions.NominalMultipartUploadError "nominal.exceptions.NominalMultipartUploadError") | A single failed multipart upload attempt. |
| [`NominalMultipartUploadFailed`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalMultipartUploadFailed.md#nominal.exceptions.NominalMultipartUploadFailed "nominal.exceptions.NominalMultipartUploadFailed") | The multipart upload failed after retries. |
| [`NominalNotFoundError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalNotFoundError.md#nominal.exceptions.NominalNotFoundError "nominal.exceptions.NominalNotFoundError") | The requested resource does not exist. |
| [`NominalParameterRemovedError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalParameterRemovedError.md#nominal.exceptions.NominalParameterRemovedError "nominal.exceptions.NominalParameterRemovedError") | An error raised when an parameter has been deprecated and now removed. |
| [`NominalPermissionDeniedError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalPermissionDeniedError.md#nominal.exceptions.NominalPermissionDeniedError "nominal.exceptions.NominalPermissionDeniedError") | The caller is authenticated but not authorized for the requested resource. |
| [`NominalRequestThrottledError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalRequestThrottledError.md#nominal.exceptions.NominalRequestThrottledError "nominal.exceptions.NominalRequestThrottledError") | The server throttled a request for longer than the caller's retry budget allowed. |
| [`NominalVideoFileMetadataError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalVideoFileMetadataError.md#nominal.exceptions.NominalVideoFileMetadataError "nominal.exceptions.NominalVideoFileMetadataError") | A video file lacks the segment metadata needed to re-ingest it elsewhere. |
| [`NominalVideoScaleModeError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalVideoScaleModeError.md#nominal.exceptions.NominalVideoScaleModeError "nominal.exceptions.NominalVideoScaleModeError") | More than one way of scaling a video's playback rate was given; at most one is allowed. |
| [`NominalVideoStreamError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalVideoStreamError.md#nominal.exceptions.NominalVideoStreamError "nominal.exceptions.NominalVideoStreamError") | An error occurred during live video streaming. |
| [`NominalVideoStreamNotOpenError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalVideoStreamNotOpenError.md#nominal.exceptions.NominalVideoStreamNotOpenError "nominal.exceptions.NominalVideoStreamNotOpenError") | The video stream is not open. |
| [`NominalVideoTimestampModeError`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.NominalVideoTimestampModeError.md#nominal.exceptions.NominalVideoTimestampModeError "nominal.exceptions.NominalVideoTimestampModeError") | Neither or both of a video's timestamp modes were provided; exactly one is required. |

## Warnings

Warnings emitted by the client, from `nominal.exceptions`.

| [`LegacyVideoDeprecationWarning`](https://dev.nominal.io/python/ref/generated/nominal.exceptions.LegacyVideoDeprecationWarning.md#nominal.exceptions.LegacyVideoDeprecationWarning "nominal.exceptions.LegacyVideoDeprecationWarning") | Emitted by the legacy standalone-video API, superseded by video channels on a dataset. |
| --- | --- |