@aws-sdk/client-firehose 3.35.0 → 3.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/dist-cjs/Firehose.js +0 -1
  3. package/dist-cjs/FirehoseClient.js +0 -1
  4. package/dist-cjs/commands/CreateDeliveryStreamCommand.js +0 -1
  5. package/dist-cjs/commands/DeleteDeliveryStreamCommand.js +0 -1
  6. package/dist-cjs/commands/DescribeDeliveryStreamCommand.js +0 -1
  7. package/dist-cjs/commands/ListDeliveryStreamsCommand.js +0 -1
  8. package/dist-cjs/commands/ListTagsForDeliveryStreamCommand.js +0 -1
  9. package/dist-cjs/commands/PutRecordBatchCommand.js +0 -1
  10. package/dist-cjs/commands/PutRecordCommand.js +0 -1
  11. package/dist-cjs/commands/StartDeliveryStreamEncryptionCommand.js +0 -1
  12. package/dist-cjs/commands/StopDeliveryStreamEncryptionCommand.js +0 -1
  13. package/dist-cjs/commands/TagDeliveryStreamCommand.js +0 -1
  14. package/dist-cjs/commands/UntagDeliveryStreamCommand.js +0 -1
  15. package/dist-cjs/commands/UpdateDestinationCommand.js +0 -1
  16. package/dist-cjs/endpoints.js +0 -1
  17. package/dist-cjs/index.js +0 -1
  18. package/dist-cjs/models/index.js +0 -1
  19. package/dist-cjs/models/models_0.js +150 -93
  20. package/dist-cjs/protocols/Aws_json1_1.js +132 -1
  21. package/dist-cjs/runtimeConfig.browser.js +2 -3
  22. package/dist-cjs/runtimeConfig.js +3 -4
  23. package/dist-cjs/runtimeConfig.native.js +0 -1
  24. package/dist-cjs/runtimeConfig.shared.js +0 -1
  25. package/dist-es/Firehose.js +0 -1
  26. package/dist-es/FirehoseClient.js +0 -1
  27. package/dist-es/commands/CreateDeliveryStreamCommand.js +0 -1
  28. package/dist-es/commands/DeleteDeliveryStreamCommand.js +0 -1
  29. package/dist-es/commands/DescribeDeliveryStreamCommand.js +0 -1
  30. package/dist-es/commands/ListDeliveryStreamsCommand.js +0 -1
  31. package/dist-es/commands/ListTagsForDeliveryStreamCommand.js +0 -1
  32. package/dist-es/commands/PutRecordBatchCommand.js +0 -1
  33. package/dist-es/commands/PutRecordCommand.js +0 -1
  34. package/dist-es/commands/StartDeliveryStreamEncryptionCommand.js +0 -1
  35. package/dist-es/commands/StopDeliveryStreamEncryptionCommand.js +0 -1
  36. package/dist-es/commands/TagDeliveryStreamCommand.js +0 -1
  37. package/dist-es/commands/UntagDeliveryStreamCommand.js +0 -1
  38. package/dist-es/commands/UpdateDestinationCommand.js +0 -1
  39. package/dist-es/endpoints.js +0 -1
  40. package/dist-es/index.js +0 -1
  41. package/dist-es/models/index.js +0 -1
  42. package/dist-es/models/models_0.js +87 -55
  43. package/dist-es/protocols/Aws_json1_1.js +101 -3
  44. package/dist-es/runtimeConfig.browser.js +1 -2
  45. package/dist-es/runtimeConfig.js +2 -3
  46. package/dist-es/runtimeConfig.native.js +0 -1
  47. package/dist-es/runtimeConfig.shared.js +0 -1
  48. package/dist-types/models/models_0.d.ts +524 -397
  49. package/dist-types/ts3.4/models/models_0.d.ts +524 -397
  50. package/package.json +33 -30
  51. package/dist-cjs/Firehose.js.map +0 -1
  52. package/dist-cjs/FirehoseClient.js.map +0 -1
  53. package/dist-cjs/commands/CreateDeliveryStreamCommand.js.map +0 -1
  54. package/dist-cjs/commands/DeleteDeliveryStreamCommand.js.map +0 -1
  55. package/dist-cjs/commands/DescribeDeliveryStreamCommand.js.map +0 -1
  56. package/dist-cjs/commands/ListDeliveryStreamsCommand.js.map +0 -1
  57. package/dist-cjs/commands/ListTagsForDeliveryStreamCommand.js.map +0 -1
  58. package/dist-cjs/commands/PutRecordBatchCommand.js.map +0 -1
  59. package/dist-cjs/commands/PutRecordCommand.js.map +0 -1
  60. package/dist-cjs/commands/StartDeliveryStreamEncryptionCommand.js.map +0 -1
  61. package/dist-cjs/commands/StopDeliveryStreamEncryptionCommand.js.map +0 -1
  62. package/dist-cjs/commands/TagDeliveryStreamCommand.js.map +0 -1
  63. package/dist-cjs/commands/UntagDeliveryStreamCommand.js.map +0 -1
  64. package/dist-cjs/commands/UpdateDestinationCommand.js.map +0 -1
  65. package/dist-cjs/endpoints.js.map +0 -1
  66. package/dist-cjs/index.js.map +0 -1
  67. package/dist-cjs/models/index.js.map +0 -1
  68. package/dist-cjs/models/models_0.js.map +0 -1
  69. package/dist-cjs/protocols/Aws_json1_1.js.map +0 -1
  70. package/dist-cjs/runtimeConfig.browser.js.map +0 -1
  71. package/dist-cjs/runtimeConfig.js.map +0 -1
  72. package/dist-cjs/runtimeConfig.native.js.map +0 -1
  73. package/dist-cjs/runtimeConfig.shared.js.map +0 -1
  74. package/dist-es/Firehose.js.map +0 -1
  75. package/dist-es/FirehoseClient.js.map +0 -1
  76. package/dist-es/commands/CreateDeliveryStreamCommand.js.map +0 -1
  77. package/dist-es/commands/DeleteDeliveryStreamCommand.js.map +0 -1
  78. package/dist-es/commands/DescribeDeliveryStreamCommand.js.map +0 -1
  79. package/dist-es/commands/ListDeliveryStreamsCommand.js.map +0 -1
  80. package/dist-es/commands/ListTagsForDeliveryStreamCommand.js.map +0 -1
  81. package/dist-es/commands/PutRecordBatchCommand.js.map +0 -1
  82. package/dist-es/commands/PutRecordCommand.js.map +0 -1
  83. package/dist-es/commands/StartDeliveryStreamEncryptionCommand.js.map +0 -1
  84. package/dist-es/commands/StopDeliveryStreamEncryptionCommand.js.map +0 -1
  85. package/dist-es/commands/TagDeliveryStreamCommand.js.map +0 -1
  86. package/dist-es/commands/UntagDeliveryStreamCommand.js.map +0 -1
  87. package/dist-es/commands/UpdateDestinationCommand.js.map +0 -1
  88. package/dist-es/endpoints.js.map +0 -1
  89. package/dist-es/index.js.map +0 -1
  90. package/dist-es/models/index.js.map +0 -1
  91. package/dist-es/models/models_0.js.map +0 -1
  92. package/dist-es/protocols/Aws_json1_1.js.map +0 -1
  93. package/dist-es/runtimeConfig.browser.js.map +0 -1
  94. package/dist-es/runtimeConfig.js.map +0 -1
  95. package/dist-es/runtimeConfig.native.js.map +0 -1
  96. package/dist-es/runtimeConfig.shared.js.map +0 -1
  97. package/jest.config.js +0 -4
  98. package/src/Firehose.ts +0 -705
  99. package/src/FirehoseClient.ts +0 -299
  100. package/src/commands/CreateDeliveryStreamCommand.ts +0 -163
  101. package/src/commands/DeleteDeliveryStreamCommand.ts +0 -104
  102. package/src/commands/DescribeDeliveryStreamCommand.ts +0 -101
  103. package/src/commands/ListDeliveryStreamsCommand.ts +0 -102
  104. package/src/commands/ListTagsForDeliveryStreamCommand.ts +0 -99
  105. package/src/commands/PutRecordBatchCommand.ts +0 -145
  106. package/src/commands/PutRecordCommand.ts +0 -123
  107. package/src/commands/StartDeliveryStreamEncryptionCommand.ts +0 -135
  108. package/src/commands/StopDeliveryStreamEncryptionCommand.ts +0 -119
  109. package/src/commands/TagDeliveryStreamCommand.ts +0 -103
  110. package/src/commands/UntagDeliveryStreamCommand.ts +0 -98
  111. package/src/commands/UpdateDestinationCommand.ts +0 -118
  112. package/src/endpoints.ts +0 -86
  113. package/src/index.ts +0 -15
  114. package/src/models/index.ts +0 -1
  115. package/src/models/models_0.ts +0 -3952
  116. package/src/protocols/Aws_json1_1.ts +0 -3514
  117. package/src/runtimeConfig.browser.ts +0 -41
  118. package/src/runtimeConfig.native.ts +0 -17
  119. package/src/runtimeConfig.shared.ts +0 -17
  120. package/src/runtimeConfig.ts +0 -46
  121. package/tsconfig.es.json +0 -10
  122. package/tsconfig.json +0 -33
  123. package/tsconfig.types.json +0 -9
