Package software.amazon.awssdk.services.firehose.model

Class ElasticsearchDestinationUpdate

java.lang.Object
software.amazon.awssdk.services.firehose.model.ElasticsearchDestinationUpdate
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<ElasticsearchDestinationUpdate.Builder,ElasticsearchDestinationUpdate>
@Generated("software.amazon.awssdk:codegen") public final class ElasticsearchDestinationUpdate extends Object implements SdkPojo, Serializable, ToCopyableBuilder<ElasticsearchDestinationUpdate.Builder,ElasticsearchDestinationUpdate>

Describes an update for a destination in Amazon ES.

See Also:

  • Method Details

    • roleARN

      public final String roleARN()

      The Amazon Resource Name (ARN) of the IAM role to be assumed by Firehose for calling the Amazon ES Configuration API and for indexing documents. For more information, see Grant Firehose Access to an Amazon S3 Destination and Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.

      Returns:
      The Amazon Resource Name (ARN) of the IAM role to be assumed by Firehose for calling the Amazon ES Configuration API and for indexing documents. For more information, see Grant Firehose Access to an Amazon S3 Destination and Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.

    • domainARN

      public final String domainARN()

      The ARN of the Amazon ES domain. The IAM role must have permissions for DescribeDomain, DescribeDomains, and DescribeDomainConfig after assuming the IAM role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.

      Specify either ClusterEndpoint or DomainARN.

      Returns:
      The ARN of the Amazon ES domain. The IAM role must have permissions for DescribeDomain, DescribeDomains, and DescribeDomainConfig after assuming the IAM role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.

      Specify either ClusterEndpoint or DomainARN.

    • clusterEndpoint

      public final String clusterEndpoint()

      The endpoint to use when communicating with the cluster. Specify either this ClusterEndpoint or the DomainARN field.

      Returns:
      The endpoint to use when communicating with the cluster. Specify either this ClusterEndpoint or the DomainARN field.

    • indexName

      public final String indexName()

      The Elasticsearch index name.

      Returns:
      The Elasticsearch index name.

    • typeName

      public final String typeName()

      The Elasticsearch type name. For Elasticsearch 6.x, there can be only one type per index. If you try to specify a new type for an existing index that already has another type, Firehose returns an error during runtime.

      If you upgrade Elasticsearch from 6.x to 7.x and don’t update your delivery stream, Firehose still delivers data to Elasticsearch with the old index name and type name. If you want to update your delivery stream with a new index name, provide an empty string for TypeName.

      Returns:
      The Elasticsearch type name. For Elasticsearch 6.x, there can be only one type per index. If you try to specify a new type for an existing index that already has another type, Firehose returns an error during runtime.

      If you upgrade Elasticsearch from 6.x to 7.x and don’t update your delivery stream, Firehose still delivers data to Elasticsearch with the old index name and type name. If you want to update your delivery stream with a new index name, provide an empty string for TypeName.

    • indexRotationPeriod

      public final ElasticsearchIndexRotationPeriod indexRotationPeriod()

      The Elasticsearch index rotation period. Index rotation appends a timestamp to IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value is OneDay.

      If the service returns an enum value that is not available in the current SDK version, indexRotationPeriod will return ElasticsearchIndexRotationPeriod.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from indexRotationPeriodAsString().

      Returns:
      The Elasticsearch index rotation period. Index rotation appends a timestamp to IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value is OneDay.
      See Also:

    • indexRotationPeriodAsString

      public final String indexRotationPeriodAsString()

      The Elasticsearch index rotation period. Index rotation appends a timestamp to IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value is OneDay.

      If the service returns an enum value that is not available in the current SDK version, indexRotationPeriod will return ElasticsearchIndexRotationPeriod.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from indexRotationPeriodAsString().

      Returns:
      The Elasticsearch index rotation period. Index rotation appends a timestamp to IndexName to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value is OneDay.
      See Also:

    • bufferingHints

      public final ElasticsearchBufferingHints bufferingHints()

      The buffering options. If no value is specified, ElasticsearchBufferingHints object default values are used.

      Returns:
      The buffering options. If no value is specified, ElasticsearchBufferingHints object default values are used.

    • retryOptions

      public final ElasticsearchRetryOptions retryOptions()

      The retry behavior in case Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).

      Returns:
      The retry behavior in case Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).

    • s3Update

      public final S3DestinationUpdate s3Update()

      The Amazon S3 destination.

      Returns:
      The Amazon S3 destination.

    • processingConfiguration

      public final ProcessingConfiguration processingConfiguration()

      The data processing configuration.

      Returns:
      The data processing configuration.

    • cloudWatchLoggingOptions

      public final CloudWatchLoggingOptions cloudWatchLoggingOptions()

      The CloudWatch logging options for your delivery stream.

      Returns:
      The CloudWatch logging options for your delivery stream.

    • documentIdOptions

      public final DocumentIdOptions documentIdOptions()

      Indicates the method for setting up document ID. The supported methods are Firehose generated document ID and OpenSearch Service generated document ID.

      Returns:
      Indicates the method for setting up document ID. The supported methods are Firehose generated document ID and OpenSearch Service generated document ID.

    • toBuilder

      public ElasticsearchDestinationUpdate.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<ElasticsearchDestinationUpdate.Builder,ElasticsearchDestinationUpdate>
      Returns:
      a builder for type T

    • builder

      public static ElasticsearchDestinationUpdate.Builder builder()

    • serializableBuilderClass

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

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String toString()
      Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final 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.