Package software.amazon.awssdk.services.timestreamwrite.model

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:
    Serialized Form

    • Method Detail

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