Module error

Errors returned by the compute controller.

The guiding principle for error handling in the compute controller is that each public method should return an error type that defines exactly the error variants the method can return, and no additional ones. This precludes the usage of a single ComputeControllerError enum that simply includes the union of all error variants the compute controller can ever return (and possibly some internal ones that are never returned to external callers). Instead, compute controller methods return bespoke error types that serve as documentation for the failure modes of each method and make it easy for callers to ensure that all possible errors are handled.

Structs

CollectionMissing

Error returned in response to a reference to an unknown compute collection.

HydrationCheckBadTarget

Error returned in response to a reference to an unknown compute collection.

InstanceExists

Error returned in response to a request to create a compute instance with an ID of an existing compute instance.

InstanceMissing

Error returned in response to a reference to an unknown compute instance.

Enums

CollectionLookupError

Errors arising during compute collection lookup.

CollectionUpdateError

Errors arising during collection updates.

DataflowCreationError

Errors arising during dataflow creation.

PeekError

Errors arising during peek processing.

ReadPolicyError

Errors arising during collection read policy assignment.

RemoveOrphansError

Errors arising during orphan removal.

ReplicaCreationError

Errors arising during compute replica creation.

ReplicaDropError

Errors arising during compute replica removal.

Constants

ERROR_TARGET_REPLICA_FAILED

The error returned by replica-targeted peeks and subscribes when the target replica disconnects.