NAME
Paws::Firehose::ElasticsearchDestinationConfiguration
USAGE
This class represents one of two things:
Arguments in a call to a service
Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object.
As an example, if Att1 is expected to be a Paws::Firehose::ElasticsearchDestinationConfiguration object:
$service_obj->Method(Att1 => { BufferingHints => $value, ..., VpcConfiguration => $value });
Results returned from an API call
Use accessors for each attribute. If Att1 is expected to be an Paws::Firehose::ElasticsearchDestinationConfiguration object:
$result = $service_obj->Method(...);
$result->Att1->BufferingHints
DESCRIPTION
Describes the configuration of a destination in Amazon ES.
ATTRIBUTES
BufferingHints => Paws::Firehose::ElasticsearchBufferingHints
The buffering options. If no value is specified, the default values for ElasticsearchBufferingHints
are used.
CloudWatchLoggingOptions => Paws::Firehose::CloudWatchLoggingOptions
The Amazon CloudWatch logging options for your delivery stream.
ClusterEndpoint => Str
The endpoint to use when communicating with the cluster. Specify either this ClusterEndpoint
or the DomainARN
field.
DomainARN => Str
The ARN of the Amazon ES domain. The IAM role must have permissions for DescribeElasticsearchDomain
, DescribeElasticsearchDomains
, and DescribeElasticsearchDomainConfig
after assuming the role specified in RoleARN. For more information, see Amazon Resource Names (ARNs) and AWS Service Namespaces (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
Specify either ClusterEndpoint
or DomainARN
.
REQUIRED IndexName => Str
The Elasticsearch index name.
IndexRotationPeriod => Str
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 (https://docs.aws.amazon.com/firehose/latest/dev/basic-deliver.html#es-index-rotation). The default value is OneDay
.
ProcessingConfiguration => Paws::Firehose::ProcessingConfiguration
The data processing configuration.
RetryOptions => Paws::Firehose::ElasticsearchRetryOptions
The retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon ES. The default value is 300 (5 minutes).
REQUIRED RoleARN => Str
The Amazon Resource Name (ARN) of the IAM role to be assumed by Kinesis Data Firehose for calling the Amazon ES Configuration API and for indexing documents. For more information, see Grant Kinesis Data Firehose Access to an Amazon S3 Destination (https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3) and Amazon Resource Names (ARNs) and AWS Service Namespaces (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
S3BackupMode => Str
Defines how documents should be delivered to Amazon S3. When it is set to FailedDocumentsOnly
, Kinesis Data Firehose writes any documents that could not be indexed to the configured Amazon S3 destination, with elasticsearch-failed/
appended to the key prefix. When set to AllDocuments
, Kinesis Data Firehose delivers all incoming records to Amazon S3, and also writes failed documents with elasticsearch-failed/
appended to the prefix. For more information, see Amazon S3 Backup for the Amazon ES Destination (https://docs.aws.amazon.com/firehose/latest/dev/basic-deliver.html#es-s3-backup). Default value is FailedDocumentsOnly
.
You can't change this backup mode after you create the delivery stream.
REQUIRED S3Configuration => Paws::Firehose::S3DestinationConfiguration
The configuration for the backup Amazon S3 location.
TypeName => Str
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, Kinesis Data Firehose returns an error during run time.
For Elasticsearch 7.x, don't specify a TypeName
.
VpcConfiguration => Paws::Firehose::VpcConfiguration
The details of the VPC of the Amazon ES destination.
SEE ALSO
This class forms part of Paws, describing an object used in Paws::Firehose
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues