Package software.amazon.awssdk.core.exception

Class SdkServiceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

software.amazon.awssdk.core.exception.SdkException

software.amazon.awssdk.core.exception.SdkServiceException

All Implemented Interfaces:

Serializable, SdkPojo

public class SdkServiceException
extends SdkException
implements SdkPojo

Extension of SdkException that represents an error response returned by the requested downstream service. Receiving an exception of this type indicates that the caller's request was correctly transmitted to the service, but for some reason, the service was not able to process it, and returned an error response instead.

Exceptions that extend SdkServiceException are assumed to be able to be successfully retried.

SdkServiceException provides callers several pieces of information that can be used to obtain more information about the error and why it occurred.

See Also:

SdkClientException, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	SdkServiceException.Builder
protected static class	SdkServiceException.BuilderImpl

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SdkServiceException(SdkServiceException.Builder b)

Method Summary

Modifier and Type	Method	Description
static SdkServiceException.Builder	builder()
String	extendedRequestId()	The extendedRequestId that was returned by the called service.
boolean	isClockSkewException()	Specifies whether or not an exception may have been caused by clock skew.
boolean	isThrottlingException()	Specifies whether or not an exception is caused by throttling.
String	requestId()	The requestId that was returned by the called service.
List<SdkField<?>>	sdkFields()
static Class<? extends SdkServiceException.Builder>	serializableBuilderClass()
int	statusCode()	The status code that was returned by the called service.
SdkServiceException.Builder	toBuilder()	Create a SdkServiceException.Builder initialized with the properties of this SdkServiceException.

Methods inherited from class software.amazon.awssdk.core.exception.SdkException

create, retryable

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields

Constructor Detail

SdkServiceException

protected SdkServiceException(SdkServiceException.Builder b)

Method Detail

requestId

public String requestId()

The requestId that was returned by the called service.

Returns:

String containing the requestId

extendedRequestId

public String extendedRequestId()

The extendedRequestId that was returned by the called service.

Returns:

String ctontaining the extendedRequestId

statusCode

public int statusCode()

The status code that was returned by the called service.

Returns:

int containing the status code.

isClockSkewException

public boolean isClockSkewException()

Specifies whether or not an exception may have been caused by clock skew.

isThrottlingException

public boolean isThrottlingException()

Specifies whether or not an exception is caused by throttling.

Returns:

true if the status code is 429, otherwise false.

builder

public static SdkServiceException.Builder builder()

Returns:

SdkServiceException.Builder instance to construct a new SdkServiceException.

toBuilder

public SdkServiceException.Builder toBuilder()

Create a SdkServiceException.Builder initialized with the properties of this SdkServiceException.

Overrides:

toBuilder in class SdkException

Returns:

A new builder initialized with this config's properties.

serializableBuilderClass

public static Class<? extends SdkServiceException.Builder> serializableBuilderClass()

sdkFields

public List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo

Returns:

List of SdkField in this POJO. May be empty list but should never be null.