Errors

psengine.sandbox.errors

ProfileCreateError

ProfileCreateError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a profile create against /profiles (POST) fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

ProfileDeleteError

ProfileDeleteError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a profile delete against /profiles/{id} (DELETE) fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

ProfileFetchError

ProfileFetchError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a profile lookup against /profiles fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

ProfileNotFoundError

ProfileNotFoundError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a single-profile lookup against /profiles/{id} (GET) fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

ProfileUpdateError

ProfileUpdateError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a profile update against /profiles/{id} (PUT) fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleBehavioralReportError

SampleBehavioralReportError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a behavioral report lookup fails.

Covers the initial sample fetch and connection-level failures of the per-task /samples/{id}/{task_id}/report_triage.json requests made by SandboxMgr.fetch_behavioral_reports. Per-task HTTP failures do not raise -- they are reported in the not_ready/failed buckets of the returned BehavioralReportsResult.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleDeleteError

SampleDeleteError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample delete against /samples/{id} fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleFetchError

SampleFetchError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample lookup against /samples/{id} fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleFileFetchError

SampleFileFetchError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample file lookup against /samples/{id}/sample fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleOverviewError

SampleOverviewError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when an overview report lookup against /samples/{id}/overview.json fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleProfileError

SampleProfileError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when setting a sample profile against /samples/{id}/profile (POST) fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleReportNotAvailableError

SampleReportNotAvailableError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: SampleOverviewError, SampleStaticReportError

Raised when the sample exists but the requested report is not (yet) available.

The Sandbox API returns a discriminated 404 -- REPORT_NOT_AVAILABLE (overview) or NOT_AVAILABLE (static reports) -- when the sample exists but its analysis has not produced the requested report yet (e.g. it is still in static_analysis).

SandboxMgr.fetch_behavioral_reports does not raise this: per-task not-ready outcomes are reported in the not_ready bucket of its BehavioralReportsResult.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleReportNotFoundError

SampleReportNotFoundError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: SampleOverviewError, SampleStaticReportError, SampleBehavioralReportError

Raised when the sample itself does not exist for a report lookup (404 NOT_FOUND).

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleSearchError

SampleSearchError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample search against /search fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleStaticReportError

SampleStaticReportError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a static report lookup against /samples/{id}/reports/static fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleSubmitError

SampleSubmitError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample submission against /samples fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SampleSummaryError

SampleSummaryError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample summary lookup against /samples/{id}/summary fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message

SamplesFetchError

SamplesFetchError(
    message='An error occurred. Raise exceptions with a message argument to see additional information',
    *args,
)

Bases: RecordedFutureError

Raised when a sample listing against /samples fails.

Source code in psengine/errors.py

def __init__(
    self,
    message='An error occurred. Raise exceptions with a message argument to see additional information',  # noqa: E501
    *args,
):
    super().__init__(message, *args)
    self.message = message

message instance-attribute

message = message

__str__

__str__()

Source code in psengine/errors.py

def __str__(self):
    return self.message