aistore.sdk.errors | NVIDIA AIStore

Module Contents

Classes

Name	Description
`AISError`	Raised when an error is encountered from a query to the AIS cluster
`AISRetryableError`	Exception raised for AIStore related errors that may resolve by retrying.
`APIRequestError`	Base class for errors from HTTP servers, e.g. AIS or AuthN
`ETLDirectPutTransientError`	Raised when a direct-put from an ETL pod fails with a transient network error
`ErrBckAlreadyExists`	Raised when a bucket is created but already exists in AIS
`ErrBckNotFound`	Raised when a bucket is expected and not found
`ErrETLAlreadyExists`	Raised when an ETL is created but already exists in AIS
`ErrETLNotFound`	Raised when an ETL is expected but not found
`ErrGETConflict`	Raised when AIS cannot obtain a write lock because another process is currently writing this object to local storage
`ErrObjNotFound`	Raised when an object is expected and not found
`ErrRemoteBckNotFound`	Raised when a remote bucket its required and missing for the requested operation
`InvalidBckProvider`	Raised when the bucket provider is invalid for the requested operation
`InvalidObjectRangeIndex`	Raised when incorrect range parameters are passed when creating an ObjectRange
`InvalidPipelineError`	Raised when an ETL pipeline header is malformed or invalid.
`InvalidURLException`	Raised when the URL is invalid or any part of it is missing.
`JobInfoNotFound`	Raised when information on a job’s status could not be found on the AIS cluster
`NoTargetError`	Raised when attempting to select a target for an object, but none were found in cluster map
`Timeout`	Raised when an operation takes too long to complete
`UnexpectedHTTPStatusCode`	Raised when the status code from a response is not what’s expected.

API

class aistore.sdk.errors.AISError()

Bases: APIRequestError

Raised when an error is encountered from a query to the AIS cluster

class aistore.sdk.errors.AISRetryableError()

Bases: AISError

Exception raised for AIStore related errors that may resolve by retrying.

class aistore.sdk.errors.APIRequestError(
    status_code: int,
    message: str,
    req_url: str,
    req: requests.PreparedRequest
)

Exception

Bases: Exception

Base class for errors from HTTP servers, e.g. AIS or AuthN

class aistore.sdk.errors.ETLDirectPutTransientError(
    url: str,
    cause: Exception
)

Exception

Bases: Exception

Raised when a direct-put from an ETL pod fails with a transient network error that is safe to retry (connection lost before a response was received).

class aistore.sdk.errors.ErrBckAlreadyExists()

Bases: AISError

Raised when a bucket is created but already exists in AIS

class aistore.sdk.errors.ErrBckNotFound()

Bases: AISError

Raised when a bucket is expected and not found

class aistore.sdk.errors.ErrETLAlreadyExists()

Bases: AISError

Raised when an ETL is created but already exists in AIS

class aistore.sdk.errors.ErrETLNotFound()

Bases: AISError

Raised when an ETL is expected but not found

class aistore.sdk.errors.ErrGETConflict()

Bases: AISRetryableError

Raised when AIS cannot obtain a write lock because another process is currently writing this object to local storage

class aistore.sdk.errors.ErrObjNotFound()

Bases: AISRetryableError

Raised when an object is expected and not found

class aistore.sdk.errors.ErrRemoteBckNotFound()

Bases: AISError

Raised when a remote bucket its required and missing for the requested operation

class aistore.sdk.errors.InvalidBckProvider(
    provider
)

Exception

Bases: Exception

Raised when the bucket provider is invalid for the requested operation

class aistore.sdk.errors.InvalidObjectRangeIndex(
    message
)

Exception

Bases: Exception

Raised when incorrect range parameters are passed when creating an ObjectRange

class aistore.sdk.errors.InvalidPipelineError()

Bases: ValueError

Raised when an ETL pipeline header is malformed or invalid.

class aistore.sdk.errors.InvalidURLException(
    url
)

Exception

Bases: Exception

Raised when the URL is invalid or any part of it is missing.

class aistore.sdk.errors.JobInfoNotFound(
    message
)

Exception

Bases: Exception

Raised when information on a job’s status could not be found on the AIS cluster

class aistore.sdk.errors.NoTargetError(
    total_nodes: int
)

Exception

Bases: Exception

Raised when attempting to select a target for an object, but none were found in cluster map

class aistore.sdk.errors.Timeout(
    action,
    message = ''
)

Exception

Bases: Exception

Raised when an operation takes too long to complete

class aistore.sdk.errors.UnexpectedHTTPStatusCode(
    expected_status_codes,
    received_status_code
)

Exception

Bases: Exception

Raised when the status code from a response is not what’s expected.