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 OpenSearch Service.

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 OpenSearch Service 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 OpenSearch Service 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 OpenSearch Service 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 OpenSearch Service 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 Firehose stream, Firehose still delivers data to Elasticsearch with the old index name and type name. If you want to update your Firehose 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 Firehose stream, Firehose still delivers data to Elasticsearch with the old index name and type name. If you want to update your Firehose 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 OpenSearch Service 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 OpenSearch Service 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 OpenSearch Service 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 OpenSearch Service 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 OpenSearch Service. The default value is 300 (5 minutes).

      Returns:
      The retry behavior in case Firehose is unable to deliver documents to Amazon OpenSearch Service. 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 Firehose stream.

      Returns:
      The CloudWatch logging options for your Firehose 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.

    • sdkFieldNameToField

      public final Map<String,SdkField<?>> sdkFieldNameToField()
      Specified by:
      sdkFieldNameToField in interface SdkPojo
      Returns:
      The mapping between the field name and its corresponding field.