@@ -1,102 +0,0 @@
1
- import { getSerdePlugin } from "@aws-sdk/middleware-serde";
2
- import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
3
- import { Command as $Command } from "@aws-sdk/smithy-client";
4
- import {
5
- FinalizeHandlerArguments,
6
- Handler,
7
- HandlerExecutionContext,
8
- HttpHandlerOptions as __HttpHandlerOptions,
9
- MetadataBearer as __MetadataBearer,
10
- MiddlewareStack,
11
- SerdeContext as __SerdeContext,
12
- } from "@aws-sdk/types";
13
-
14
- import { FirehoseClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../FirehoseClient";
15
- import { ListDeliveryStreamsInput, ListDeliveryStreamsOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1ListDeliveryStreamsCommand,
18
- serializeAws_json1_1ListDeliveryStreamsCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface ListDeliveryStreamsCommandInput extends ListDeliveryStreamsInput {}
22
- export interface ListDeliveryStreamsCommandOutput extends ListDeliveryStreamsOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Lists your delivery streams in alphabetical order of their names.</p>
26
- * <p>The number of delivery streams might be too large to return using a single call to
27
- * <code>ListDeliveryStreams</code>. You can limit the number of delivery streams returned,
28
- * using the <code>Limit</code> parameter. To determine whether there are more delivery
29
- * streams to list, check the value of <code>HasMoreDeliveryStreams</code> in the output. If
30
- * there are more delivery streams to list, you can request them by calling this operation
31
- * again and setting the <code>ExclusiveStartDeliveryStreamName</code> parameter to the name
32
- * of the last delivery stream returned in the last call.</p>
33
- * @example
34
- * Use a bare-bones client and the command you need to make an API call.
35
- * ```javascript
36
- * import { FirehoseClient, ListDeliveryStreamsCommand } from "@aws-sdk/client-firehose"; // ES Modules import
37
- * // const { FirehoseClient, ListDeliveryStreamsCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
38
- * const client = new FirehoseClient(config);
39
- * const command = new ListDeliveryStreamsCommand(input);
40
- * const response = await client.send(command);
41
- * ```
42
- *
43
- * @see {@link ListDeliveryStreamsCommandInput} for command's `input` shape.
44
- * @see {@link ListDeliveryStreamsCommandOutput} for command's `response` shape.
45
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
46
- *
47
- */
48
- export class ListDeliveryStreamsCommand extends $Command<
49
- ListDeliveryStreamsCommandInput,
50
- ListDeliveryStreamsCommandOutput,
51
- FirehoseClientResolvedConfig
52
- > {
53
- // Start section: command_properties
54
- // End section: command_properties
55
-
56
- constructor(readonly input: ListDeliveryStreamsCommandInput) {
57
- // Start section: command_constructor
58
- super();
59
- // End section: command_constructor
60
- }
61
-
62
- /**
63
- * @internal
64
- */
65
- resolveMiddleware(
66
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
67
- configuration: FirehoseClientResolvedConfig,
68
- options?: __HttpHandlerOptions
69
- ): Handler<ListDeliveryStreamsCommandInput, ListDeliveryStreamsCommandOutput> {
70
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
71
-
72
- const stack = clientStack.concat(this.middlewareStack);
73
-
74
- const { logger } = configuration;
75
- const clientName = "FirehoseClient";
76
- const commandName = "ListDeliveryStreamsCommand";
77
- const handlerExecutionContext: HandlerExecutionContext = {
78
- logger,
79
- clientName,
80
- commandName,
81
- inputFilterSensitiveLog: ListDeliveryStreamsInput.filterSensitiveLog,
82
- outputFilterSensitiveLog: ListDeliveryStreamsOutput.filterSensitiveLog,
83
- };
84
- const { requestHandler } = configuration;
85
- return stack.resolve(
86
- (request: FinalizeHandlerArguments<any>) =>
87
- requestHandler.handle(request.request as __HttpRequest, options || {}),
88
- handlerExecutionContext
89
- );
90
- }
91
-
92
- private serialize(input: ListDeliveryStreamsCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
93
- return serializeAws_json1_1ListDeliveryStreamsCommand(input, context);
94
- }
95
-
96
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<ListDeliveryStreamsCommandOutput> {
97
- return deserializeAws_json1_1ListDeliveryStreamsCommand(output, context);
98
- }
99
-
100
- // Start section: command_body_extra
101
- // End section: command_body_extra
102
- }
@@ -1,99 +0,0 @@
1
- import { getSerdePlugin } from "@aws-sdk/middleware-serde";
2
- import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
3
- import { Command as $Command } from "@aws-sdk/smithy-client";
4
- import {
5
- FinalizeHandlerArguments,
6
- Handler,
7
- HandlerExecutionContext,
8
- HttpHandlerOptions as __HttpHandlerOptions,
9
- MetadataBearer as __MetadataBearer,
10
- MiddlewareStack,
11
- SerdeContext as __SerdeContext,
12
- } from "@aws-sdk/types";
13
-
14
- import { FirehoseClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../FirehoseClient";
15
- import { ListTagsForDeliveryStreamInput, ListTagsForDeliveryStreamOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1ListTagsForDeliveryStreamCommand,
18
- serializeAws_json1_1ListTagsForDeliveryStreamCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface ListTagsForDeliveryStreamCommandInput extends ListTagsForDeliveryStreamInput {}
22
- export interface ListTagsForDeliveryStreamCommandOutput extends ListTagsForDeliveryStreamOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Lists the tags for the specified delivery stream. This operation has a limit of five
26
- * transactions per second per account. </p>
27
- * @example
28
- * Use a bare-bones client and the command you need to make an API call.
29
- * ```javascript
30
- * import { FirehoseClient, ListTagsForDeliveryStreamCommand } from "@aws-sdk/client-firehose"; // ES Modules import
31
- * // const { FirehoseClient, ListTagsForDeliveryStreamCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
32
- * const client = new FirehoseClient(config);
33
- * const command = new ListTagsForDeliveryStreamCommand(input);
34
- * const response = await client.send(command);
35
- * ```
36
- *
37
- * @see {@link ListTagsForDeliveryStreamCommandInput} for command's `input` shape.
38
- * @see {@link ListTagsForDeliveryStreamCommandOutput} for command's `response` shape.
39
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
40
- *
41
- */
42
- export class ListTagsForDeliveryStreamCommand extends $Command<
43
- ListTagsForDeliveryStreamCommandInput,
44
- ListTagsForDeliveryStreamCommandOutput,
45
- FirehoseClientResolvedConfig
46
- > {
47
- // Start section: command_properties
48
- // End section: command_properties
49
-
50
- constructor(readonly input: ListTagsForDeliveryStreamCommandInput) {
51
- // Start section: command_constructor
52
- super();
53
- // End section: command_constructor
54
- }
55
-
56
- /**
57
- * @internal
58
- */
59
- resolveMiddleware(
60
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
61
- configuration: FirehoseClientResolvedConfig,
62
- options?: __HttpHandlerOptions
63
- ): Handler<ListTagsForDeliveryStreamCommandInput, ListTagsForDeliveryStreamCommandOutput> {
64
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
65
-
66
- const stack = clientStack.concat(this.middlewareStack);
67
-
68
- const { logger } = configuration;
69
- const clientName = "FirehoseClient";
70
- const commandName = "ListTagsForDeliveryStreamCommand";
71
- const handlerExecutionContext: HandlerExecutionContext = {
72
- logger,
73
- clientName,
74
- commandName,
75
- inputFilterSensitiveLog: ListTagsForDeliveryStreamInput.filterSensitiveLog,
76
- outputFilterSensitiveLog: ListTagsForDeliveryStreamOutput.filterSensitiveLog,
77
- };
78
- const { requestHandler } = configuration;
79
- return stack.resolve(
80
- (request: FinalizeHandlerArguments<any>) =>
81
- requestHandler.handle(request.request as __HttpRequest, options || {}),
82
- handlerExecutionContext
83
- );
84
- }
85
-
86
- private serialize(input: ListTagsForDeliveryStreamCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
87
- return serializeAws_json1_1ListTagsForDeliveryStreamCommand(input, context);
88
- }
89
-
90
- private deserialize(
91
- output: __HttpResponse,
92
- context: __SerdeContext
93
- ): Promise<ListTagsForDeliveryStreamCommandOutput> {
94
- return deserializeAws_json1_1ListTagsForDeliveryStreamCommand(output, context);
95
- }
96
-
97
- // Start section: command_body_extra
98
- // End section: command_body_extra
99
- }
@@ -1,145 +0,0 @@
1
- import { getSerdePlugin } from "@aws-sdk/middleware-serde";
2
- import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
3
- import { Command as $Command } from "@aws-sdk/smithy-client";
4
- import {
5
- FinalizeHandlerArguments,
6
- Handler,
7
- HandlerExecutionContext,
8
- HttpHandlerOptions as __HttpHandlerOptions,
9
- MetadataBearer as __MetadataBearer,
10
- MiddlewareStack,
11
- SerdeContext as __SerdeContext,
12
- } from "@aws-sdk/types";
13
-
14
- import { FirehoseClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../FirehoseClient";
15
- import { PutRecordBatchInput, PutRecordBatchOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1PutRecordBatchCommand,
18
- serializeAws_json1_1PutRecordBatchCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface PutRecordBatchCommandInput extends PutRecordBatchInput {}
22
- export interface PutRecordBatchCommandOutput extends PutRecordBatchOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Writes multiple data records into a delivery stream in a single call, which can
26
- * achieve higher throughput per producer than when writing single records. To write single
27
- * data records into a delivery stream, use <a>PutRecord</a>. Applications using
28
- * these operations are referred to as producers.</p>
29
- * <p>For information about service quota, see <a href="https://docs.aws.amazon.com/firehose/latest/dev/limits.html">Amazon Kinesis Data Firehose
30
- * Quota</a>.</p>
31
- * <p>Each <a>PutRecordBatch</a> request supports up to 500 records. Each record
32
- * in the request can be as large as 1,000 KB (before base64 encoding), up to a limit of 4 MB
33
- * for the entire request. These limits cannot be changed.</p>
34
- * <p>You must specify the name of the delivery stream and the data record when using <a>PutRecord</a>. The data record consists of a data blob that can be up to 1,000
35
- * KB in size, and any kind of data. For example, it could be a segment from a log file,
36
- * geographic location data, website clickstream data, and so on.</p>
37
- * <p>Kinesis Data Firehose buffers records before delivering them to the destination. To
38
- * disambiguate the data blobs at the destination, a common solution is to use delimiters in
39
- * the data, such as a newline (<code>\n</code>) or some other character unique within the
40
- * data. This allows the consumer application to parse individual data items when reading the
41
- * data from the destination.</p>
42
- * <p>The <a>PutRecordBatch</a> response includes a count of failed records,
43
- * <code>FailedPutCount</code>, and an array of responses, <code>RequestResponses</code>.
44
- * Even if the <a>PutRecordBatch</a> call succeeds, the value of
45
- * <code>FailedPutCount</code> may be greater than 0, indicating that there are records for
46
- * which the operation didn't succeed. Each entry in the <code>RequestResponses</code> array
47
- * provides additional information about the processed record. It directly correlates with a
48
- * record in the request array using the same ordering, from the top to the bottom. The
49
- * response array always includes the same number of records as the request array.
50
- * <code>RequestResponses</code> includes both successfully and unsuccessfully processed
51
- * records. Kinesis Data Firehose tries to process all records in each <a>PutRecordBatch</a> request. A single record failure does not stop the processing
52
- * of subsequent records. </p>
53
- * <p>A successfully processed record includes a <code>RecordId</code> value, which is
54
- * unique for the record. An unsuccessfully processed record includes <code>ErrorCode</code>
55
- * and <code>ErrorMessage</code> values. <code>ErrorCode</code> reflects the type of error,
56
- * and is one of the following values: <code>ServiceUnavailableException</code> or
57
- * <code>InternalFailure</code>. <code>ErrorMessage</code> provides more detailed
58
- * information about the error.</p>
59
- * <p>If there is an internal server error or a timeout, the write might have completed or
60
- * it might have failed. If <code>FailedPutCount</code> is greater than 0, retry the request,
61
- * resending only those records that might have failed processing. This minimizes the possible
62
- * duplicate records and also reduces the total bytes sent (and corresponding charges). We
63
- * recommend that you handle any duplicates at the destination.</p>
64
- * <p>If <a>PutRecordBatch</a> throws <code>ServiceUnavailableException</code>,
65
- * back off and retry. If the exception persists, it is possible that the throughput limits
66
- * have been exceeded for the delivery stream.</p>
67
- *
68
- * <p>Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they
69
- * are added to a delivery stream as it attempts to send the records to the destination. If
70
- * the destination is unreachable for more than 24 hours, the data is no longer
71
- * available.</p>
72
- * <important>
73
- * <p>Don't concatenate two or more base64 strings to form the data fields of your records.
74
- * Instead, concatenate the raw data, then perform base64 encoding.</p>
75
- * </important>
76
- * @example
77
- * Use a bare-bones client and the command you need to make an API call.
78
- * ```javascript
79
- * import { FirehoseClient, PutRecordBatchCommand } from "@aws-sdk/client-firehose"; // ES Modules import
80
- * // const { FirehoseClient, PutRecordBatchCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
81
- * const client = new FirehoseClient(config);
82
- * const command = new PutRecordBatchCommand(input);
83
- * const response = await client.send(command);
84
- * ```
85
- *
86
- * @see {@link PutRecordBatchCommandInput} for command's `input` shape.
87
- * @see {@link PutRecordBatchCommandOutput} for command's `response` shape.
88
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
89
- *
90
- */
91
- export class PutRecordBatchCommand extends $Command<
92
- PutRecordBatchCommandInput,
93
- PutRecordBatchCommandOutput,
94
- FirehoseClientResolvedConfig
95
- > {
96
- // Start section: command_properties
97
- // End section: command_properties
98
-
99
- constructor(readonly input: PutRecordBatchCommandInput) {
100
- // Start section: command_constructor
101
- super();
102
- // End section: command_constructor
103
- }
104
-
105
- /**
106
- * @internal
107
- */
108
- resolveMiddleware(
109
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
110
- configuration: FirehoseClientResolvedConfig,
111
- options?: __HttpHandlerOptions
112
- ): Handler<PutRecordBatchCommandInput, PutRecordBatchCommandOutput> {
113
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
114
-
115
- const stack = clientStack.concat(this.middlewareStack);
116
-
117
- const { logger } = configuration;
118
- const clientName = "FirehoseClient";
119
- const commandName = "PutRecordBatchCommand";
120
- const handlerExecutionContext: HandlerExecutionContext = {
121
- logger,
122
- clientName,
123
- commandName,
124
- inputFilterSensitiveLog: PutRecordBatchInput.filterSensitiveLog,
125
- outputFilterSensitiveLog: PutRecordBatchOutput.filterSensitiveLog,
126
- };
127
- const { requestHandler } = configuration;
128
- return stack.resolve(
129
- (request: FinalizeHandlerArguments<any>) =>
130
- requestHandler.handle(request.request as __HttpRequest, options || {}),
131
- handlerExecutionContext
132
- );
133
- }
134
-
135
- private serialize(input: PutRecordBatchCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
136
- return serializeAws_json1_1PutRecordBatchCommand(input, context);
137
- }
138
-
139
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<PutRecordBatchCommandOutput> {
140
- return deserializeAws_json1_1PutRecordBatchCommand(output, context);
141
- }
142
-
143
- // Start section: command_body_extra
144
- // End section: command_body_extra
145
- }
@@ -1,123 +0,0 @@
1
- import { getSerdePlugin } from "@aws-sdk/middleware-serde";
2
- import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
3
- import { Command as $Command } from "@aws-sdk/smithy-client";
4
- import {
5
- FinalizeHandlerArguments,
6
- Handler,
7
- HandlerExecutionContext,
8
- HttpHandlerOptions as __HttpHandlerOptions,
9
- MetadataBearer as __MetadataBearer,
10
- MiddlewareStack,
11
- SerdeContext as __SerdeContext,
12
- } from "@aws-sdk/types";
13
-
14
- import { FirehoseClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../FirehoseClient";
15
- import { PutRecordInput, PutRecordOutput } from "../models/models_0";
16
- import { deserializeAws_json1_1PutRecordCommand, serializeAws_json1_1PutRecordCommand } from "../protocols/Aws_json1_1";
17
-
18
- export interface PutRecordCommandInput extends PutRecordInput {}
19
- export interface PutRecordCommandOutput extends PutRecordOutput, __MetadataBearer {}
20
-
21
- /**
22
- * <p>Writes a single data record into an Amazon Kinesis Data Firehose delivery stream. To
23
- * write multiple data records into a delivery stream, use <a>PutRecordBatch</a>.
24
- * Applications using these operations are referred to as producers.</p>
25
- * <p>By default, each delivery stream can take in up to 2,000 transactions per second,
26
- * 5,000 records per second, or 5 MB per second. If you use <a>PutRecord</a> and
27
- * <a>PutRecordBatch</a>, the limits are an aggregate across these two
28
- * operations for each delivery stream. For more information about limits and how to request
29
- * an increase, see <a href="https://docs.aws.amazon.com/firehose/latest/dev/limits.html">Amazon
30
- * Kinesis Data Firehose Limits</a>. </p>
31
- * <p>You must specify the name of the delivery stream and the data record when using <a>PutRecord</a>. The data record consists of a data blob that can be up to 1,000
32
- * KiB in size, and any kind of data. For example, it can be a segment from a log file,
33
- * geographic location data, website clickstream data, and so on.</p>
34
- * <p>Kinesis Data Firehose buffers records before delivering them to the destination. To
35
- * disambiguate the data blobs at the destination, a common solution is to use delimiters in
36
- * the data, such as a newline (<code>\n</code>) or some other character unique within the
37
- * data. This allows the consumer application to parse individual data items when reading the
38
- * data from the destination.</p>
39
- * <p>The <code>PutRecord</code> operation returns a <code>RecordId</code>, which is a
40
- * unique string assigned to each record. Producer applications can use this ID for purposes
41
- * such as auditability and investigation.</p>
42
- * <p>If the <code>PutRecord</code> operation throws a
43
- * <code>ServiceUnavailableException</code>, back off and retry. If the exception persists,
44
- * it is possible that the throughput limits have been exceeded for the delivery stream. </p>
45
- * <p>Data records sent to Kinesis Data Firehose are stored for 24 hours from the time they
46
- * are added to a delivery stream as it tries to send the records to the destination. If the
47
- * destination is unreachable for more than 24 hours, the data is no longer
48
- * available.</p>
49
- *
50
- * <important>
51
- * <p>Don't concatenate two or more base64 strings to form the data fields of your records.
52
- * Instead, concatenate the raw data, then perform base64 encoding.</p>
53
- * </important>
54
- * @example
55
- * Use a bare-bones client and the command you need to make an API call.
56
- * ```javascript
57
- * import { FirehoseClient, PutRecordCommand } from "@aws-sdk/client-firehose"; // ES Modules import
58
- * // const { FirehoseClient, PutRecordCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
59
- * const client = new FirehoseClient(config);
60
- * const command = new PutRecordCommand(input);
61
- * const response = await client.send(command);
62
- * ```
63
- *
64
- * @see {@link PutRecordCommandInput} for command's `input` shape.
65
- * @see {@link PutRecordCommandOutput} for command's `response` shape.
66
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
67
- *
68
- */
69
- export class PutRecordCommand extends $Command<
70
- PutRecordCommandInput,
71
- PutRecordCommandOutput,
72
- FirehoseClientResolvedConfig
73
- > {
74
- // Start section: command_properties
75
- // End section: command_properties
76
-
77
- constructor(readonly input: PutRecordCommandInput) {
78
- // Start section: command_constructor
79
- super();
80
- // End section: command_constructor
81
- }
82
-
83
- /**
84
- * @internal
85
- */
86
- resolveMiddleware(
87
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
88
- configuration: FirehoseClientResolvedConfig,
89
- options?: __HttpHandlerOptions
90
- ): Handler<PutRecordCommandInput, PutRecordCommandOutput> {
91
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
92
-
93
- const stack = clientStack.concat(this.middlewareStack);
94
-
95
- const { logger } = configuration;
96
- const clientName = "FirehoseClient";
97
- const commandName = "PutRecordCommand";
98
- const handlerExecutionContext: HandlerExecutionContext = {
99
- logger,
100
- clientName,
101
- commandName,
102
- inputFilterSensitiveLog: PutRecordInput.filterSensitiveLog,
103
- outputFilterSensitiveLog: PutRecordOutput.filterSensitiveLog,
104
- };
105
- const { requestHandler } = configuration;
106
- return stack.resolve(
107
- (request: FinalizeHandlerArguments<any>) =>
108
- requestHandler.handle(request.request as __HttpRequest, options || {}),
109
- handlerExecutionContext
110
- );
111
- }
112
-
113
- private serialize(input: PutRecordCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
114
- return serializeAws_json1_1PutRecordCommand(input, context);
115
- }
116
-
117
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<PutRecordCommandOutput> {
118
- return deserializeAws_json1_1PutRecordCommand(output, context);
119
- }
120
-
121
- // Start section: command_body_extra
122
- // End section: command_body_extra
123
- }
@@ -1,135 +0,0 @@
1
- import { getSerdePlugin } from "@aws-sdk/middleware-serde";
2
- import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
3
- import { Command as $Command } from "@aws-sdk/smithy-client";
4
- import {
5
- FinalizeHandlerArguments,
6
- Handler,
7
- HandlerExecutionContext,
8
- HttpHandlerOptions as __HttpHandlerOptions,
9
- MetadataBearer as __MetadataBearer,
10
- MiddlewareStack,
11
- SerdeContext as __SerdeContext,
12
- } from "@aws-sdk/types";
13
-
14
- import { FirehoseClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../FirehoseClient";
15
- import { StartDeliveryStreamEncryptionInput, StartDeliveryStreamEncryptionOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1StartDeliveryStreamEncryptionCommand,
18
- serializeAws_json1_1StartDeliveryStreamEncryptionCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface StartDeliveryStreamEncryptionCommandInput extends StartDeliveryStreamEncryptionInput {}
22
- export interface StartDeliveryStreamEncryptionCommandOutput
23
- extends StartDeliveryStreamEncryptionOutput,
24
- __MetadataBearer {}
25
-
26
- /**
27
- * <p>Enables server-side encryption (SSE) for the delivery stream. </p>
28
- * <p>This operation is asynchronous. It returns immediately. When you invoke it, Kinesis Data
29
- * Firehose first sets the encryption status of the stream to <code>ENABLING</code>, and then
30
- * to <code>ENABLED</code>. The encryption status of a delivery stream is the
31
- * <code>Status</code> property in <a>DeliveryStreamEncryptionConfiguration</a>.
32
- * If the operation fails, the encryption status changes to <code>ENABLING_FAILED</code>. You
33
- * can continue to read and write data to your delivery stream while the encryption status is
34
- * <code>ENABLING</code>, but the data is not encrypted. It can take up to 5 seconds after
35
- * the encryption status changes to <code>ENABLED</code> before all records written to the
36
- * delivery stream are encrypted. To find out whether a record or a batch of records was
37
- * encrypted, check the response elements <a>PutRecordOutput$Encrypted</a> and
38
- * <a>PutRecordBatchOutput$Encrypted</a>, respectively.</p>
39
- * <p>To check the encryption status of a delivery stream, use <a>DescribeDeliveryStream</a>.</p>
40
- * <p>Even if encryption is currently enabled for a delivery stream, you can still invoke this
41
- * operation on it to change the ARN of the CMK or both its type and ARN. If you invoke this
42
- * method to change the CMK, and the old CMK is of type <code>CUSTOMER_MANAGED_CMK</code>,
43
- * Kinesis Data Firehose schedules the grant it had on the old CMK for retirement. If the new
44
- * CMK is of type <code>CUSTOMER_MANAGED_CMK</code>, Kinesis Data Firehose creates a grant
45
- * that enables it to use the new CMK to encrypt and decrypt data and to manage the
46
- * grant.</p>
47
- * <p>If a delivery stream already has encryption enabled and then you invoke this operation
48
- * to change the ARN of the CMK or both its type and ARN and you get
49
- * <code>ENABLING_FAILED</code>, this only means that the attempt to change the CMK failed.
50
- * In this case, encryption remains enabled with the old CMK.</p>
51
- * <p>If the encryption status of your delivery stream is <code>ENABLING_FAILED</code>, you
52
- * can invoke this operation again with a valid CMK. The CMK must be enabled and the key
53
- * policy mustn't explicitly deny the permission for Kinesis Data Firehose to invoke KMS
54
- * encrypt and decrypt operations.</p>
55
- * <p>You can enable SSE for a delivery stream only if it's a delivery stream that uses
56
- * <code>DirectPut</code> as its source. </p>
57
- * <p>The <code>StartDeliveryStreamEncryption</code> and
58
- * <code>StopDeliveryStreamEncryption</code> operations have a combined limit of 25 calls
59
- * per delivery stream per 24 hours. For example, you reach the limit if you call
60
- * <code>StartDeliveryStreamEncryption</code> 13 times and
61
- * <code>StopDeliveryStreamEncryption</code> 12 times for the same delivery stream in a
62
- * 24-hour period.</p>
63
- * @example
64
- * Use a bare-bones client and the command you need to make an API call.
65
- * ```javascript
66
- * import { FirehoseClient, StartDeliveryStreamEncryptionCommand } from "@aws-sdk/client-firehose"; // ES Modules import
67
- * // const { FirehoseClient, StartDeliveryStreamEncryptionCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
68
- * const client = new FirehoseClient(config);
69
- * const command = new StartDeliveryStreamEncryptionCommand(input);
70
- * const response = await client.send(command);
71
- * ```
72
- *
73
- * @see {@link StartDeliveryStreamEncryptionCommandInput} for command's `input` shape.
74
- * @see {@link StartDeliveryStreamEncryptionCommandOutput} for command's `response` shape.
75
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
76
- *
77
- */
78
- export class StartDeliveryStreamEncryptionCommand extends $Command<
79
- StartDeliveryStreamEncryptionCommandInput,
80
- StartDeliveryStreamEncryptionCommandOutput,
81
- FirehoseClientResolvedConfig
82
- > {
83
- // Start section: command_properties
84
- // End section: command_properties
85
-
86
- constructor(readonly input: StartDeliveryStreamEncryptionCommandInput) {
87
- // Start section: command_constructor
88
- super();
89
- // End section: command_constructor
90
- }
91
-
92
- /**
93
- * @internal
94
- */
95
- resolveMiddleware(
96
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
97
- configuration: FirehoseClientResolvedConfig,
98
- options?: __HttpHandlerOptions
99
- ): Handler<StartDeliveryStreamEncryptionCommandInput, StartDeliveryStreamEncryptionCommandOutput> {
100
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
101
-
102
- const stack = clientStack.concat(this.middlewareStack);
103
-
104
- const { logger } = configuration;
105
- const clientName = "FirehoseClient";
106
- const commandName = "StartDeliveryStreamEncryptionCommand";
107
- const handlerExecutionContext: HandlerExecutionContext = {
108
- logger,
109
- clientName,
110
- commandName,
111
- inputFilterSensitiveLog: StartDeliveryStreamEncryptionInput.filterSensitiveLog,
112
- outputFilterSensitiveLog: StartDeliveryStreamEncryptionOutput.filterSensitiveLog,
113
- };
114
- const { requestHandler } = configuration;
115
- return stack.resolve(
116
- (request: FinalizeHandlerArguments<any>) =>
117
- requestHandler.handle(request.request as __HttpRequest, options || {}),
118
- handlerExecutionContext
119
- );
120
- }
121
-
122
- private serialize(input: StartDeliveryStreamEncryptionCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
123
- return serializeAws_json1_1StartDeliveryStreamEncryptionCommand(input, context);
124
- }
125
-
126
- private deserialize(
127
- output: __HttpResponse,
128
- context: __SerdeContext
129
- ): Promise<StartDeliveryStreamEncryptionCommandOutput> {
130
- return deserializeAws_json1_1StartDeliveryStreamEncryptionCommand(output, context);
131
- }
132
-
133
- // Start section: command_body_extra
134
- // End section: command_body_extra
135
- }