DescribeDeliveryStreamCommand

Describes the specified Firehose stream and its status. For example, after your Firehose stream is created, call DescribeDeliveryStream to see whether the Firehose stream is ACTIVE and therefore ready for data to be sent to it.

If the status of a Firehose stream is CREATING_FAILED, this status doesn't change, and you can't invoke CreateDeliveryStream again on it. However, you can invoke the DeleteDeliveryStream operation to delete it. If the status is DELETING_FAILED, you can force deletion by invoking DeleteDeliveryStream again but with DeleteDeliveryStreamInput$AllowForceDelete set to true.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { FirehoseClient, DescribeDeliveryStreamCommand } from "@aws-sdk/client-firehose"; // ES Modules import
// const { FirehoseClient, DescribeDeliveryStreamCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
const client = new FirehoseClient(config);
const input = { // DescribeDeliveryStreamInput
  DeliveryStreamName: "STRING_VALUE", // required
  Limit: Number("int"),
  ExclusiveStartDestinationId: "STRING_VALUE",
};
const command = new DescribeDeliveryStreamCommand(input);
const response = await client.send(command);
// { // DescribeDeliveryStreamOutput
//   DeliveryStreamDescription: { // DeliveryStreamDescription
//     DeliveryStreamName: "STRING_VALUE", // required
//     DeliveryStreamARN: "STRING_VALUE", // required
//     DeliveryStreamStatus: "CREATING" || "CREATING_FAILED" || "DELETING" || "DELETING_FAILED" || "ACTIVE", // required
//     FailureDescription: { // FailureDescription
//       Type: "VPC_ENDPOINT_SERVICE_NAME_NOT_FOUND" || "VPC_INTERFACE_ENDPOINT_SERVICE_ACCESS_DENIED" || "RETIRE_KMS_GRANT_FAILED" || "CREATE_KMS_GRANT_FAILED" || "KMS_ACCESS_DENIED" || "DISABLED_KMS_KEY" || "INVALID_KMS_KEY" || "KMS_KEY_NOT_FOUND" || "KMS_OPT_IN_REQUIRED" || "CREATE_ENI_FAILED" || "DELETE_ENI_FAILED" || "SUBNET_NOT_FOUND" || "SECURITY_GROUP_NOT_FOUND" || "ENI_ACCESS_DENIED" || "SUBNET_ACCESS_DENIED" || "SECURITY_GROUP_ACCESS_DENIED" || "UNKNOWN_ERROR", // required
//       Details: "STRING_VALUE", // required
//     },
//     DeliveryStreamEncryptionConfiguration: { // DeliveryStreamEncryptionConfiguration
//       KeyARN: "STRING_VALUE",
//       KeyType: "AWS_OWNED_CMK" || "CUSTOMER_MANAGED_CMK",
//       Status: "ENABLED" || "ENABLING" || "ENABLING_FAILED" || "DISABLED" || "DISABLING" || "DISABLING_FAILED",
//       FailureDescription: {
//         Type: "VPC_ENDPOINT_SERVICE_NAME_NOT_FOUND" || "VPC_INTERFACE_ENDPOINT_SERVICE_ACCESS_DENIED" || "RETIRE_KMS_GRANT_FAILED" || "CREATE_KMS_GRANT_FAILED" || "KMS_ACCESS_DENIED" || "DISABLED_KMS_KEY" || "INVALID_KMS_KEY" || "KMS_KEY_NOT_FOUND" || "KMS_OPT_IN_REQUIRED" || "CREATE_ENI_FAILED" || "DELETE_ENI_FAILED" || "SUBNET_NOT_FOUND" || "SECURITY_GROUP_NOT_FOUND" || "ENI_ACCESS_DENIED" || "SUBNET_ACCESS_DENIED" || "SECURITY_GROUP_ACCESS_DENIED" || "UNKNOWN_ERROR", // required
//         Details: "STRING_VALUE", // required
//       },
//     },
//     DeliveryStreamType: "DirectPut" || "KinesisStreamAsSource" || "MSKAsSource" || "DatabaseAsSource", // required
//     VersionId: "STRING_VALUE", // required
//     CreateTimestamp: new Date("TIMESTAMP"),
//     LastUpdateTimestamp: new Date("TIMESTAMP"),
//     Source: { // SourceDescription
//       DirectPutSourceDescription: { // DirectPutSourceDescription
//         ThroughputHintInMBs: Number("int"),
//       },
//       KinesisStreamSourceDescription: { // KinesisStreamSourceDescription
//         KinesisStreamARN: "STRING_VALUE",
//         RoleARN: "STRING_VALUE",
//         DeliveryStartTimestamp: new Date("TIMESTAMP"),
//       },
//       MSKSourceDescription: { // MSKSourceDescription
//         MSKClusterARN: "STRING_VALUE",
//         TopicName: "STRING_VALUE",
//         AuthenticationConfiguration: { // AuthenticationConfiguration
//           RoleARN: "STRING_VALUE", // required
//           Connectivity: "PUBLIC" || "PRIVATE", // required
//         },
//         DeliveryStartTimestamp: new Date("TIMESTAMP"),
//         ReadFromTimestamp: new Date("TIMESTAMP"),
//       },
//       DatabaseSourceDescription: { // DatabaseSourceDescription
//         Type: "MySQL" || "PostgreSQL",
//         Endpoint: "STRING_VALUE",
//         Port: Number("int"),
//         SSLMode: "Disabled" || "Enabled",
//         Databases: { // DatabaseList
//           Include: [ // DatabaseIncludeOrExcludeList
//             "STRING_VALUE",
//           ],
//           Exclude: [
//             "STRING_VALUE",
//           ],
//         },
//         Tables: { // DatabaseTableList
//           Include: [ // DatabaseTableIncludeOrExcludeList
//             "STRING_VALUE",
//           ],
//           Exclude: [
//             "STRING_VALUE",
//           ],
//         },
//         Columns: { // DatabaseColumnList
//           Include: [ // DatabaseColumnIncludeOrExcludeList
//             "STRING_VALUE",
//           ],
//           Exclude: [
//             "STRING_VALUE",
//           ],
//         },
//         SurrogateKeys: [
//           "STRING_VALUE",
//         ],
//         SnapshotWatermarkTable: "STRING_VALUE",
//         SnapshotInfo: [ // DatabaseSnapshotInfoList
//           { // DatabaseSnapshotInfo
//             Id: "STRING_VALUE", // required
//             Table: "STRING_VALUE", // required
//             RequestTimestamp: new Date("TIMESTAMP"), // required
//             RequestedBy: "USER" || "FIREHOSE", // required
//             Status: "IN_PROGRESS" || "COMPLETE" || "SUSPENDED", // required
//             FailureDescription: "<FailureDescription>",
//           },
//         ],
//         DatabaseSourceAuthenticationConfiguration: { // DatabaseSourceAuthenticationConfiguration
//           SecretsManagerConfiguration: { // SecretsManagerConfiguration
//             SecretARN: "STRING_VALUE",
//             RoleARN: "STRING_VALUE",
//             Enabled: true || false, // required
//           },
//         },
//         DatabaseSourceVPCConfiguration: { // DatabaseSourceVPCConfiguration
//           VpcEndpointServiceName: "STRING_VALUE", // required
//         },
//       },
//     },
//     Destinations: [ // DestinationDescriptionList // required
//       { // DestinationDescription
//         DestinationId: "STRING_VALUE", // required
//         S3DestinationDescription: { // S3DestinationDescription
//           RoleARN: "STRING_VALUE", // required
//           BucketARN: "STRING_VALUE", // required
//           Prefix: "STRING_VALUE",
//           ErrorOutputPrefix: "STRING_VALUE",
//           BufferingHints: { // BufferingHints
//             SizeInMBs: Number("int"),
//             IntervalInSeconds: Number("int"),
//           },
//           CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//           EncryptionConfiguration: { // EncryptionConfiguration
//             NoEncryptionConfig: "NoEncryption",
//             KMSEncryptionConfig: { // KMSEncryptionConfig
//               AWSKMSKeyARN: "STRING_VALUE", // required
//             },
//           },
//           CloudWatchLoggingOptions: { // CloudWatchLoggingOptions
//             Enabled: true || false,
//             LogGroupName: "STRING_VALUE",
//             LogStreamName: "STRING_VALUE",
//           },
//         },
//         ExtendedS3DestinationDescription: { // ExtendedS3DestinationDescription
//           RoleARN: "STRING_VALUE", // required
//           BucketARN: "STRING_VALUE", // required
//           Prefix: "STRING_VALUE",
//           ErrorOutputPrefix: "STRING_VALUE",
//           BufferingHints: {
//             SizeInMBs: Number("int"),
//             IntervalInSeconds: Number("int"),
//           },
//           CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//           EncryptionConfiguration: {
//             NoEncryptionConfig: "NoEncryption",
//             KMSEncryptionConfig: {
//               AWSKMSKeyARN: "STRING_VALUE", // required
//             },
//           },
//           CloudWatchLoggingOptions: {
//             Enabled: true || false,
//             LogGroupName: "STRING_VALUE",
//             LogStreamName: "STRING_VALUE",
//           },
//           ProcessingConfiguration: { // ProcessingConfiguration
//             Enabled: true || false,
//             Processors: [ // ProcessorList
//               { // Processor
//                 Type: "RecordDeAggregation" || "Decompression" || "CloudWatchLogProcessing" || "Lambda" || "MetadataExtraction" || "AppendDelimiterToRecord", // required
//                 Parameters: [ // ProcessorParameterList
//                   { // ProcessorParameter
//                     ParameterName: "LambdaArn" || "NumberOfRetries" || "MetadataExtractionQuery" || "JsonParsingEngine" || "RoleArn" || "BufferSizeInMBs" || "BufferIntervalInSeconds" || "SubRecordType" || "Delimiter" || "CompressionFormat" || "DataMessageExtraction", // required
//                     ParameterValue: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//             ],
//           },
//           S3BackupMode: "Disabled" || "Enabled",
//           S3BackupDescription: {
//             RoleARN: "STRING_VALUE", // required
//             BucketARN: "STRING_VALUE", // required
//             Prefix: "STRING_VALUE",
//             ErrorOutputPrefix: "STRING_VALUE",
//             BufferingHints: {
//               SizeInMBs: Number("int"),
//               IntervalInSeconds: Number("int"),
//             },
//             CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//             EncryptionConfiguration: {
//               NoEncryptionConfig: "NoEncryption",
//               KMSEncryptionConfig: {
//                 AWSKMSKeyARN: "STRING_VALUE", // required
//               },
//             },
//             CloudWatchLoggingOptions: {
//               Enabled: true || false,
//               LogGroupName: "STRING_VALUE",
//               LogStreamName: "STRING_VALUE",
//             },
//           },
//           DataFormatConversionConfiguration: { // DataFormatConversionConfiguration
//             SchemaConfiguration: { // SchemaConfiguration
//               RoleARN: "STRING_VALUE",
//               CatalogId: "STRING_VALUE",
//               DatabaseName: "STRING_VALUE",
//               TableName: "STRING_VALUE",
//               Region: "STRING_VALUE",
//               VersionId: "STRING_VALUE",
//             },
//             InputFormatConfiguration: { // InputFormatConfiguration
//               Deserializer: { // Deserializer
//                 OpenXJsonSerDe: { // OpenXJsonSerDe
//                   ConvertDotsInJsonKeysToUnderscores: true || false,
//                   CaseInsensitive: true || false,
//                   ColumnToJsonKeyMappings: { // ColumnToJsonKeyMappings
//                     "<keys>": "STRING_VALUE",
//                   },
//                 },
//                 HiveJsonSerDe: { // HiveJsonSerDe
//                   TimestampFormats: [ // ListOfNonEmptyStrings
//                     "STRING_VALUE",
//                   ],
//                 },
//               },
//             },
//             OutputFormatConfiguration: { // OutputFormatConfiguration
//               Serializer: { // Serializer
//                 ParquetSerDe: { // ParquetSerDe
//                   BlockSizeBytes: Number("int"),
//                   PageSizeBytes: Number("int"),
//                   Compression: "UNCOMPRESSED" || "GZIP" || "SNAPPY",
//                   EnableDictionaryCompression: true || false,
//                   MaxPaddingBytes: Number("int"),
//                   WriterVersion: "V1" || "V2",
//                 },
//                 OrcSerDe: { // OrcSerDe
//                   StripeSizeBytes: Number("int"),
//                   BlockSizeBytes: Number("int"),
//                   RowIndexStride: Number("int"),
//                   EnablePadding: true || false,
//                   PaddingTolerance: Number("double"),
//                   Compression: "NONE" || "ZLIB" || "SNAPPY",
//                   BloomFilterColumns: [ // ListOfNonEmptyStringsWithoutWhitespace
//                     "STRING_VALUE",
//                   ],
//                   BloomFilterFalsePositiveProbability: Number("double"),
//                   DictionaryKeyThreshold: Number("double"),
//                   FormatVersion: "V0_11" || "V0_12",
//                 },
//               },
//             },
//             Enabled: true || false,
//           },
//           DynamicPartitioningConfiguration: { // DynamicPartitioningConfiguration
//             RetryOptions: { // RetryOptions
//               DurationInSeconds: Number("int"),
//             },
//             Enabled: true || false,
//           },
//           FileExtension: "STRING_VALUE",
//           CustomTimeZone: "STRING_VALUE",
//         },
//         RedshiftDestinationDescription: { // RedshiftDestinationDescription
//           RoleARN: "STRING_VALUE", // required
//           ClusterJDBCURL: "STRING_VALUE", // required
//           CopyCommand: { // CopyCommand
//             DataTableName: "STRING_VALUE", // required
//             DataTableColumns: "STRING_VALUE",
//             CopyOptions: "STRING_VALUE",
//           },
//           Username: "STRING_VALUE",
//           RetryOptions: { // RedshiftRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3DestinationDescription: {
//             RoleARN: "STRING_VALUE", // required
//             BucketARN: "STRING_VALUE", // required
//             Prefix: "STRING_VALUE",
//             ErrorOutputPrefix: "STRING_VALUE",
//             BufferingHints: {
//               SizeInMBs: Number("int"),
//               IntervalInSeconds: Number("int"),
//             },
//             CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//             EncryptionConfiguration: {
//               NoEncryptionConfig: "NoEncryption",
//               KMSEncryptionConfig: {
//                 AWSKMSKeyARN: "STRING_VALUE", // required
//               },
//             },
//             CloudWatchLoggingOptions: {
//               Enabled: true || false,
//               LogGroupName: "STRING_VALUE",
//               LogStreamName: "STRING_VALUE",
//             },
//           },
//           ProcessingConfiguration: {
//             Enabled: true || false,
//             Processors: [
//               {
//                 Type: "RecordDeAggregation" || "Decompression" || "CloudWatchLogProcessing" || "Lambda" || "MetadataExtraction" || "AppendDelimiterToRecord", // required
//                 Parameters: [
//                   {
//                     ParameterName: "LambdaArn" || "NumberOfRetries" || "MetadataExtractionQuery" || "JsonParsingEngine" || "RoleArn" || "BufferSizeInMBs" || "BufferIntervalInSeconds" || "SubRecordType" || "Delimiter" || "CompressionFormat" || "DataMessageExtraction", // required
//                     ParameterValue: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//             ],
//           },
//           S3BackupMode: "Disabled" || "Enabled",
//           S3BackupDescription: {
//             RoleARN: "STRING_VALUE", // required
//             BucketARN: "STRING_VALUE", // required
//             Prefix: "STRING_VALUE",
//             ErrorOutputPrefix: "STRING_VALUE",
//             BufferingHints: {
//               SizeInMBs: Number("int"),
//               IntervalInSeconds: Number("int"),
//             },
//             CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//             EncryptionConfiguration: {
//               NoEncryptionConfig: "NoEncryption",
//               KMSEncryptionConfig: {
//                 AWSKMSKeyARN: "STRING_VALUE", // required
//               },
//             },
//             CloudWatchLoggingOptions: {
//               Enabled: true || false,
//               LogGroupName: "STRING_VALUE",
//               LogStreamName: "STRING_VALUE",
//             },
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           SecretsManagerConfiguration: {
//             SecretARN: "STRING_VALUE",
//             RoleARN: "STRING_VALUE",
//             Enabled: true || false, // required
//           },
//         },
//         ElasticsearchDestinationDescription: { // ElasticsearchDestinationDescription
//           RoleARN: "STRING_VALUE",
//           DomainARN: "STRING_VALUE",
//           ClusterEndpoint: "STRING_VALUE",
//           IndexName: "STRING_VALUE",
//           TypeName: "STRING_VALUE",
//           IndexRotationPeriod: "NoRotation" || "OneHour" || "OneDay" || "OneWeek" || "OneMonth",
//           BufferingHints: { // ElasticsearchBufferingHints
//             IntervalInSeconds: Number("int"),
//             SizeInMBs: Number("int"),
//           },
//           RetryOptions: { // ElasticsearchRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedDocumentsOnly" || "AllDocuments",
//           S3DestinationDescription: {
//             RoleARN: "STRING_VALUE", // required
//             BucketARN: "STRING_VALUE", // required
//             Prefix: "STRING_VALUE",
//             ErrorOutputPrefix: "STRING_VALUE",
//             BufferingHints: "<BufferingHints>", // required
//             CompressionFormat: "UNCOMPRESSED" || "GZIP" || "ZIP" || "Snappy" || "HADOOP_SNAPPY", // required
//             EncryptionConfiguration: "<EncryptionConfiguration>", // required
//             CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           },
//           ProcessingConfiguration: {
//             Enabled: true || false,
//             Processors: [
//               {
//                 Type: "RecordDeAggregation" || "Decompression" || "CloudWatchLogProcessing" || "Lambda" || "MetadataExtraction" || "AppendDelimiterToRecord", // required
//                 Parameters: [
//                   {
//                     ParameterName: "LambdaArn" || "NumberOfRetries" || "MetadataExtractionQuery" || "JsonParsingEngine" || "RoleArn" || "BufferSizeInMBs" || "BufferIntervalInSeconds" || "SubRecordType" || "Delimiter" || "CompressionFormat" || "DataMessageExtraction", // required
//                     ParameterValue: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//             ],
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           VpcConfigurationDescription: { // VpcConfigurationDescription
//             SubnetIds: [ // SubnetIdList // required
//               "STRING_VALUE",
//             ],
//             RoleARN: "STRING_VALUE", // required
//             SecurityGroupIds: [ // SecurityGroupIdList // required
//               "STRING_VALUE",
//             ],
//             VpcId: "STRING_VALUE", // required
//           },
//           DocumentIdOptions: { // DocumentIdOptions
//             DefaultDocumentIdFormat: "FIREHOSE_DEFAULT" || "NO_DOCUMENT_ID", // required
//           },
//         },
//         AmazonopensearchserviceDestinationDescription: { // AmazonopensearchserviceDestinationDescription
//           RoleARN: "STRING_VALUE",
//           DomainARN: "STRING_VALUE",
//           ClusterEndpoint: "STRING_VALUE",
//           IndexName: "STRING_VALUE",
//           TypeName: "STRING_VALUE",
//           IndexRotationPeriod: "NoRotation" || "OneHour" || "OneDay" || "OneWeek" || "OneMonth",
//           BufferingHints: { // AmazonopensearchserviceBufferingHints
//             IntervalInSeconds: Number("int"),
//             SizeInMBs: Number("int"),
//           },
//           RetryOptions: { // AmazonopensearchserviceRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedDocumentsOnly" || "AllDocuments",
//           S3DestinationDescription: "<S3DestinationDescription>",
//           ProcessingConfiguration: {
//             Enabled: true || false,
//             Processors: [
//               {
//                 Type: "RecordDeAggregation" || "Decompression" || "CloudWatchLogProcessing" || "Lambda" || "MetadataExtraction" || "AppendDelimiterToRecord", // required
//                 Parameters: [
//                   {
//                     ParameterName: "LambdaArn" || "NumberOfRetries" || "MetadataExtractionQuery" || "JsonParsingEngine" || "RoleArn" || "BufferSizeInMBs" || "BufferIntervalInSeconds" || "SubRecordType" || "Delimiter" || "CompressionFormat" || "DataMessageExtraction", // required
//                     ParameterValue: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//             ],
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           VpcConfigurationDescription: {
//             SubnetIds: [ // required
//               "STRING_VALUE",
//             ],
//             RoleARN: "STRING_VALUE", // required
//             SecurityGroupIds: [ // required
//               "STRING_VALUE",
//             ],
//             VpcId: "STRING_VALUE", // required
//           },
//           DocumentIdOptions: {
//             DefaultDocumentIdFormat: "FIREHOSE_DEFAULT" || "NO_DOCUMENT_ID", // required
//           },
//         },
//         SplunkDestinationDescription: { // SplunkDestinationDescription
//           HECEndpoint: "STRING_VALUE",
//           HECEndpointType: "Raw" || "Event",
//           HECToken: "STRING_VALUE",
//           HECAcknowledgmentTimeoutInSeconds: Number("int"),
//           RetryOptions: { // SplunkRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedEventsOnly" || "AllEvents",
//           S3DestinationDescription: "<S3DestinationDescription>",
//           ProcessingConfiguration: {
//             Enabled: true || false,
//             Processors: [
//               {
//                 Type: "RecordDeAggregation" || "Decompression" || "CloudWatchLogProcessing" || "Lambda" || "MetadataExtraction" || "AppendDelimiterToRecord", // required
//                 Parameters: [
//                   {
//                     ParameterName: "LambdaArn" || "NumberOfRetries" || "MetadataExtractionQuery" || "JsonParsingEngine" || "RoleArn" || "BufferSizeInMBs" || "BufferIntervalInSeconds" || "SubRecordType" || "Delimiter" || "CompressionFormat" || "DataMessageExtraction", // required
//                     ParameterValue: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//             ],
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           BufferingHints: { // SplunkBufferingHints
//             IntervalInSeconds: Number("int"),
//             SizeInMBs: Number("int"),
//           },
//           SecretsManagerConfiguration: {
//             SecretARN: "STRING_VALUE",
//             RoleARN: "STRING_VALUE",
//             Enabled: true || false, // required
//           },
//         },
//         HttpEndpointDestinationDescription: { // HttpEndpointDestinationDescription
//           EndpointConfiguration: { // HttpEndpointDescription
//             Url: "STRING_VALUE",
//             Name: "STRING_VALUE",
//           },
//           BufferingHints: { // HttpEndpointBufferingHints
//             SizeInMBs: Number("int"),
//             IntervalInSeconds: Number("int"),
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           RequestConfiguration: { // HttpEndpointRequestConfiguration
//             ContentEncoding: "NONE" || "GZIP",
//             CommonAttributes: [ // HttpEndpointCommonAttributesList
//               { // HttpEndpointCommonAttribute
//                 AttributeName: "STRING_VALUE", // required
//                 AttributeValue: "STRING_VALUE", // required
//               },
//             ],
//           },
//           ProcessingConfiguration: "<ProcessingConfiguration>",
//           RoleARN: "STRING_VALUE",
//           RetryOptions: { // HttpEndpointRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedDataOnly" || "AllData",
//           S3DestinationDescription: "<S3DestinationDescription>",
//           SecretsManagerConfiguration: {
//             SecretARN: "STRING_VALUE",
//             RoleARN: "STRING_VALUE",
//             Enabled: true || false, // required
//           },
//         },
//         SnowflakeDestinationDescription: { // SnowflakeDestinationDescription
//           AccountUrl: "STRING_VALUE",
//           User: "STRING_VALUE",
//           Database: "STRING_VALUE",
//           Schema: "STRING_VALUE",
//           Table: "STRING_VALUE",
//           SnowflakeRoleConfiguration: { // SnowflakeRoleConfiguration
//             Enabled: true || false,
//             SnowflakeRole: "STRING_VALUE",
//           },
//           DataLoadingOption: "JSON_MAPPING" || "VARIANT_CONTENT_MAPPING" || "VARIANT_CONTENT_AND_METADATA_MAPPING",
//           MetaDataColumnName: "STRING_VALUE",
//           ContentColumnName: "STRING_VALUE",
//           SnowflakeVpcConfiguration: { // SnowflakeVpcConfiguration
//             PrivateLinkVpceId: "STRING_VALUE", // required
//           },
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           ProcessingConfiguration: "<ProcessingConfiguration>",
//           RoleARN: "STRING_VALUE",
//           RetryOptions: { // SnowflakeRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedDataOnly" || "AllData",
//           S3DestinationDescription: "<S3DestinationDescription>",
//           SecretsManagerConfiguration: {
//             SecretARN: "STRING_VALUE",
//             RoleARN: "STRING_VALUE",
//             Enabled: true || false, // required
//           },
//           BufferingHints: { // SnowflakeBufferingHints
//             SizeInMBs: Number("int"),
//             IntervalInSeconds: Number("int"),
//           },
//         },
//         AmazonOpenSearchServerlessDestinationDescription: { // AmazonOpenSearchServerlessDestinationDescription
//           RoleARN: "STRING_VALUE",
//           CollectionEndpoint: "STRING_VALUE",
//           IndexName: "STRING_VALUE",
//           BufferingHints: { // AmazonOpenSearchServerlessBufferingHints
//             IntervalInSeconds: Number("int"),
//             SizeInMBs: Number("int"),
//           },
//           RetryOptions: { // AmazonOpenSearchServerlessRetryOptions
//             DurationInSeconds: Number("int"),
//           },
//           S3BackupMode: "FailedDocumentsOnly" || "AllDocuments",
//           S3DestinationDescription: "<S3DestinationDescription>",
//           ProcessingConfiguration: "<ProcessingConfiguration>",
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           VpcConfigurationDescription: {
//             SubnetIds: [ // required
//               "STRING_VALUE",
//             ],
//             RoleARN: "STRING_VALUE", // required
//             SecurityGroupIds: [ // required
//               "STRING_VALUE",
//             ],
//             VpcId: "STRING_VALUE", // required
//           },
//         },
//         IcebergDestinationDescription: { // IcebergDestinationDescription
//           DestinationTableConfigurationList: [ // DestinationTableConfigurationList
//             { // DestinationTableConfiguration
//               DestinationTableName: "STRING_VALUE", // required
//               DestinationDatabaseName: "STRING_VALUE", // required
//               UniqueKeys: [
//                 "STRING_VALUE",
//               ],
//               PartitionSpec: { // PartitionSpec
//                 Identity: [ // PartitionFields
//                   { // PartitionField
//                     SourceName: "STRING_VALUE", // required
//                   },
//                 ],
//               },
//               S3ErrorOutputPrefix: "STRING_VALUE",
//             },
//           ],
//           SchemaEvolutionConfiguration: { // SchemaEvolutionConfiguration
//             Enabled: true || false, // required
//           },
//           TableCreationConfiguration: { // TableCreationConfiguration
//             Enabled: true || false, // required
//           },
//           BufferingHints: "<BufferingHints>",
//           CloudWatchLoggingOptions: "<CloudWatchLoggingOptions>",
//           ProcessingConfiguration: "<ProcessingConfiguration>",
//           S3BackupMode: "FailedDataOnly" || "AllData",
//           RetryOptions: {
//             DurationInSeconds: Number("int"),
//           },
//           RoleARN: "STRING_VALUE",
//           AppendOnly: true || false,
//           CatalogConfiguration: { // CatalogConfiguration
//             CatalogARN: "STRING_VALUE",
//             WarehouseLocation: "STRING_VALUE",
//           },
//           S3DestinationDescription: "<S3DestinationDescription>",
//         },
//       },
//     ],
//     HasMoreDestinations: true || false, // required
//   },
// };

DescribeDeliveryStreamCommand Input

Parameter
Type
Description
DeliveryStreamName
Required
string | undefined

The name of the Firehose stream.

ExclusiveStartDestinationId
string | undefined

The ID of the destination to start returning the destination information. Firehose supports one destination per Firehose stream.

Limit
number | undefined

The limit on the number of destinations to return. You can have one destination per Firehose stream.

DescribeDeliveryStreamCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
DeliveryStreamDescription
Required
DeliveryStreamDescription | undefined

Information about the Firehose stream.

Throws

Name
Fault
Details
ResourceNotFoundException
client

The specified resource could not be found.

FirehoseServiceException
Base exception class for all service exceptions from Firehose service.