ServerCapabilityUnavailable
extends ServerException
in package
The connected Server has no route for an additive capability the call needs.
Raised with status 501 and reason backend_capability_unavailable when an older Server answers
a capability's route with a plain 404. Nothing was read or changed. capability names the
cluster info capability to check before offering the call, and details carries the Server's
original status and answer. The original error is kept as the previous exception.
Table of Contents
Properties
- $capability : string
- $details : array<string|int, mixed>|null
- $reason : string|null
- $status : int
Methods
- __construct() : mixed
- fromMissingRoute() : self
- isActivityCompletionPayloadDiscoveryUnavailable() : bool
- Discovery failed before any activity-completion request was submitted.
- isActivityTaskBackendUnavailable() : bool
- A backend failure whose activity completion can be retried with the same attempt and lease.
- isMissingRoute() : bool
- A plain route 404 means the Server predates the capability. A 404 with any other reason, such as `namespace_not_found`, is the Server's own answer and is kept as it is.
- isStorageAdmissionFailure() : bool
- Whether the Server explicitly refused admission and requested a same-identity retry.
- isTransientConnectionFailure() : bool
- isTransientUpstreamFailure() : bool
- A temporary upstream HTTP failure without a Server protocol envelope.
- isWorkflowTaskBackendUnavailable() : bool
- A backend failure whose workflow-task mutation can be retried with the same lease fence.
- isWorkflowTaskCompletionDeferred() : bool
- A completion explicitly deferred before commit, under the original lease.
- isWorkflowTaskCompletionPublicationDeferred() : bool
- A committed completion whose publication needs same-fence reconciliation.
Properties
$capability read-only
public
string
$capability
$details read-only
public
array<string|int, mixed>|null
$details
= null
$reason read-only
public
string|null
$reason
= null
$status read-only
public
int
$status
Methods
__construct()
public
__construct(string $capability, string $message[, array<string, mixed> $details = [] ][, Throwable|null $previous = null ]) : mixed
Parameters
- $capability : string
- $message : string
- $details : array<string, mixed> = []
- $previous : Throwable|null = null
fromMissingRoute()
public
static fromMissingRoute(ServerException $exception, string $capability, string $message) : self
Parameters
- $exception : ServerException
- $capability : string
- $message : string
Return values
selfisActivityCompletionPayloadDiscoveryUnavailable()
Discovery failed before any activity-completion request was submitted.
public
isActivityCompletionPayloadDiscoveryUnavailable(string $taskId, string $attemptId, string $leaseOwner) : bool
Parameters
- $taskId : string
- $attemptId : string
- $leaseOwner : string
Return values
boolisActivityTaskBackendUnavailable()
A backend failure whose activity completion can be retried with the same attempt and lease.
public
isActivityTaskBackendUnavailable(string $taskId, string $attemptId, string $leaseOwner) : bool
Parameters
- $taskId : string
- $attemptId : string
- $leaseOwner : string
Return values
boolisMissingRoute()
A plain route 404 means the Server predates the capability. A 404 with any other reason, such as `namespace_not_found`, is the Server's own answer and is kept as it is.
public
static isMissingRoute(ServerException $exception) : bool
Parameters
- $exception : ServerException
Return values
boolisStorageAdmissionFailure()
Whether the Server explicitly refused admission and requested a same-identity retry.
public
isStorageAdmissionFailure([string|null $pollRequestId = null ]) : bool
Parameters
- $pollRequestId : string|null = null
Return values
boolisTransientConnectionFailure()
public
isTransientConnectionFailure() : bool
Return values
boolisTransientUpstreamFailure()
A temporary upstream HTTP failure without a Server protocol envelope.
public
isTransientUpstreamFailure() : bool
Return values
boolisWorkflowTaskBackendUnavailable()
A backend failure whose workflow-task mutation can be retried with the same lease fence.
public
isWorkflowTaskBackendUnavailable(string $taskId, string $leaseOwner, int $attempt[, string $operation = 'heartbeat_workflow_task' ]) : bool
Parameters
- $taskId : string
- $leaseOwner : string
- $attempt : int
- $operation : string = 'heartbeat_workflow_task'
Return values
boolisWorkflowTaskCompletionDeferred()
A completion explicitly deferred before commit, under the original lease.
public
isWorkflowTaskCompletionDeferred(string $taskId, string $leaseOwner, int $attempt) : bool
Parameters
- $taskId : string
- $leaseOwner : string
- $attempt : int
Return values
boolisWorkflowTaskCompletionPublicationDeferred()
A committed completion whose publication needs same-fence reconciliation.
public
isWorkflowTaskCompletionPublicationDeferred(string $taskId, string $leaseOwner, int $attempt) : bool
Parameters
- $taskId : string
- $leaseOwner : string
- $attempt : int