Class RejectedRecordsException

All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<RejectedRecordsException.Builder,RejectedRecordsException>

@Generated("software.amazon.awssdk:codegen") public final class RejectedRecordsException extends TimestreamWriteException implements ToCopyableBuilder<RejectedRecordsException.Builder,RejectedRecordsException>

WriteRecords would throw this exception in the following cases:

  • Records with duplicate data where there are multiple records with the same dimensions, timestamps, and measure names but:

    • Measure values are different

    • Version is not present in the request or the value of version in the new record is equal to or lower than the existing value

    In this case, if Timestream rejects data, the ExistingVersion field in the RejectedRecords response will indicate the current record’s version. To force an update, you can resend the request with a version for the record set to a value greater than the ExistingVersion.

  • Records with timestamps that lie outside the retention duration of the memory store.

  • Records with dimensions or measures that exceed the Timestream defined limits.

For more information, see Quotas in the Amazon Timestream Developer Guide.

See Also:
  • Method Details

    • toBuilder

      Description copied from class: AwsServiceException
      Create a AwsServiceException.Builder initialized with the properties of this AwsServiceException.
      Specified by:
      toBuilder in interface ToCopyableBuilder<RejectedRecordsException.Builder,RejectedRecordsException>
      Overrides:
      toBuilder in class TimestreamWriteException
      Returns:
      A new builder initialized with this config's properties.
    • builder

      public static RejectedRecordsException.Builder builder()
    • serializableBuilderClass

      public static Class<? extends RejectedRecordsException.Builder> serializableBuilderClass()
    • hasRejectedRecords

      public boolean hasRejectedRecords()
      For responses, this returns true if the service returned a value for the RejectedRecords property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
    • rejectedRecords

      public List<RejectedRecord> rejectedRecords()

      Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

      This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasRejectedRecords() method.

      Returns:
    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Overrides:
      sdkFields in class SdkServiceException
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.