@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,299 +0,0 @@
1
- import {
2
- EndpointsInputConfig,
3
- EndpointsResolvedConfig,
4
- RegionInputConfig,
5
- RegionResolvedConfig,
6
- resolveEndpointsConfig,
7
- resolveRegionConfig,
8
- } from "@aws-sdk/config-resolver";
9
- import { getContentLengthPlugin } from "@aws-sdk/middleware-content-length";
10
- import {
11
- getHostHeaderPlugin,
12
- HostHeaderInputConfig,
13
- HostHeaderResolvedConfig,
14
- resolveHostHeaderConfig,
15
- } from "@aws-sdk/middleware-host-header";
16
- import { getLoggerPlugin } from "@aws-sdk/middleware-logger";
17
- import { getRetryPlugin, resolveRetryConfig, RetryInputConfig, RetryResolvedConfig } from "@aws-sdk/middleware-retry";
18
- import {
19
- AwsAuthInputConfig,
20
- AwsAuthResolvedConfig,
21
- getAwsAuthPlugin,
22
- resolveAwsAuthConfig,
23
- } from "@aws-sdk/middleware-signing";
24
- import {
25
- getUserAgentPlugin,
26
- resolveUserAgentConfig,
27
- UserAgentInputConfig,
28
- UserAgentResolvedConfig,
29
- } from "@aws-sdk/middleware-user-agent";
30
- import { HttpHandler as __HttpHandler } from "@aws-sdk/protocol-http";
31
- import {
32
- Client as __Client,
33
- SmithyConfiguration as __SmithyConfiguration,
34
- SmithyResolvedConfiguration as __SmithyResolvedConfiguration,
35
- } from "@aws-sdk/smithy-client";
36
- import {
37
- Credentials as __Credentials,
38
- Decoder as __Decoder,
39
- Encoder as __Encoder,
40
- Hash as __Hash,
41
- HashConstructor as __HashConstructor,
42
- HttpHandlerOptions as __HttpHandlerOptions,
43
- Logger as __Logger,
44
- Provider as __Provider,
45
- Provider,
46
- RegionInfoProvider,
47
- StreamCollector as __StreamCollector,
48
- UrlParser as __UrlParser,
49
- UserAgent as __UserAgent,
50
- } from "@aws-sdk/types";
51
-
52
- import {
53
- CreateDeliveryStreamCommandInput,
54
- CreateDeliveryStreamCommandOutput,
55
- } from "./commands/CreateDeliveryStreamCommand";
56
- import {
57
- DeleteDeliveryStreamCommandInput,
58
- DeleteDeliveryStreamCommandOutput,
59
- } from "./commands/DeleteDeliveryStreamCommand";
60
- import {
61
- DescribeDeliveryStreamCommandInput,
62
- DescribeDeliveryStreamCommandOutput,
63
- } from "./commands/DescribeDeliveryStreamCommand";
64
- import {
65
- ListDeliveryStreamsCommandInput,
66
- ListDeliveryStreamsCommandOutput,
67
- } from "./commands/ListDeliveryStreamsCommand";
68
- import {
69
- ListTagsForDeliveryStreamCommandInput,
70
- ListTagsForDeliveryStreamCommandOutput,
71
- } from "./commands/ListTagsForDeliveryStreamCommand";
72
- import { PutRecordBatchCommandInput, PutRecordBatchCommandOutput } from "./commands/PutRecordBatchCommand";
73
- import { PutRecordCommandInput, PutRecordCommandOutput } from "./commands/PutRecordCommand";
74
- import {
75
- StartDeliveryStreamEncryptionCommandInput,
76
- StartDeliveryStreamEncryptionCommandOutput,
77
- } from "./commands/StartDeliveryStreamEncryptionCommand";
78
- import {
79
- StopDeliveryStreamEncryptionCommandInput,
80
- StopDeliveryStreamEncryptionCommandOutput,
81
- } from "./commands/StopDeliveryStreamEncryptionCommand";
82
- import { TagDeliveryStreamCommandInput, TagDeliveryStreamCommandOutput } from "./commands/TagDeliveryStreamCommand";
83
- import {
84
- UntagDeliveryStreamCommandInput,
85
- UntagDeliveryStreamCommandOutput,
86
- } from "./commands/UntagDeliveryStreamCommand";
87
- import { UpdateDestinationCommandInput, UpdateDestinationCommandOutput } from "./commands/UpdateDestinationCommand";
88
- import { getRuntimeConfig as __getRuntimeConfig } from "./runtimeConfig";
89
-
90
- export type ServiceInputTypes =
91
- | CreateDeliveryStreamCommandInput
92
- | DeleteDeliveryStreamCommandInput
93
- | DescribeDeliveryStreamCommandInput
94
- | ListDeliveryStreamsCommandInput
95
- | ListTagsForDeliveryStreamCommandInput
96
- | PutRecordBatchCommandInput
97
- | PutRecordCommandInput
98
- | StartDeliveryStreamEncryptionCommandInput
99
- | StopDeliveryStreamEncryptionCommandInput
100
- | TagDeliveryStreamCommandInput
101
- | UntagDeliveryStreamCommandInput
102
- | UpdateDestinationCommandInput;
103
-
104
- export type ServiceOutputTypes =
105
- | CreateDeliveryStreamCommandOutput
106
- | DeleteDeliveryStreamCommandOutput
107
- | DescribeDeliveryStreamCommandOutput
108
- | ListDeliveryStreamsCommandOutput
109
- | ListTagsForDeliveryStreamCommandOutput
110
- | PutRecordBatchCommandOutput
111
- | PutRecordCommandOutput
112
- | StartDeliveryStreamEncryptionCommandOutput
113
- | StopDeliveryStreamEncryptionCommandOutput
114
- | TagDeliveryStreamCommandOutput
115
- | UntagDeliveryStreamCommandOutput
116
- | UpdateDestinationCommandOutput;
117
-
118
- export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
119
- /**
120
- * The HTTP handler to use. Fetch in browser and Https in Nodejs.
121
- */
122
- requestHandler?: __HttpHandler;
123
-
124
- /**
125
- * A constructor for a class implementing the {@link __Hash} interface
126
- * that computes the SHA-256 HMAC or checksum of a string or binary buffer.
127
- * @internal
128
- */
129
- sha256?: __HashConstructor;
130
-
131
- /**
132
- * The function that will be used to convert strings into HTTP endpoints.
133
- * @internal
134
- */
135
- urlParser?: __UrlParser;
136
-
137
- /**
138
- * A function that can calculate the length of a request body.
139
- * @internal
140
- */
141
- bodyLengthChecker?: (body: any) => number | undefined;
142
-
143
- /**
144
- * A function that converts a stream into an array of bytes.
145
- * @internal
146
- */
147
- streamCollector?: __StreamCollector;
148
-
149
- /**
150
- * The function that will be used to convert a base64-encoded string to a byte array.
151
- * @internal
152
- */
153
- base64Decoder?: __Decoder;
154
-
155
- /**
156
- * The function that will be used to convert binary data to a base64-encoded string.
157
- * @internal
158
- */
159
- base64Encoder?: __Encoder;
160
-
161
- /**
162
- * The function that will be used to convert a UTF8-encoded string to a byte array.
163
- * @internal
164
- */
165
- utf8Decoder?: __Decoder;
166
-
167
- /**
168
- * The function that will be used to convert binary data to a UTF-8 encoded string.
169
- * @internal
170
- */
171
- utf8Encoder?: __Encoder;
172
-
173
- /**
174
- * The runtime environment.
175
- * @internal
176
- */
177
- runtime?: string;
178
-
179
- /**
180
- * Disable dyanamically changing the endpoint of the client based on the hostPrefix
181
- * trait of an operation.
182
- */
183
- disableHostPrefix?: boolean;
184
-
185
- /**
186
- * Value for how many times a request will be made at most in case of retry.
187
- */
188
- maxAttempts?: number | __Provider<number>;
189
-
190
- /**
191
- * Specifies which retry algorithm to use.
192
- */
193
- retryMode?: string | __Provider<string>;
194
-
195
- /**
196
- * Optional logger for logging debug/info/warn/error.
197
- */
198
- logger?: __Logger;
199
-
200
- /**
201
- * Unique service identifier.
202
- * @internal
203
- */
204
- serviceId?: string;
205
-
206
- /**
207
- * The AWS region to which this client will send requests
208
- */
209
- region?: string | __Provider<string>;
210
-
211
- /**
212
- * Default credentials provider; Not available in browser runtime.
213
- * @internal
214
- */
215
- credentialDefaultProvider?: (input: any) => __Provider<__Credentials>;
216
-
217
- /**
218
- * Fetch related hostname, signing name or signing region with given region.
219
- * @internal
220
- */
221
- regionInfoProvider?: RegionInfoProvider;
222
-
223
- /**
224
- * The provider populating default tracking information to be sent with `user-agent`, `x-amz-user-agent` header
225
- * @internal
226
- */
227
- defaultUserAgentProvider?: Provider<__UserAgent>;
228
- }
229
-
230
- type FirehoseClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> &
231
- ClientDefaults &
232
- RegionInputConfig &
233
- EndpointsInputConfig &
234
- RetryInputConfig &
235
- HostHeaderInputConfig &
236
- AwsAuthInputConfig &
237
- UserAgentInputConfig;
238
- /**
239
- * The configuration interface of FirehoseClient class constructor that set the region, credentials and other options.
240
- */
241
- export interface FirehoseClientConfig extends FirehoseClientConfigType {}
242
-
243
- type FirehoseClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> &
244
- Required<ClientDefaults> &
245
- RegionResolvedConfig &
246
- EndpointsResolvedConfig &
247
- RetryResolvedConfig &
248
- HostHeaderResolvedConfig &
249
- AwsAuthResolvedConfig &
250
- UserAgentResolvedConfig;
251
- /**
252
- * The resolved configuration interface of FirehoseClient class. This is resolved and normalized from the {@link FirehoseClientConfig | constructor configuration interface}.
253
- */
254
- export interface FirehoseClientResolvedConfig extends FirehoseClientResolvedConfigType {}
255
-
256
- /**
257
- * <fullname>Amazon Kinesis Data Firehose API Reference</fullname>
258
- * <p>Amazon Kinesis Data Firehose is a fully managed service that delivers real-time
259
- * streaming data to destinations such as Amazon Simple Storage Service (Amazon S3), Amazon
260
- * Elasticsearch Service (Amazon ES), Amazon Redshift, and Splunk.</p>
261
- */
262
- export class FirehoseClient extends __Client<
263
- __HttpHandlerOptions,
264
- ServiceInputTypes,
265
- ServiceOutputTypes,
266
- FirehoseClientResolvedConfig
267
- > {
268
- /**
269
- * The resolved configuration of FirehoseClient class. This is resolved and normalized from the {@link FirehoseClientConfig | constructor configuration interface}.
270
- */
271
- readonly config: FirehoseClientResolvedConfig;
272
-
273
- constructor(configuration: FirehoseClientConfig) {
274
- const _config_0 = __getRuntimeConfig(configuration);
275
- const _config_1 = resolveRegionConfig(_config_0);
276
- const _config_2 = resolveEndpointsConfig(_config_1);
277
- const _config_3 = resolveRetryConfig(_config_2);
278
- const _config_4 = resolveHostHeaderConfig(_config_3);
279
- const _config_5 = resolveAwsAuthConfig(_config_4);
280
- const _config_6 = resolveUserAgentConfig(_config_5);
281
- super(_config_6);
282
- this.config = _config_6;
283
- this.middlewareStack.use(getRetryPlugin(this.config));
284
- this.middlewareStack.use(getContentLengthPlugin(this.config));
285
- this.middlewareStack.use(getHostHeaderPlugin(this.config));
286
- this.middlewareStack.use(getLoggerPlugin(this.config));
287
- this.middlewareStack.use(getAwsAuthPlugin(this.config));
288
- this.middlewareStack.use(getUserAgentPlugin(this.config));
289
- }
290
-
291
- /**
292
- * Destroy underlying resources, like sockets. It's usually not necessary to do this.
293
- * However in Node.js, it's best to explicitly shut down the client's agent when it is no longer needed.
294
- * Otherwise, sockets might stay open for quite a long time before the server terminates them.
295
- */
296
- destroy(): void {
297
- super.destroy();
298
- }
299
- }
@@ -1,163 +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 { CreateDeliveryStreamInput, CreateDeliveryStreamOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1CreateDeliveryStreamCommand,
18
- serializeAws_json1_1CreateDeliveryStreamCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface CreateDeliveryStreamCommandInput extends CreateDeliveryStreamInput {}
22
- export interface CreateDeliveryStreamCommandOutput extends CreateDeliveryStreamOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Creates a Kinesis Data Firehose delivery stream.</p>
26
- *
27
- * <p>By default, you can create up to 50 delivery streams per AWS Region.</p>
28
- * <p>This is an asynchronous operation that immediately returns. The initial status of the
29
- * delivery stream is <code>CREATING</code>. After the delivery stream is created, its status
30
- * is <code>ACTIVE</code> and it now accepts data. If the delivery stream creation fails, the
31
- * status transitions to <code>CREATING_FAILED</code>. Attempts to send data to a delivery
32
- * stream that is not in the <code>ACTIVE</code> state cause an exception. To check the state
33
- * of a delivery stream, use <a>DescribeDeliveryStream</a>.</p>
34
- * <p>If the status of a delivery stream is <code>CREATING_FAILED</code>, this status
35
- * doesn't change, and you can't invoke <code>CreateDeliveryStream</code> again on it.
36
- * However, you can invoke the <a>DeleteDeliveryStream</a> operation to delete
37
- * it.</p>
38
- * <p>A Kinesis Data Firehose delivery stream can be configured to receive records directly
39
- * from providers using <a>PutRecord</a> or <a>PutRecordBatch</a>, or it
40
- * can be configured to use an existing Kinesis stream as its source. To specify a Kinesis
41
- * data stream as input, set the <code>DeliveryStreamType</code> parameter to
42
- * <code>KinesisStreamAsSource</code>, and provide the Kinesis stream Amazon Resource Name
43
- * (ARN) and role ARN in the <code>KinesisStreamSourceConfiguration</code>
44
- * parameter.</p>
45
- * <p>To create a delivery stream with server-side encryption (SSE) enabled, include <a>DeliveryStreamEncryptionConfigurationInput</a> in your request. This is
46
- * optional. You can also invoke <a>StartDeliveryStreamEncryption</a> to turn on
47
- * SSE for an existing delivery stream that doesn't have SSE enabled.</p>
48
- * <p>A delivery stream is configured with a single destination: Amazon S3, Amazon ES,
49
- * Amazon Redshift, or Splunk. You must specify only one of the following destination
50
- * configuration parameters: <code>ExtendedS3DestinationConfiguration</code>,
51
- * <code>S3DestinationConfiguration</code>,
52
- * <code>ElasticsearchDestinationConfiguration</code>,
53
- * <code>RedshiftDestinationConfiguration</code>, or
54
- * <code>SplunkDestinationConfiguration</code>.</p>
55
- * <p>When you specify <code>S3DestinationConfiguration</code>, you can also provide the
56
- * following optional values: BufferingHints, <code>EncryptionConfiguration</code>, and
57
- * <code>CompressionFormat</code>. By default, if no <code>BufferingHints</code> value is
58
- * provided, Kinesis Data Firehose buffers data up to 5 MB or for 5 minutes, whichever
59
- * condition is satisfied first. <code>BufferingHints</code> is a hint, so there are some
60
- * cases where the service cannot adhere to these conditions strictly. For example, record
61
- * boundaries might be such that the size is a little over or under the configured buffering
62
- * size. By default, no encryption is performed. We strongly recommend that you enable
63
- * encryption to ensure secure data storage in Amazon S3.</p>
64
- *
65
- * <p>A few notes about Amazon Redshift as a destination:</p>
66
- * <ul>
67
- * <li>
68
- * <p>An Amazon Redshift destination requires an S3 bucket as intermediate location.
69
- * Kinesis Data Firehose first delivers data to Amazon S3 and then uses
70
- * <code>COPY</code> syntax to load data into an Amazon Redshift table. This is
71
- * specified in the <code>RedshiftDestinationConfiguration.S3Configuration</code>
72
- * parameter.</p>
73
- *
74
- * </li>
75
- * <li>
76
- * <p>The compression formats <code>SNAPPY</code> or <code>ZIP</code> cannot be
77
- * specified in <code>RedshiftDestinationConfiguration.S3Configuration</code> because
78
- * the Amazon Redshift <code>COPY</code> operation that reads from the S3 bucket doesn't
79
- * support these compression formats.</p>
80
- * </li>
81
- * <li>
82
- * <p>We strongly recommend that you use the user name and password you provide
83
- * exclusively with Kinesis Data Firehose, and that the permissions for the account are
84
- * restricted for Amazon Redshift <code>INSERT</code> permissions.</p>
85
- *
86
- * </li>
87
- * </ul>
88
- * <p>Kinesis Data Firehose assumes the IAM role that is configured as part of the
89
- * destination. The role should allow the Kinesis Data Firehose principal to assume the role,
90
- * and the role should have permissions that allow the service to deliver the data. For more
91
- * information, see <a href="https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3">Grant Kinesis Data
92
- * Firehose Access to an Amazon S3 Destination</a> in the <i>Amazon Kinesis Data
93
- * Firehose Developer Guide</i>.</p>
94
- * @example
95
- * Use a bare-bones client and the command you need to make an API call.
96
- * ```javascript
97
- * import { FirehoseClient, CreateDeliveryStreamCommand } from "@aws-sdk/client-firehose"; // ES Modules import
98
- * // const { FirehoseClient, CreateDeliveryStreamCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
99
- * const client = new FirehoseClient(config);
100
- * const command = new CreateDeliveryStreamCommand(input);
101
- * const response = await client.send(command);
102
- * ```
103
- *
104
- * @see {@link CreateDeliveryStreamCommandInput} for command's `input` shape.
105
- * @see {@link CreateDeliveryStreamCommandOutput} for command's `response` shape.
106
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
107
- *
108
- */
109
- export class CreateDeliveryStreamCommand extends $Command<
110
- CreateDeliveryStreamCommandInput,
111
- CreateDeliveryStreamCommandOutput,
112
- FirehoseClientResolvedConfig
113
- > {
114
- // Start section: command_properties
115
- // End section: command_properties
116
-
117
- constructor(readonly input: CreateDeliveryStreamCommandInput) {
118
- // Start section: command_constructor
119
- super();
120
- // End section: command_constructor
121
- }
122
-
123
- /**
124
- * @internal
125
- */
126
- resolveMiddleware(
127
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
128
- configuration: FirehoseClientResolvedConfig,
129
- options?: __HttpHandlerOptions
130
- ): Handler<CreateDeliveryStreamCommandInput, CreateDeliveryStreamCommandOutput> {
131
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
132
-
133
- const stack = clientStack.concat(this.middlewareStack);
134
-
135
- const { logger } = configuration;
136
- const clientName = "FirehoseClient";
137
- const commandName = "CreateDeliveryStreamCommand";
138
- const handlerExecutionContext: HandlerExecutionContext = {
139
- logger,
140
- clientName,
141
- commandName,
142
- inputFilterSensitiveLog: CreateDeliveryStreamInput.filterSensitiveLog,
143
- outputFilterSensitiveLog: CreateDeliveryStreamOutput.filterSensitiveLog,
144
- };
145
- const { requestHandler } = configuration;
146
- return stack.resolve(
147
- (request: FinalizeHandlerArguments<any>) =>
148
- requestHandler.handle(request.request as __HttpRequest, options || {}),
149
- handlerExecutionContext
150
- );
151
- }
152
-
153
- private serialize(input: CreateDeliveryStreamCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
154
- return serializeAws_json1_1CreateDeliveryStreamCommand(input, context);
155
- }
156
-
157
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<CreateDeliveryStreamCommandOutput> {
158
- return deserializeAws_json1_1CreateDeliveryStreamCommand(output, context);
159
- }
160
-
161
- // Start section: command_body_extra
162
- // End section: command_body_extra
163
- }
@@ -1,104 +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 { DeleteDeliveryStreamInput, DeleteDeliveryStreamOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1DeleteDeliveryStreamCommand,
18
- serializeAws_json1_1DeleteDeliveryStreamCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface DeleteDeliveryStreamCommandInput extends DeleteDeliveryStreamInput {}
22
- export interface DeleteDeliveryStreamCommandOutput extends DeleteDeliveryStreamOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Deletes a delivery stream and its data.</p>
26
- * <p>To check the state of a delivery stream, use <a>DescribeDeliveryStream</a>. You can delete a delivery stream only if it is in one of the following states:
27
- * <code>ACTIVE</code>, <code>DELETING</code>, <code>CREATING_FAILED</code>, or
28
- * <code>DELETING_FAILED</code>. You can't delete a delivery stream that is in the
29
- * <code>CREATING</code> state. While the deletion request is in process, the delivery
30
- * stream is in the <code>DELETING</code> state.</p>
31
- * <p>While the delivery stream is in the <code>DELETING</code> state, the service might
32
- * continue to accept records, but it doesn't make any guarantees with respect to delivering
33
- * the data. Therefore, as a best practice, first stop any applications that are sending
34
- * records before you delete a delivery stream.</p>
35
- * @example
36
- * Use a bare-bones client and the command you need to make an API call.
37
- * ```javascript
38
- * import { FirehoseClient, DeleteDeliveryStreamCommand } from "@aws-sdk/client-firehose"; // ES Modules import
39
- * // const { FirehoseClient, DeleteDeliveryStreamCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
40
- * const client = new FirehoseClient(config);
41
- * const command = new DeleteDeliveryStreamCommand(input);
42
- * const response = await client.send(command);
43
- * ```
44
- *
45
- * @see {@link DeleteDeliveryStreamCommandInput} for command's `input` shape.
46
- * @see {@link DeleteDeliveryStreamCommandOutput} for command's `response` shape.
47
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
48
- *
49
- */
50
- export class DeleteDeliveryStreamCommand extends $Command<
51
- DeleteDeliveryStreamCommandInput,
52
- DeleteDeliveryStreamCommandOutput,
53
- FirehoseClientResolvedConfig
54
- > {
55
- // Start section: command_properties
56
- // End section: command_properties
57
-
58
- constructor(readonly input: DeleteDeliveryStreamCommandInput) {
59
- // Start section: command_constructor
60
- super();
61
- // End section: command_constructor
62
- }
63
-
64
- /**
65
- * @internal
66
- */
67
- resolveMiddleware(
68
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
69
- configuration: FirehoseClientResolvedConfig,
70
- options?: __HttpHandlerOptions
71
- ): Handler<DeleteDeliveryStreamCommandInput, DeleteDeliveryStreamCommandOutput> {
72
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
73
-
74
- const stack = clientStack.concat(this.middlewareStack);
75
-
76
- const { logger } = configuration;
77
- const clientName = "FirehoseClient";
78
- const commandName = "DeleteDeliveryStreamCommand";
79
- const handlerExecutionContext: HandlerExecutionContext = {
80
- logger,
81
- clientName,
82
- commandName,
83
- inputFilterSensitiveLog: DeleteDeliveryStreamInput.filterSensitiveLog,
84
- outputFilterSensitiveLog: DeleteDeliveryStreamOutput.filterSensitiveLog,
85
- };
86
- const { requestHandler } = configuration;
87
- return stack.resolve(
88
- (request: FinalizeHandlerArguments<any>) =>
89
- requestHandler.handle(request.request as __HttpRequest, options || {}),
90
- handlerExecutionContext
91
- );
92
- }
93
-
94
- private serialize(input: DeleteDeliveryStreamCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
95
- return serializeAws_json1_1DeleteDeliveryStreamCommand(input, context);
96
- }
97
-
98
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<DeleteDeliveryStreamCommandOutput> {
99
- return deserializeAws_json1_1DeleteDeliveryStreamCommand(output, context);
100
- }
101
-
102
- // Start section: command_body_extra
103
- // End section: command_body_extra
104
- }
@@ -1,101 +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 { DescribeDeliveryStreamInput, DescribeDeliveryStreamOutput } from "../models/models_0";
16
- import {
17
- deserializeAws_json1_1DescribeDeliveryStreamCommand,
18
- serializeAws_json1_1DescribeDeliveryStreamCommand,
19
- } from "../protocols/Aws_json1_1";
20
-
21
- export interface DescribeDeliveryStreamCommandInput extends DescribeDeliveryStreamInput {}
22
- export interface DescribeDeliveryStreamCommandOutput extends DescribeDeliveryStreamOutput, __MetadataBearer {}
23
-
24
- /**
25
- * <p>Describes the specified delivery stream and its status. For example, after your
26
- * delivery stream is created, call <code>DescribeDeliveryStream</code> to see whether the
27
- * delivery stream is <code>ACTIVE</code> and therefore ready for data to be sent to it. </p>
28
- * <p>If the status of a delivery stream is <code>CREATING_FAILED</code>, this status
29
- * doesn't change, and you can't invoke <a>CreateDeliveryStream</a> again on it.
30
- * However, you can invoke the <a>DeleteDeliveryStream</a> operation to delete it.
31
- * If the status is <code>DELETING_FAILED</code>, you can force deletion by invoking <a>DeleteDeliveryStream</a> again but with <a>DeleteDeliveryStreamInput$AllowForceDelete</a> set to true.</p>
32
- * @example
33
- * Use a bare-bones client and the command you need to make an API call.
34
- * ```javascript
35
- * import { FirehoseClient, DescribeDeliveryStreamCommand } from "@aws-sdk/client-firehose"; // ES Modules import
36
- * // const { FirehoseClient, DescribeDeliveryStreamCommand } = require("@aws-sdk/client-firehose"); // CommonJS import
37
- * const client = new FirehoseClient(config);
38
- * const command = new DescribeDeliveryStreamCommand(input);
39
- * const response = await client.send(command);
40
- * ```
41
- *
42
- * @see {@link DescribeDeliveryStreamCommandInput} for command's `input` shape.
43
- * @see {@link DescribeDeliveryStreamCommandOutput} for command's `response` shape.
44
- * @see {@link FirehoseClientResolvedConfig | config} for command's `input` shape.
45
- *
46
- */
47
- export class DescribeDeliveryStreamCommand extends $Command<
48
- DescribeDeliveryStreamCommandInput,
49
- DescribeDeliveryStreamCommandOutput,
50
- FirehoseClientResolvedConfig
51
- > {
52
- // Start section: command_properties
53
- // End section: command_properties
54
-
55
- constructor(readonly input: DescribeDeliveryStreamCommandInput) {
56
- // Start section: command_constructor
57
- super();
58
- // End section: command_constructor
59
- }
60
-
61
- /**
62
- * @internal
63
- */
64
- resolveMiddleware(
65
- clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
66
- configuration: FirehoseClientResolvedConfig,
67
- options?: __HttpHandlerOptions
68
- ): Handler<DescribeDeliveryStreamCommandInput, DescribeDeliveryStreamCommandOutput> {
69
- this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
70
-
71
- const stack = clientStack.concat(this.middlewareStack);
72
-
73
- const { logger } = configuration;
74
- const clientName = "FirehoseClient";
75
- const commandName = "DescribeDeliveryStreamCommand";
76
- const handlerExecutionContext: HandlerExecutionContext = {
77
- logger,
78
- clientName,
79
- commandName,
80
- inputFilterSensitiveLog: DescribeDeliveryStreamInput.filterSensitiveLog,
81
- outputFilterSensitiveLog: DescribeDeliveryStreamOutput.filterSensitiveLog,
82
- };
83
- const { requestHandler } = configuration;
84
- return stack.resolve(
85
- (request: FinalizeHandlerArguments<any>) =>
86
- requestHandler.handle(request.request as __HttpRequest, options || {}),
87
- handlerExecutionContext
88
- );
89
- }
90
-
91
- private serialize(input: DescribeDeliveryStreamCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
92
- return serializeAws_json1_1DescribeDeliveryStreamCommand(input, context);
93
- }
94
-
95
- private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<DescribeDeliveryStreamCommandOutput> {
96
- return deserializeAws_json1_1DescribeDeliveryStreamCommand(output, context);
97
- }
98
-
99
- // Start section: command_body_extra
100
- // End section: command_body_extra
101
- }