Class SdkServiceException

All Implemented Interfaces:
Serializable, SdkPojo
Direct Known Subclasses:
AwsServiceException

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:
  • Method Details

    • 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.