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

Class RejectedRecordsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

software.amazon.awssdk.core.exception.SdkException

software.amazon.awssdk.core.exception.SdkServiceException

software.amazon.awssdk.awscore.exception.AwsServiceException

software.amazon.awssdk.services.timestreamwrite.model.TimestreamWriteException

software.amazon.awssdk.services.timestreamwrite.model.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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	RejectedRecordsException.Builder

Method Summary

Modifier and Type	Method	Description
static RejectedRecordsException.Builder	builder()
boolean	hasRejectedRecords()	For responses, this returns true if the service returned a value for the RejectedRecords property.
List<RejectedRecord>	rejectedRecords()
Map<String,SdkField<?>>	sdkFieldNameToField()
List<SdkField<?>>	sdkFields()
static Class<? extends RejectedRecordsException.Builder>	serializableBuilderClass()
RejectedRecordsException.Builder	toBuilder()

Methods inherited from class software.amazon.awssdk.awscore.exception.AwsServiceException

awsErrorDetails, getMessage, isClockSkewException, isThrottlingException

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

extendedRequestId, isRetryableException, requestId, statusCode

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

create, retryable

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, 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

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

toBuilder

public RejectedRecordsException.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<RejectedRecordsException.Builder,RejectedRecordsException>

Overrides:

toBuilder in class TimestreamWriteException

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

sdkFieldNameToField

public final Map<String,SdkField<?>> sdkFieldNameToField()

Specified by:

sdkFieldNameToField in interface SdkPojo