buildgrid.server.exceptions module

Exceptions

class buildgrid.server.exceptions.ErrorDomain(value)

Bases: Enum

SERVER = 1

BOT = 2

exception buildgrid.server.exceptions.BgdError(message: str | None, *, detail: Any | None = None, domain: ErrorDomain | None = None, reason: Any | None = None)

Bases: Exception

Base BuildGrid Error class for internal exceptions.

exception buildgrid.server.exceptions.ServerError(message: str | None, detail: Any | None = None, reason: Any | None = None): Bases: BgdError

exception buildgrid.server.exceptions.BotError(message: str | None, detail: Any | None = None, reason: Any | None = None): Bases: BgdError

exception buildgrid.server.exceptions.CancelledError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

The job was cancelled and any callers should be notified

exception buildgrid.server.exceptions.InvalidArgumentError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

A bad argument was passed, such as a name which doesn’t exist.

exception buildgrid.server.exceptions.NotFoundError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

Requested resource not found.

exception buildgrid.server.exceptions.UpdateNotAllowedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

UpdateNotAllowedError error.

exception buildgrid.server.exceptions.OutOfRangeError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

ByteStream service read data out of range.

exception buildgrid.server.exceptions.IncompleteReadError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

ByteStream service read didn’t return a full payload.

exception buildgrid.server.exceptions.FailedPreconditionError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

One or more errors occurred in setting up the action requested, such as a missing input or command or no worker being available. The client may be able to fix the errors and retry.

exception buildgrid.server.exceptions.PermissionDeniedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

The caller does not have permission to execute the specified operation.

exception buildgrid.server.exceptions.BotSessionError(message: str | None, *, detail: Any | None = None, domain: ErrorDomain | None = None, reason: Any | None = None)

Bases: BgdError

Parent class of BotSession Exceptions

exception buildgrid.server.exceptions.BotSessionClosedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BotSessionError

The requested BotSession has been closed recently.

exception buildgrid.server.exceptions.UnknownBotSessionError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BotSessionError

Buildgrid does not know the requested BotSession.

exception buildgrid.server.exceptions.BotSessionMismatchError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BotSessionError

The BotSession details don’t match those in BuildGrid’s records.

exception buildgrid.server.exceptions.DuplicateBotSessionError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BotSessionError

The bot with this ID already has a BotSession.

exception buildgrid.server.exceptions.BotSessionCancelledError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BotSessionError

The BotSession update was cancelled

exception buildgrid.server.exceptions.DatabaseError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

BuildGrid encountered a database error

exception buildgrid.server.exceptions.InstanceQuotaOutdatedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

The instance quota information is outdated

exception buildgrid.server.exceptions.RetriableError(message: str, retry_period: timedelta, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

BuildGrid encountered a retriable error retry_info to instruct clients when to retry error_status a grpc.Status message suitable to call with context.abort_with_status()

exception buildgrid.server.exceptions.RetriableDatabaseError(message: str, retry_period: timedelta, detail: Any | None = None, reason: Any | None = None)

Bases: RetriableError

BuildGrid encountered a retriable database error

exception buildgrid.server.exceptions.ResourceExhaustedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space.

exception buildgrid.server.exceptions.StorageFullError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: ResourceExhaustedError

BuildGrid’s storage is full, cannot commit to it.

exception buildgrid.server.exceptions.GrpcUninitializedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: BgdError

BuildGrid tried to use a gRPC stub before gRPC was initialized.

exception buildgrid.server.exceptions.ShutdownSignal(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: ServerError

Exception raised by a signal handler in the server.

exception buildgrid.server.exceptions.ShutdownDelayedError(message: str | None, detail: Any | None = None, reason: Any | None = None)

Bases: ServerError

BuildGrid took longer than expected to cleanly shutdown.