Class ElasticsearchDestinationConfiguration
- java.lang.Object
-
- software.amazon.awssdk.services.firehose.model.ElasticsearchDestinationConfiguration
-
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<ElasticsearchDestinationConfiguration.Builder,ElasticsearchDestinationConfiguration>
@Generated("software.amazon.awssdk:codegen") public final class ElasticsearchDestinationConfiguration extends Object implements SdkPojo, Serializable, ToCopyableBuilder<ElasticsearchDestinationConfiguration.Builder,ElasticsearchDestinationConfiguration>
Describes the configuration of a destination in Amazon ES.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
ElasticsearchDestinationConfiguration.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description ElasticsearchBufferingHints
bufferingHints()
The buffering options.static ElasticsearchDestinationConfiguration.Builder
builder()
CloudWatchLoggingOptions
cloudWatchLoggingOptions()
The Amazon CloudWatch logging options for your delivery stream.String
clusterEndpoint()
The endpoint to use when communicating with the cluster.DocumentIdOptions
documentIdOptions()
Indicates the method for setting up document ID.String
domainARN()
The ARN of the Amazon ES domain.boolean
equals(Object obj)
boolean
equalsBySdkFields(Object obj)
<T> Optional<T>
getValueForField(String fieldName, Class<T> clazz)
int
hashCode()
String
indexName()
The Elasticsearch index name.ElasticsearchIndexRotationPeriod
indexRotationPeriod()
The Elasticsearch index rotation period.String
indexRotationPeriodAsString()
The Elasticsearch index rotation period.ProcessingConfiguration
processingConfiguration()
The data processing configuration.ElasticsearchRetryOptions
retryOptions()
The retry behavior in case Firehose is unable to deliver documents to Amazon ES.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.ElasticsearchS3BackupMode
s3BackupMode()
Defines how documents should be delivered to Amazon S3.String
s3BackupModeAsString()
Defines how documents should be delivered to Amazon S3.S3DestinationConfiguration
s3Configuration()
The configuration for the backup Amazon S3 location.List<SdkField<?>>
sdkFields()
static Class<? extends ElasticsearchDestinationConfiguration.Builder>
serializableBuilderClass()
ElasticsearchDestinationConfiguration.Builder
toBuilder()
String
toString()
Returns a string representation of this object.String
typeName()
The Elasticsearch type name.VpcConfiguration
vpcConfiguration()
The details of the VPC of the Amazon destination.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
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
, andDescribeDomainConfig
after assuming the role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.Specify either
ClusterEndpoint
orDomainARN
.- Returns:
- The ARN of the Amazon ES domain. The IAM role must have permissions for
DescribeDomain
,DescribeDomains
, andDescribeDomainConfig
after assuming the role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and Amazon Web Services Service Namespaces.Specify either
ClusterEndpoint
orDomainARN
.
-
clusterEndpoint
public final String clusterEndpoint()
The endpoint to use when communicating with the cluster. Specify either this
ClusterEndpoint
or theDomainARN
field.- Returns:
- The endpoint to use when communicating with the cluster. Specify either this
ClusterEndpoint
or theDomainARN
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 run time.
For Elasticsearch 7.x, don't specify a
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
run time.
For Elasticsearch 7.x, don't specify a
TypeName
.
-
indexRotationPeriod
public final ElasticsearchIndexRotationPeriod indexRotationPeriod()
The Elasticsearch index rotation period. Index rotation appends a timestamp to the
IndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. The default value isOneDay
.If the service returns an enum value that is not available in the current SDK version,
indexRotationPeriod
will returnElasticsearchIndexRotationPeriod.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromindexRotationPeriodAsString()
.- Returns:
- The Elasticsearch index rotation period. Index rotation appends a timestamp to the
IndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. The default value isOneDay
. - See Also:
ElasticsearchIndexRotationPeriod
-
indexRotationPeriodAsString
public final String indexRotationPeriodAsString()
The Elasticsearch index rotation period. Index rotation appends a timestamp to the
IndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. The default value isOneDay
.If the service returns an enum value that is not available in the current SDK version,
indexRotationPeriod
will returnElasticsearchIndexRotationPeriod.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromindexRotationPeriodAsString()
.- Returns:
- The Elasticsearch index rotation period. Index rotation appends a timestamp to the
IndexName
to facilitate the expiration of old data. For more information, see Index Rotation for the Amazon ES Destination. The default value isOneDay
. - See Also:
ElasticsearchIndexRotationPeriod
-
bufferingHints
public final ElasticsearchBufferingHints bufferingHints()
The buffering options. If no value is specified, the default values for
ElasticsearchBufferingHints
are used.- Returns:
- The buffering options. If no value is specified, the default values for
ElasticsearchBufferingHints
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).
-
s3BackupMode
public final ElasticsearchS3BackupMode s3BackupMode()
Defines how documents should be delivered to Amazon S3. When it is set to
FailedDocumentsOnly
, Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, withAmazonOpenSearchService-failed/
appended to the key prefix. When set toAllDocuments
, Firehose delivers all incoming records to Amazon S3, and also writes failed documents withAmazonOpenSearchService-failed/
appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination. Default value isFailedDocumentsOnly
.You can't change this backup mode after you create the delivery stream.
If the service returns an enum value that is not available in the current SDK version,
s3BackupMode
will returnElasticsearchS3BackupMode.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available froms3BackupModeAsString()
.- Returns:
- Defines how documents should be delivered to Amazon S3. When it is set to
FailedDocumentsOnly
, Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, withAmazonOpenSearchService-failed/
appended to the key prefix. When set toAllDocuments
, Firehose delivers all incoming records to Amazon S3, and also writes failed documents withAmazonOpenSearchService-failed/
appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination. Default value isFailedDocumentsOnly
.You can't change this backup mode after you create the delivery stream.
- See Also:
ElasticsearchS3BackupMode
-
s3BackupModeAsString
public final String s3BackupModeAsString()
Defines how documents should be delivered to Amazon S3. When it is set to
FailedDocumentsOnly
, Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, withAmazonOpenSearchService-failed/
appended to the key prefix. When set toAllDocuments
, Firehose delivers all incoming records to Amazon S3, and also writes failed documents withAmazonOpenSearchService-failed/
appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination. Default value isFailedDocumentsOnly
.You can't change this backup mode after you create the delivery stream.
If the service returns an enum value that is not available in the current SDK version,
s3BackupMode
will returnElasticsearchS3BackupMode.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available froms3BackupModeAsString()
.- Returns:
- Defines how documents should be delivered to Amazon S3. When it is set to
FailedDocumentsOnly
, Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, withAmazonOpenSearchService-failed/
appended to the key prefix. When set toAllDocuments
, Firehose delivers all incoming records to Amazon S3, and also writes failed documents withAmazonOpenSearchService-failed/
appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination. Default value isFailedDocumentsOnly
.You can't change this backup mode after you create the delivery stream.
- See Also:
ElasticsearchS3BackupMode
-
s3Configuration
public final S3DestinationConfiguration s3Configuration()
The configuration for the backup Amazon S3 location.
- Returns:
- The configuration for the backup Amazon S3 location.
-
processingConfiguration
public final ProcessingConfiguration processingConfiguration()
The data processing configuration.
- Returns:
- The data processing configuration.
-
cloudWatchLoggingOptions
public final CloudWatchLoggingOptions cloudWatchLoggingOptions()
The Amazon CloudWatch logging options for your delivery stream.
- Returns:
- The Amazon CloudWatch logging options for your delivery stream.
-
vpcConfiguration
public final VpcConfiguration vpcConfiguration()
The details of the VPC of the Amazon destination.
- Returns:
- The details of the VPC of the Amazon destination.
-
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 ElasticsearchDestinationConfiguration.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<ElasticsearchDestinationConfiguration.Builder,ElasticsearchDestinationConfiguration>
-
builder
public static ElasticsearchDestinationConfiguration.Builder builder()
-
serializableBuilderClass
public static Class<? extends ElasticsearchDestinationConfiguration.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in interfaceSdkPojo
-
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.
-
-