AWS Kinesis #X Amz Target=Firehose 20150804.UpdateDestination API
The #X Amz Target=Firehose 20150804.UpdateDestination API from AWS Kinesis — 1 operation(s) for #x amz target=firehose 20150804.updatedestination.
AWS Kinesis #X Amz Target=Firehose 20150804.UpdateDestination API is one of 100 APIs that AWS Kinesis publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include #X Amz Target=Firehose 20150804.UpdateDestination. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, pricing, and a getting-started guide.
This API exposes 1 operation across 1 path, and defines 130 schemas. It is described by OpenAPI 3.0.0, at version 2015-08-04.
Requests are made against 4 base URLs: http://firehose.{region}.amazonaws.com, https://firehose.{region}.amazonaws.com, http://firehose.{region}.amazonaws.com.cn, https://firehose.{region}.amazonaws.com.cn.
1 operations
1 paths
130 schemas
1 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
AWS Kinesis #X Amz Target=Firehose 20150804.UpdateDestination API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (hmac).
By default, every request must be authenticated.
hmac— Amazon Signature authorization v4
Paths & Operations 1
Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.
#X Amz Target=Firehose 20150804.UpdateDestination 1
POST
/#X-Amz-Target=Firehose_20150804.UpdateDestination
Updates the specified destination of the specified delivery stream. Use this operation to change the destination type (for example, to replace the Amazon S3 destination with Amazon Redshift) or chang…
Schemas 130
The contract defines 130 schemas that model the data the API accepts and returns. The most detailed are ExtendedS3DestinationUpdate (13 properties), RedshiftDestinationUpdate (11 properties), ElasticsearchDestinationUpdate (11 properties), UpdateDestinationInput (11 properties). Each schema is shown below with its type and property counts.
HttpEndpointBufferingHints
object
Describes the buffering options that can be applied before data is delivered to the HTTP endpoint destination. Kinesis Data Firehose treats these options as hi…
2 properties
HttpEndpointCommonAttribute
object
Describes the metadata that's delivered to the specified HTTP endpoint destination.
2 properties
2 required
HECEndpoint
string
ProcessorParameterList
array
DynamicPartitioningConfiguration
object
The configuration of the dynamic partitioning mechanism that creates smaller data sets from the streaming data by partitioning it based on partition keys. Curr…
2 properties
CloudWatchLoggingOptions
object
Describes the Amazon CloudWatch logging options for your delivery stream.
3 properties
S3BackupMode
string
AmazonopensearchserviceTypeName
string
UpdateDestinationInput
object
11 properties
3 required
OutputFormatConfiguration
object
Specifies the serializer that you want Kinesis Data Firehose to use to convert the format of your data before it writes it to Amazon S3. This parameter is requ…
1 property
HttpEndpointCommonAttributesList
array
LogGroupName
string
HttpEndpointAccessKey
string
AmazonopensearchserviceBufferingHints
object
Describes the buffering to perform before delivering data to the Amazon OpenSearch Service destination.
2 properties
HttpEndpointRetryDurationInSeconds
integer
AmazonOpenSearchServerlessBufferingHints
object
Describes the buffering to perform before delivering data to the Serverless offering for Amazon OpenSearch Service destination.
2 properties
Processor
object
Describes a data processor.
2 properties
1 required
NonEmptyString
string
CopyOptions
string
ProcessorType
string
AmazonopensearchserviceBufferingSizeInMBs
integer
RedshiftS3BackupMode
string
OrcCompression
string
OrcStripeSizeBytes
integer
ProcessorParameter
object
Describes the processor parameter.
2 properties
2 required
InputFormatConfiguration
object
Specifies the deserializer you want to use to convert the format of the input data. This parameter is required if Enabled is set to true.
1 property
HttpEndpointUrl
string
HiveJsonSerDe
object
The native Hive / HCatalog JsonSerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for s…
1 property
DataTableName
string
ElasticsearchRetryOptions
object
Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon ES.
1 property
ElasticsearchIndexRotationPeriod
string
OrcRowIndexStride
integer
ElasticsearchDomainARN
string
HECToken
string
AmazonOpenSearchServerlessDestinationUpdate
object
Describes an update for a destination in the Serverless offering for Amazon OpenSearch Service.
8 properties
AmazonopensearchserviceRetryOptions
object
Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon OpenSearch Service.
1 property
CopyCommand
object
Describes a COPY command for Amazon Redshift.
3 properties
1 required
HECEndpointType
string
SplunkRetryOptions
object
Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Splunk, or if it doesn't receive an acknowledgment from Splunk.
1 property
ProcessorParameterName
string
DeliveryStreamVersionId
string
HttpEndpointS3BackupMode
string
KMSEncryptionConfig
object
Describes an encryption key for a destination in Amazon S3.
1 property
1 required
RetryDurationInSeconds
integer
SplunkDestinationUpdate
object
Describes an update for a destination in Splunk.
9 properties
ConcurrentModificationException
HttpEndpointAttributeName
string
HECAcknowledgmentTimeoutInSeconds
integer
LogStreamName
string
ParquetPageSizeBytes
integer
Password
string
RedshiftRetryOptions
object
Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to Amazon Redshift.
1 property
DestinationId
string
ElasticsearchClusterEndpoint
string
HttpEndpointConfiguration
object
Describes the configuration of the HTTP endpoint to which Kinesis Firehose delivers data.
3 properties
1 required
AmazonOpenSearchServerlessBufferingSizeInMBs
integer
ProcessingConfiguration
object
Describes a data processing configuration.
2 properties
Prefix
string
AWSKMSKeyARN
string
OpenXJsonSerDe
object
The OpenX SerDe. Used by Kinesis Data Firehose for deserializing data, which means converting it from the JSON format in preparation for serializing it to the…
3 properties
ElasticsearchBufferingIntervalInSeconds
integer
ListOfNonEmptyStringsWithoutWhitespace
array
RedshiftRetryDurationInSeconds
integer
EncryptionConfiguration
object
Describes the encryption for a destination in Amazon S3.
2 properties
HttpEndpointRequestConfiguration
object
The configuration of the HTTP endpoint request.
2 properties
SizeInMBs
integer
HttpEndpointBufferingSizeInMBs
integer
ClusterJDBCURL
string
RedshiftDestinationUpdate
object
Describes an update for a destination in Amazon Redshift.
11 properties
NonEmptyStringWithoutWhitespace
string
ElasticsearchBufferingHints
object
Describes the buffering to perform before delivering data to the Amazon ES destination.
2 properties
Serializer
object
The serializer that you want Kinesis Data Firehose to use to convert data to the target format before writing it to Amazon S3. Kinesis Data Firehose supports t…
2 properties
HttpEndpointDestinationUpdate
object
Updates the specified HTTP endpoint destination.
9 properties
ErrorOutputPrefix
string
ColumnToJsonKeyMappings
object
DataFormatConversionConfiguration
object
Specifies that you want Kinesis Data Firehose to convert data from the JSON format to the Parquet or ORC format before writing it to Amazon S3. Kinesis Data Fi…
4 properties
ProcessorList
array
SchemaConfiguration
object
Specifies the schema to which you want Kinesis Data Firehose to configure your data before it writes it to Amazon S3. This parameter is required if Enabled is…
6 properties
S3DestinationUpdate
object
Describes an update for a destination in Amazon S3.
8 properties
IntervalInSeconds
integer
Username
string
DataTableColumns
string
HttpEndpointAttributeValue
string
RoleARN
string
HttpEndpointRetryOptions
object
Describes the retry behavior in case Kinesis Data Firehose is unable to deliver data to the specified HTTP endpoint destination, or if it doesn't receive a val…
1 property
ResourceNotFoundException
ResourceInUseException
AmazonOpenSearchServerlessRetryOptions
object
Configures retry behavior in case Kinesis Data Firehose is unable to deliver documents to the Serverless offering for Amazon OpenSearch Service.
1 property
AmazonOpenSearchServerlessRetryDurationInSeconds
integer
RetryOptions
object
The retry behavior in case Kinesis Data Firehose is unable to deliver data to an Amazon S3 prefix.
1 property
ListOfNonEmptyStrings
array
AmazonopensearchserviceIndexName
string
Proportion
number
DeliveryStreamName
string
ElasticsearchRetryDurationInSeconds
integer
ParquetSerDe
object
A serializer to use for converting data to the Parquet format before storing it in Amazon S3. For more information, see Apache Parquet .
6 properties
ExtendedS3DestinationUpdate
object
Describes an update for a destination in Amazon S3.
13 properties
OrcSerDe
object
A serializer to use for converting data to the ORC format before storing it in Amazon S3. For more information, see Apache ORC .
10 properties
SplunkS3BackupMode
string
ElasticsearchBufferingSizeInMBs
integer
OrcFormatVersion
string
AmazonOpenSearchServerlessCollectionEndpoint
string
AmazonopensearchserviceDomainARN
string
CompressionFormat
string
AmazonopensearchserviceBufferingIntervalInSeconds
integer
BucketARN
string
ElasticsearchDestinationUpdate
object
Describes an update for a destination in Amazon ES.
11 properties
Deserializer
object
The deserializer you want Kinesis Data Firehose to use for converting the input data from JSON. Kinesis Data Firehose then serializes the data to its final for…
2 properties
ElasticsearchIndexName
string
InvalidArgumentException
NonNegativeIntegerObject
integer
NoEncryptionConfig
string
HttpEndpointBufferingIntervalInSeconds
integer
HttpEndpointName
string
BooleanObject
boolean
ProcessorParameterValue
string
ContentEncoding
string
UpdateDestinationOutput
object
AmazonOpenSearchServerlessBufferingIntervalInSeconds
integer
BufferingHints
object
Describes hints for the buffering to perform before delivering data to the destination. These options are treated as hints, and therefore Kinesis Data Firehose…
2 properties
AmazonopensearchserviceClusterEndpoint
string
AmazonopensearchserviceDestinationUpdate
object
Describes an update for a destination in Amazon OpenSearch Service.
11 properties
AmazonopensearchserviceIndexRotationPeriod
string
ElasticsearchTypeName
string
AmazonopensearchserviceRetryDurationInSeconds
integer
BlockSizeBytes
integer
ParquetCompression
string
AmazonOpenSearchServerlessIndexName
string
SplunkRetryDurationInSeconds
integer
ParquetWriterVersion
string
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from AWS Kinesis 12
Other APIs AWS Kinesis publishes across the network.
Amazon Managed Service for Apache Flink API
AWS Kinesis CreateSignalingChannel API
AWS Kinesis CreateStream API
AWS Kinesis DeleteSignalingChannel API
AWS Kinesis DeleteStream API
AWS Kinesis DescribeEdgeConfiguration API
AWS Kinesis DescribeImageGenerationConfiguration API
AWS Kinesis DescribeMappedResourceConfiguration API
AWS Kinesis DescribeMediaStorageConfiguration API
AWS Kinesis DescribeNotificationConfiguration API
AWS Kinesis DescribeSignalingChannel API
AWS Kinesis DescribeStream API
##X Amz Target=Firehose 20150804.UpdateDestination