Interface ElasticsearchDestinationUpdate.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<ElasticsearchDestinationUpdate.Builder,
,ElasticsearchDestinationUpdate> SdkBuilder<ElasticsearchDestinationUpdate.Builder,
,ElasticsearchDestinationUpdate> SdkPojo
- Enclosing class:
ElasticsearchDestinationUpdate
-
Method Summary
Modifier and TypeMethodDescriptionbufferingHints
(Consumer<ElasticsearchBufferingHints.Builder> bufferingHints) The buffering options.bufferingHints
(ElasticsearchBufferingHints bufferingHints) The buffering options.cloudWatchLoggingOptions
(Consumer<CloudWatchLoggingOptions.Builder> cloudWatchLoggingOptions) The CloudWatch logging options for your delivery stream.cloudWatchLoggingOptions
(CloudWatchLoggingOptions cloudWatchLoggingOptions) The CloudWatch logging options for your delivery stream.clusterEndpoint
(String clusterEndpoint) The endpoint to use when communicating with the cluster.documentIdOptions
(Consumer<DocumentIdOptions.Builder> documentIdOptions) Indicates the method for setting up document ID.documentIdOptions
(DocumentIdOptions documentIdOptions) Indicates the method for setting up document ID.The ARN of the Amazon ES domain.The Elasticsearch index name.indexRotationPeriod
(String indexRotationPeriod) The Elasticsearch index rotation period.indexRotationPeriod
(ElasticsearchIndexRotationPeriod indexRotationPeriod) The Elasticsearch index rotation period.processingConfiguration
(Consumer<ProcessingConfiguration.Builder> processingConfiguration) The data processing configuration.processingConfiguration
(ProcessingConfiguration processingConfiguration) The data processing configuration.retryOptions
(Consumer<ElasticsearchRetryOptions.Builder> retryOptions) The retry behavior in case Firehose is unable to deliver documents to Amazon ES.retryOptions
(ElasticsearchRetryOptions retryOptions) The retry behavior in case Firehose is unable to deliver documents to Amazon ES.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.s3Update
(Consumer<S3DestinationUpdate.Builder> s3Update) The Amazon S3 destination.s3Update
(S3DestinationUpdate s3Update) The Amazon S3 destination.The Elasticsearch type name.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
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.
- Parameters:
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:
- Returns a reference to this object so that method calls can be chained together.
-
domainARN
The ARN of the Amazon ES domain. The IAM role must have permissions for
DescribeDomain
,DescribeDomains
, andDescribeDomainConfig
after assuming the IAM role specified inRoleARN
. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.Specify either
ClusterEndpoint
orDomainARN
.- Parameters:
domainARN
- The ARN of the Amazon ES domain. The IAM role must have permissions forDescribeDomain
,DescribeDomains
, andDescribeDomainConfig
after assuming the IAM role specified inRoleARN
. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.Specify either
ClusterEndpoint
orDomainARN
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
clusterEndpoint
The endpoint to use when communicating with the cluster. Specify either this
ClusterEndpoint
or theDomainARN
field.- Parameters:
clusterEndpoint
- The endpoint to use when communicating with the cluster. Specify either thisClusterEndpoint
or theDomainARN
field.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
indexName
The Elasticsearch index name.
- Parameters:
indexName
- The Elasticsearch index name.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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
.- Parameters:
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:
- Returns a reference to this object so that method calls can be chained together.
-
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 isOneDay
.- Parameters:
indexRotationPeriod
- The Elasticsearch index rotation period. Index rotation appends a timestamp toIndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value isOneDay
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
indexRotationPeriod
ElasticsearchDestinationUpdate.Builder indexRotationPeriod(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 isOneDay
.- Parameters:
indexRotationPeriod
- The Elasticsearch index rotation period. Index rotation appends a timestamp toIndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. Default value isOneDay
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
bufferingHints
The buffering options. If no value is specified,
ElasticsearchBufferingHints
object default values are used.- Parameters:
bufferingHints
- The buffering options. If no value is specified,ElasticsearchBufferingHints
object default values are used.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
bufferingHints
default ElasticsearchDestinationUpdate.Builder bufferingHints(Consumer<ElasticsearchBufferingHints.Builder> bufferingHints) The buffering options. If no value is specified,
This is a convenience method that creates an instance of theElasticsearchBufferingHints
object default values are used.ElasticsearchBufferingHints.Builder
avoiding the need to create one manually viaElasticsearchBufferingHints.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tobufferingHints(ElasticsearchBufferingHints)
.- Parameters:
bufferingHints
- a consumer that will call methods onElasticsearchBufferingHints.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
retryOptions
The retry behavior in case Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).
- Parameters:
retryOptions
- The retry behavior in case Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
retryOptions
default ElasticsearchDestinationUpdate.Builder retryOptions(Consumer<ElasticsearchRetryOptions.Builder> retryOptions) The retry behavior in case Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).
This is a convenience method that creates an instance of theElasticsearchRetryOptions.Builder
avoiding the need to create one manually viaElasticsearchRetryOptions.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toretryOptions(ElasticsearchRetryOptions)
.- Parameters:
retryOptions
- a consumer that will call methods onElasticsearchRetryOptions.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
s3Update
The Amazon S3 destination.
- Parameters:
s3Update
- The Amazon S3 destination.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
s3Update
default ElasticsearchDestinationUpdate.Builder s3Update(Consumer<S3DestinationUpdate.Builder> s3Update) The Amazon S3 destination.
This is a convenience method that creates an instance of theS3DestinationUpdate.Builder
avoiding the need to create one manually viaS3DestinationUpdate.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tos3Update(S3DestinationUpdate)
.- Parameters:
s3Update
- a consumer that will call methods onS3DestinationUpdate.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
processingConfiguration
ElasticsearchDestinationUpdate.Builder processingConfiguration(ProcessingConfiguration processingConfiguration) The data processing configuration.
- Parameters:
processingConfiguration
- The data processing configuration.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
processingConfiguration
default ElasticsearchDestinationUpdate.Builder processingConfiguration(Consumer<ProcessingConfiguration.Builder> processingConfiguration) The data processing configuration.
This is a convenience method that creates an instance of theProcessingConfiguration.Builder
avoiding the need to create one manually viaProcessingConfiguration.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toprocessingConfiguration(ProcessingConfiguration)
.- Parameters:
processingConfiguration
- a consumer that will call methods onProcessingConfiguration.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
cloudWatchLoggingOptions
ElasticsearchDestinationUpdate.Builder cloudWatchLoggingOptions(CloudWatchLoggingOptions cloudWatchLoggingOptions) The CloudWatch logging options for your delivery stream.
- Parameters:
cloudWatchLoggingOptions
- The CloudWatch logging options for your delivery stream.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
cloudWatchLoggingOptions
default ElasticsearchDestinationUpdate.Builder cloudWatchLoggingOptions(Consumer<CloudWatchLoggingOptions.Builder> cloudWatchLoggingOptions) The CloudWatch logging options for your delivery stream.
This is a convenience method that creates an instance of theCloudWatchLoggingOptions.Builder
avoiding the need to create one manually viaCloudWatchLoggingOptions.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tocloudWatchLoggingOptions(CloudWatchLoggingOptions)
.- Parameters:
cloudWatchLoggingOptions
- a consumer that will call methods onCloudWatchLoggingOptions.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
documentIdOptions
Indicates the method for setting up document ID. The supported methods are Firehose generated document ID and OpenSearch Service generated document ID.
- Parameters:
documentIdOptions
- Indicates the method for setting up document ID. The supported methods are Firehose generated document ID and OpenSearch Service generated document ID.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
documentIdOptions
default ElasticsearchDestinationUpdate.Builder documentIdOptions(Consumer<DocumentIdOptions.Builder> documentIdOptions) Indicates the method for setting up document ID. The supported methods are Firehose generated document ID and OpenSearch Service generated document ID.
This is a convenience method that creates an instance of theDocumentIdOptions.Builder
avoiding the need to create one manually viaDocumentIdOptions.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed todocumentIdOptions(DocumentIdOptions)
.- Parameters:
documentIdOptions
- a consumer that will call methods onDocumentIdOptions.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-