Package org.elasticsearch.xpack.esql.datasources.spi

Class ExternalClientException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.elasticsearch.ElasticsearchException

org.elasticsearch.xpack.esql.core.QlException

org.elasticsearch.xpack.esql.datasources.spi.ExternalException

org.elasticsearch.xpack.esql.datasources.spi.ExternalClientException

All Implemented Interfaces:

Serializable, Writeable, ToXContent, ToXContentFragment

public final class ExternalClientException
extends ExternalException

An external-source failure caused by the request rather than by the cluster: the data we were pointed at cannot be read or decoded (corrupt/truncated/malformed file, an unsupported format feature, a missing object). Maps to 400 Bad Request.

Unlike reading an index, failing to read an external resource is treated as a client-class error: the caller chose the resource. Retryable transport problems are the exception — those are raised as ExternalUnavailableException (503) instead.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.elasticsearch.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields inherited from class org.elasticsearch.ElasticsearchException

REST_EXCEPTION_SKIP_CAUSE, REST_EXCEPTION_SKIP_STACK_TRACE, REST_EXCEPTION_SKIP_STACK_TRACE_DEFAULT, STACK_TRACE

Fields inherited from interface org.elasticsearch.xcontent.ToXContent

EMPTY, EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
ExternalClientException(String message, Object... args)
ExternalClientException(String message, Throwable cause)
ExternalClientException(Throwable cause, String message, Object... args)

Method Summary

Modifier and Type	Method	Description
RestStatus	status()

Methods inherited from class org.elasticsearch.ElasticsearchException

addBodyHeader, addBodyHeader, addHttpHeader, addHttpHeader, addMetadata, addMetadata, failureFromXContent, fromXContent, generateFailureXContent, generateThrowableXContent, generateThrowableXContent, getBodyHeader, getBodyHeaderKeys, getBodyHeaders, getDetailedMessage, getExceptionName, getExceptionName, getExceptionName, getHttpHeader, getHttpHeaderKeys, getHttpHeaders, getId, getIndex, getMetadata, getMetadata, getMetadataKeys, getResourceId, getResourceType, getRootCause, getShardId, guessRootCauses, guessRootCauses, innerFromXContent, innerToXContent, isRegistered, isTimeout, metadataToXContent, readException, readException, readStackTrace, setIndex, setIndex, setResources, setShard, toString, toXContent, toXContent, unwrapCause, writeException, writeStackTraces, writeTo, writeTo

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.xcontent.ToXContentFragment

isFragment

Constructor Details

ExternalClientException

public ExternalClientException(String message,
 Throwable cause)

ExternalClientException

public ExternalClientException(Throwable cause,
 String message,
 Object... args)

ExternalClientException

public ExternalClientException(String message,
 Object... args)

Method Details

status

public RestStatus status()

Overrides:

status in class ElasticsearchException