aws-sdk-osis 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1048 @@
1
+ # frozen_string_literal: true
2
+
3
+ # WARNING ABOUT GENERATED CODE
4
+ #
5
+ # This file is generated. See the contributing guide for more information:
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
+ #
8
+ # WARNING ABOUT GENERATED CODE
9
+
10
+ require 'seahorse/client/plugins/content_length.rb'
11
+ require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
+ require 'aws-sdk-core/plugins/logging.rb'
13
+ require 'aws-sdk-core/plugins/param_converter.rb'
14
+ require 'aws-sdk-core/plugins/param_validator.rb'
15
+ require 'aws-sdk-core/plugins/user_agent.rb'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
+ require 'aws-sdk-core/plugins/retry_errors.rb'
18
+ require 'aws-sdk-core/plugins/global_configuration.rb'
19
+ require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
+ require 'aws-sdk-core/plugins/response_paging.rb'
23
+ require 'aws-sdk-core/plugins/stub_responses.rb'
24
+ require 'aws-sdk-core/plugins/idempotency_token.rb'
25
+ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
26
+ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
+ require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
32
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
33
+ require 'aws-sdk-core/plugins/sign.rb'
34
+ require 'aws-sdk-core/plugins/protocols/rest_json.rb'
35
+
36
+ Aws::Plugins::GlobalConfiguration.add_identifier(:osis)
37
+
38
+ module Aws::OSIS
39
+ # An API client for OSIS. To construct a client, you need to configure a `:region` and `:credentials`.
40
+ #
41
+ # client = Aws::OSIS::Client.new(
42
+ # region: region_name,
43
+ # credentials: credentials,
44
+ # # ...
45
+ # )
46
+ #
47
+ # For details on configuring region and credentials see
48
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
49
+ #
50
+ # See {#initialize} for a full list of supported configuration options.
51
+ class Client < Seahorse::Client::Base
52
+
53
+ include Aws::ClientStubs
54
+
55
+ @identifier = :osis
56
+
57
+ set_api(ClientApi::API)
58
+
59
+ add_plugin(Seahorse::Client::Plugins::ContentLength)
60
+ add_plugin(Aws::Plugins::CredentialsConfiguration)
61
+ add_plugin(Aws::Plugins::Logging)
62
+ add_plugin(Aws::Plugins::ParamConverter)
63
+ add_plugin(Aws::Plugins::ParamValidator)
64
+ add_plugin(Aws::Plugins::UserAgent)
65
+ add_plugin(Aws::Plugins::HelpfulSocketErrors)
66
+ add_plugin(Aws::Plugins::RetryErrors)
67
+ add_plugin(Aws::Plugins::GlobalConfiguration)
68
+ add_plugin(Aws::Plugins::RegionalEndpoint)
69
+ add_plugin(Aws::Plugins::EndpointDiscovery)
70
+ add_plugin(Aws::Plugins::EndpointPattern)
71
+ add_plugin(Aws::Plugins::ResponsePaging)
72
+ add_plugin(Aws::Plugins::StubResponses)
73
+ add_plugin(Aws::Plugins::IdempotencyToken)
74
+ add_plugin(Aws::Plugins::JsonvalueConverter)
75
+ add_plugin(Aws::Plugins::ClientMetricsPlugin)
76
+ add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
77
+ add_plugin(Aws::Plugins::TransferEncoding)
78
+ add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
80
+ add_plugin(Aws::Plugins::DefaultsMode)
81
+ add_plugin(Aws::Plugins::RecursionDetection)
82
+ add_plugin(Aws::Plugins::Sign)
83
+ add_plugin(Aws::Plugins::Protocols::RestJson)
84
+ add_plugin(Aws::OSIS::Plugins::Endpoints)
85
+
86
+ # @overload initialize(options)
87
+ # @param [Hash] options
88
+ # @option options [required, Aws::CredentialProvider] :credentials
89
+ # Your AWS credentials. This can be an instance of any one of the
90
+ # following classes:
91
+ #
92
+ # * `Aws::Credentials` - Used for configuring static, non-refreshing
93
+ # credentials.
94
+ #
95
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
96
+ # shared file, such as `~/.aws/config`.
97
+ #
98
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
99
+ #
100
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
101
+ # assume a role after providing credentials via the web.
102
+ #
103
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
104
+ # access token generated from `aws login`.
105
+ #
106
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
107
+ # process that outputs to stdout.
108
+ #
109
+ # * `Aws::InstanceProfileCredentials` - Used for loading credentials
110
+ # from an EC2 IMDS on an EC2 instance.
111
+ #
112
+ # * `Aws::ECSCredentials` - Used for loading credentials from
113
+ # instances running in ECS.
114
+ #
115
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
116
+ # from the Cognito Identity service.
117
+ #
118
+ # When `:credentials` are not configured directly, the following
119
+ # locations will be searched for credentials:
120
+ #
121
+ # * `Aws.config[:credentials]`
122
+ # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
123
+ # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
124
+ # * `~/.aws/credentials`
125
+ # * `~/.aws/config`
126
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
127
+ # are very aggressive. Construct and pass an instance of
128
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
129
+ # enable retries and extended timeouts. Instance profile credential
130
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
131
+ # to true.
132
+ #
133
+ # @option options [required, String] :region
134
+ # The AWS region to connect to. The configured `:region` is
135
+ # used to determine the service `:endpoint`. When not passed,
136
+ # a default `:region` is searched for in the following locations:
137
+ #
138
+ # * `Aws.config[:region]`
139
+ # * `ENV['AWS_REGION']`
140
+ # * `ENV['AMAZON_REGION']`
141
+ # * `ENV['AWS_DEFAULT_REGION']`
142
+ # * `~/.aws/credentials`
143
+ # * `~/.aws/config`
144
+ #
145
+ # @option options [String] :access_key_id
146
+ #
147
+ # @option options [Boolean] :active_endpoint_cache (false)
148
+ # When set to `true`, a thread polling for endpoints will be running in
149
+ # the background every 60 secs (default). Defaults to `false`.
150
+ #
151
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
152
+ # Used only in `adaptive` retry mode. When true, the request will sleep
153
+ # until there is sufficent client side capacity to retry the request.
154
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
155
+ # not retry instead of sleeping.
156
+ #
157
+ # @option options [Boolean] :client_side_monitoring (false)
158
+ # When `true`, client-side metrics will be collected for all API requests from
159
+ # this client.
160
+ #
161
+ # @option options [String] :client_side_monitoring_client_id ("")
162
+ # Allows you to provide an identifier for this client which will be attached to
163
+ # all generated client side metrics. Defaults to an empty string.
164
+ #
165
+ # @option options [String] :client_side_monitoring_host ("127.0.0.1")
166
+ # Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client
167
+ # side monitoring agent is running on, where client metrics will be published via UDP.
168
+ #
169
+ # @option options [Integer] :client_side_monitoring_port (31000)
170
+ # Required for publishing client metrics. The port that the client side monitoring
171
+ # agent is running on, where client metrics will be published via UDP.
172
+ #
173
+ # @option options [Aws::ClientSideMonitoring::Publisher] :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher)
174
+ # Allows you to provide a custom client-side monitoring publisher class. By default,
175
+ # will use the Client Side Monitoring Agent Publisher.
176
+ #
177
+ # @option options [Boolean] :convert_params (true)
178
+ # When `true`, an attempt is made to coerce request parameters into
179
+ # the required types.
180
+ #
181
+ # @option options [Boolean] :correct_clock_skew (true)
182
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
183
+ # a clock skew correction and retry requests with skewed client clocks.
184
+ #
185
+ # @option options [String] :defaults_mode ("legacy")
186
+ # See {Aws::DefaultsModeConfiguration} for a list of the
187
+ # accepted modes and the configuration defaults that are included.
188
+ #
189
+ # @option options [Boolean] :disable_host_prefix_injection (false)
190
+ # Set to true to disable SDK automatically adding host prefix
191
+ # to default service endpoint when available.
192
+ #
193
+ # @option options [String] :endpoint
194
+ # The client endpoint is normally constructed from the `:region`
195
+ # option. You should only configure an `:endpoint` when connecting
196
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
197
+ #
198
+ # @option options [Integer] :endpoint_cache_max_entries (1000)
199
+ # Used for the maximum size limit of the LRU cache storing endpoints data
200
+ # for endpoint discovery enabled operations. Defaults to 1000.
201
+ #
202
+ # @option options [Integer] :endpoint_cache_max_threads (10)
203
+ # Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
204
+ #
205
+ # @option options [Integer] :endpoint_cache_poll_interval (60)
206
+ # When :endpoint_discovery and :active_endpoint_cache is enabled,
207
+ # Use this option to config the time interval in seconds for making
208
+ # requests fetching endpoints information. Defaults to 60 sec.
209
+ #
210
+ # @option options [Boolean] :endpoint_discovery (false)
211
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
212
+ #
213
+ # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
214
+ # The log formatter.
215
+ #
216
+ # @option options [Symbol] :log_level (:info)
217
+ # The log level to send messages to the `:logger` at.
218
+ #
219
+ # @option options [Logger] :logger
220
+ # The Logger instance to send log messages to. If this option
221
+ # is not set, logging will be disabled.
222
+ #
223
+ # @option options [Integer] :max_attempts (3)
224
+ # An integer representing the maximum number attempts that will be made for
225
+ # a single request, including the initial attempt. For example,
226
+ # setting this value to 5 will result in a request being retried up to
227
+ # 4 times. Used in `standard` and `adaptive` retry modes.
228
+ #
229
+ # @option options [String] :profile ("default")
230
+ # Used when loading credentials from the shared credentials file
231
+ # at HOME/.aws/credentials. When not specified, 'default' is used.
232
+ #
233
+ # @option options [Proc] :retry_backoff
234
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
235
+ # This option is only used in the `legacy` retry mode.
236
+ #
237
+ # @option options [Float] :retry_base_delay (0.3)
238
+ # The base delay in seconds used by the default backoff function. This option
239
+ # is only used in the `legacy` retry mode.
240
+ #
241
+ # @option options [Symbol] :retry_jitter (:none)
242
+ # A delay randomiser function used by the default backoff function.
243
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
244
+ # otherwise a Proc that takes and returns a number. This option is only used
245
+ # in the `legacy` retry mode.
246
+ #
247
+ # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
248
+ #
249
+ # @option options [Integer] :retry_limit (3)
250
+ # The maximum number of times to retry failed requests. Only
251
+ # ~ 500 level server errors and certain ~ 400 level client errors
252
+ # are retried. Generally, these are throttling errors, data
253
+ # checksum errors, networking errors, timeout errors, auth errors,
254
+ # endpoint discovery, and errors from expired credentials.
255
+ # This option is only used in the `legacy` retry mode.
256
+ #
257
+ # @option options [Integer] :retry_max_delay (0)
258
+ # The maximum number of seconds to delay between retries (0 for no limit)
259
+ # used by the default backoff function. This option is only used in the
260
+ # `legacy` retry mode.
261
+ #
262
+ # @option options [String] :retry_mode ("legacy")
263
+ # Specifies which retry algorithm to use. Values are:
264
+ #
265
+ # * `legacy` - The pre-existing retry behavior. This is default value if
266
+ # no retry mode is provided.
267
+ #
268
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
269
+ # This includes support for retry quotas, which limit the number of
270
+ # unsuccessful retries a client can make.
271
+ #
272
+ # * `adaptive` - An experimental retry mode that includes all the
273
+ # functionality of `standard` mode along with automatic client side
274
+ # throttling. This is a provisional mode that may change behavior
275
+ # in the future.
276
+ #
277
+ #
278
+ # @option options [String] :secret_access_key
279
+ #
280
+ # @option options [String] :session_token
281
+ #
282
+ # @option options [Boolean] :stub_responses (false)
283
+ # Causes the client to return stubbed responses. By default
284
+ # fake responses are generated and returned. You can specify
285
+ # the response data to return or errors to raise by calling
286
+ # {ClientStubs#stub_responses}. See {ClientStubs} for more information.
287
+ #
288
+ # ** Please note ** When response stubbing is enabled, no HTTP
289
+ # requests are made, and retries are disabled.
290
+ #
291
+ # @option options [Aws::TokenProvider] :token_provider
292
+ # A Bearer Token Provider. This can be an instance of any one of the
293
+ # following classes:
294
+ #
295
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
296
+ # tokens.
297
+ #
298
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
299
+ # access token generated from `aws login`.
300
+ #
301
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
302
+ # will be used to search for tokens configured for your profile in shared configuration files.
303
+ #
304
+ # @option options [Boolean] :use_dualstack_endpoint
305
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
306
+ # will be used if available.
307
+ #
308
+ # @option options [Boolean] :use_fips_endpoint
309
+ # When set to `true`, fips compatible endpoints will be used if available.
310
+ # When a `fips` region is used, the region is normalized and this config
311
+ # is set to `true`.
312
+ #
313
+ # @option options [Boolean] :validate_params (true)
314
+ # When `true`, request parameters are validated before
315
+ # sending the request.
316
+ #
317
+ # @option options [Aws::OSIS::EndpointProvider] :endpoint_provider
318
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::OSIS::EndpointParameters`
319
+ #
320
+ # @option options [URI::HTTP,String] :http_proxy A proxy to send
321
+ # requests through. Formatted like 'http://proxy.com:123'.
322
+ #
323
+ # @option options [Float] :http_open_timeout (15) The number of
324
+ # seconds to wait when opening a HTTP session before raising a
325
+ # `Timeout::Error`.
326
+ #
327
+ # @option options [Float] :http_read_timeout (60) The default
328
+ # number of seconds to wait for response data. This value can
329
+ # safely be set per-request on the session.
330
+ #
331
+ # @option options [Float] :http_idle_timeout (5) The number of
332
+ # seconds a connection is allowed to sit idle before it is
333
+ # considered stale. Stale connections are closed and removed
334
+ # from the pool before making a request.
335
+ #
336
+ # @option options [Float] :http_continue_timeout (1) The number of
337
+ # seconds to wait for a 100-continue response before sending the
338
+ # request body. This option has no effect unless the request has
339
+ # "Expect" header set to "100-continue". Defaults to `nil` which
340
+ # disables this behaviour. This value can safely be set per
341
+ # request on the session.
342
+ #
343
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
344
+ # in seconds.
345
+ #
346
+ # @option options [Boolean] :http_wire_trace (false) When `true`,
347
+ # HTTP debug output will be sent to the `:logger`.
348
+ #
349
+ # @option options [Boolean] :ssl_verify_peer (true) When `true`,
350
+ # SSL peer certificates are verified when establishing a
351
+ # connection.
352
+ #
353
+ # @option options [String] :ssl_ca_bundle Full path to the SSL
354
+ # certificate authority bundle file that should be used when
355
+ # verifying peer certificates. If you do not pass
356
+ # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
357
+ # will be used if available.
358
+ #
359
+ # @option options [String] :ssl_ca_directory Full path of the
360
+ # directory that contains the unbundled SSL certificate
361
+ # authority files for verifying peer certificates. If you do
362
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
363
+ # system default will be used if available.
364
+ #
365
+ def initialize(*args)
366
+ super
367
+ end
368
+
369
+ # @!group API Operations
370
+
371
+ # Creates an OpenSearch Ingestion pipeline. For more information, see
372
+ # [Creating and managing OpenSearch Ingestion pipelines][1].
373
+ #
374
+ #
375
+ #
376
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html
377
+ #
378
+ # @option params [required, String] :pipeline_name
379
+ # The name of the OpenSearch Ingestion pipeline to create. Pipeline
380
+ # names are unique across the pipelines owned by an account within an
381
+ # Amazon Web Services Region.
382
+ #
383
+ # @option params [required, Integer] :min_units
384
+ # The minimum pipeline capacity, in Ingestion Compute Units (ICUs).
385
+ #
386
+ # @option params [required, Integer] :max_units
387
+ # The maximum pipeline capacity, in Ingestion Compute Units (ICUs).
388
+ #
389
+ # @option params [required, String] :pipeline_configuration_body
390
+ # The pipeline configuration in YAML format. The command accepts the
391
+ # pipeline configuration as a string or within a .yaml file. If you
392
+ # provide the configuration as a string, each new line must be escaped
393
+ # with `\n`.
394
+ #
395
+ # @option params [Types::LogPublishingOptions] :log_publishing_options
396
+ # Key-value pairs to configure log publishing.
397
+ #
398
+ # @option params [Types::VpcOptions] :vpc_options
399
+ # Container for the values required to configure VPC access for the
400
+ # pipeline. If you don't specify these values, OpenSearch Ingestion
401
+ # creates the pipeline with a public endpoint.
402
+ #
403
+ # @option params [Array<Types::Tag>] :tags
404
+ # List of tags to add to the pipeline upon creation.
405
+ #
406
+ # @return [Types::CreatePipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
407
+ #
408
+ # * {Types::CreatePipelineResponse#pipeline #pipeline} => Types::Pipeline
409
+ #
410
+ # @example Request syntax with placeholder values
411
+ #
412
+ # resp = client.create_pipeline({
413
+ # pipeline_name: "PipelineName", # required
414
+ # min_units: 1, # required
415
+ # max_units: 1, # required
416
+ # pipeline_configuration_body: "PipelineConfigurationBody", # required
417
+ # log_publishing_options: {
418
+ # is_logging_enabled: false,
419
+ # cloud_watch_log_destination: {
420
+ # log_group: "LogGroup", # required
421
+ # },
422
+ # },
423
+ # vpc_options: {
424
+ # subnet_ids: ["SubnetId"], # required
425
+ # security_group_ids: ["SecurityGroupId"],
426
+ # },
427
+ # tags: [
428
+ # {
429
+ # key: "TagKey", # required
430
+ # value: "TagValue", # required
431
+ # },
432
+ # ],
433
+ # })
434
+ #
435
+ # @example Response structure
436
+ #
437
+ # resp.pipeline.pipeline_name #=> String
438
+ # resp.pipeline.pipeline_arn #=> String
439
+ # resp.pipeline.min_units #=> Integer
440
+ # resp.pipeline.max_units #=> Integer
441
+ # resp.pipeline.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
442
+ # resp.pipeline.status_reason.description #=> String
443
+ # resp.pipeline.pipeline_configuration_body #=> String
444
+ # resp.pipeline.created_at #=> Time
445
+ # resp.pipeline.last_updated_at #=> Time
446
+ # resp.pipeline.ingest_endpoint_urls #=> Array
447
+ # resp.pipeline.ingest_endpoint_urls[0] #=> String
448
+ # resp.pipeline.log_publishing_options.is_logging_enabled #=> Boolean
449
+ # resp.pipeline.log_publishing_options.cloud_watch_log_destination.log_group #=> String
450
+ # resp.pipeline.vpc_endpoints #=> Array
451
+ # resp.pipeline.vpc_endpoints[0].vpc_endpoint_id #=> String
452
+ # resp.pipeline.vpc_endpoints[0].vpc_id #=> String
453
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids #=> Array
454
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids[0] #=> String
455
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids #=> Array
456
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids[0] #=> String
457
+ #
458
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/CreatePipeline AWS API Documentation
459
+ #
460
+ # @overload create_pipeline(params = {})
461
+ # @param [Hash] params ({})
462
+ def create_pipeline(params = {}, options = {})
463
+ req = build_request(:create_pipeline, params)
464
+ req.send_request(options)
465
+ end
466
+
467
+ # Deletes an OpenSearch Ingestion pipeline. For more information, see
468
+ # [Deleting pipelines][1].
469
+ #
470
+ #
471
+ #
472
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html#delete-pipeline
473
+ #
474
+ # @option params [required, String] :pipeline_name
475
+ # The name of the pipeline to delete.
476
+ #
477
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
478
+ #
479
+ # @example Request syntax with placeholder values
480
+ #
481
+ # resp = client.delete_pipeline({
482
+ # pipeline_name: "PipelineName", # required
483
+ # })
484
+ #
485
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/DeletePipeline AWS API Documentation
486
+ #
487
+ # @overload delete_pipeline(params = {})
488
+ # @param [Hash] params ({})
489
+ def delete_pipeline(params = {}, options = {})
490
+ req = build_request(:delete_pipeline, params)
491
+ req.send_request(options)
492
+ end
493
+
494
+ # Retrieves information about an OpenSearch Ingestion pipeline.
495
+ #
496
+ # @option params [required, String] :pipeline_name
497
+ # The name of the pipeline to get information about.
498
+ #
499
+ # @return [Types::GetPipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
500
+ #
501
+ # * {Types::GetPipelineResponse#pipeline #pipeline} => Types::Pipeline
502
+ #
503
+ # @example Request syntax with placeholder values
504
+ #
505
+ # resp = client.get_pipeline({
506
+ # pipeline_name: "PipelineName", # required
507
+ # })
508
+ #
509
+ # @example Response structure
510
+ #
511
+ # resp.pipeline.pipeline_name #=> String
512
+ # resp.pipeline.pipeline_arn #=> String
513
+ # resp.pipeline.min_units #=> Integer
514
+ # resp.pipeline.max_units #=> Integer
515
+ # resp.pipeline.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
516
+ # resp.pipeline.status_reason.description #=> String
517
+ # resp.pipeline.pipeline_configuration_body #=> String
518
+ # resp.pipeline.created_at #=> Time
519
+ # resp.pipeline.last_updated_at #=> Time
520
+ # resp.pipeline.ingest_endpoint_urls #=> Array
521
+ # resp.pipeline.ingest_endpoint_urls[0] #=> String
522
+ # resp.pipeline.log_publishing_options.is_logging_enabled #=> Boolean
523
+ # resp.pipeline.log_publishing_options.cloud_watch_log_destination.log_group #=> String
524
+ # resp.pipeline.vpc_endpoints #=> Array
525
+ # resp.pipeline.vpc_endpoints[0].vpc_endpoint_id #=> String
526
+ # resp.pipeline.vpc_endpoints[0].vpc_id #=> String
527
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids #=> Array
528
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids[0] #=> String
529
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids #=> Array
530
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids[0] #=> String
531
+ #
532
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/GetPipeline AWS API Documentation
533
+ #
534
+ # @overload get_pipeline(params = {})
535
+ # @param [Hash] params ({})
536
+ def get_pipeline(params = {}, options = {})
537
+ req = build_request(:get_pipeline, params)
538
+ req.send_request(options)
539
+ end
540
+
541
+ # Retrieves information about a specific blueprint for OpenSearch
542
+ # Ingestion. Blueprints are templates for the configuration needed for a
543
+ # `CreatePipeline` request.
544
+ #
545
+ # @option params [required, String] :blueprint_name
546
+ # The name of the blueprint to retrieve.
547
+ #
548
+ # @return [Types::GetPipelineBlueprintResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
549
+ #
550
+ # * {Types::GetPipelineBlueprintResponse#blueprint #blueprint} => Types::PipelineBlueprint
551
+ #
552
+ # @example Request syntax with placeholder values
553
+ #
554
+ # resp = client.get_pipeline_blueprint({
555
+ # blueprint_name: "String", # required
556
+ # })
557
+ #
558
+ # @example Response structure
559
+ #
560
+ # resp.blueprint.blueprint_name #=> String
561
+ # resp.blueprint.pipeline_configuration_body #=> String
562
+ #
563
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/GetPipelineBlueprint AWS API Documentation
564
+ #
565
+ # @overload get_pipeline_blueprint(params = {})
566
+ # @param [Hash] params ({})
567
+ def get_pipeline_blueprint(params = {}, options = {})
568
+ req = build_request(:get_pipeline_blueprint, params)
569
+ req.send_request(options)
570
+ end
571
+
572
+ # Returns progress information for the current change happening on an
573
+ # OpenSearch Ingestion pipeline. Currently, this operation only returns
574
+ # information when a pipeline is being created.
575
+ #
576
+ # For more information, see [Creating and managing OpenSearch Ingestion
577
+ # pipelines][1].
578
+ #
579
+ #
580
+ #
581
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html
582
+ #
583
+ # @option params [required, String] :pipeline_name
584
+ # The name of the pipeline.
585
+ #
586
+ # @return [Types::GetPipelineChangeProgressResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
587
+ #
588
+ # * {Types::GetPipelineChangeProgressResponse#change_progress_statuses #change_progress_statuses} => Array&lt;Types::ChangeProgressStatus&gt;
589
+ #
590
+ # @example Request syntax with placeholder values
591
+ #
592
+ # resp = client.get_pipeline_change_progress({
593
+ # pipeline_name: "PipelineName", # required
594
+ # })
595
+ #
596
+ # @example Response structure
597
+ #
598
+ # resp.change_progress_statuses #=> Array
599
+ # resp.change_progress_statuses[0].start_time #=> Time
600
+ # resp.change_progress_statuses[0].status #=> String, one of "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED"
601
+ # resp.change_progress_statuses[0].total_number_of_stages #=> Integer
602
+ # resp.change_progress_statuses[0].change_progress_stages #=> Array
603
+ # resp.change_progress_statuses[0].change_progress_stages[0].name #=> String
604
+ # resp.change_progress_statuses[0].change_progress_stages[0].status #=> String, one of "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED"
605
+ # resp.change_progress_statuses[0].change_progress_stages[0].description #=> String
606
+ # resp.change_progress_statuses[0].change_progress_stages[0].last_updated_at #=> Time
607
+ #
608
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/GetPipelineChangeProgress AWS API Documentation
609
+ #
610
+ # @overload get_pipeline_change_progress(params = {})
611
+ # @param [Hash] params ({})
612
+ def get_pipeline_change_progress(params = {}, options = {})
613
+ req = build_request(:get_pipeline_change_progress, params)
614
+ req.send_request(options)
615
+ end
616
+
617
+ # Retrieves a list of all available blueprints for Data Prepper.
618
+ #
619
+ # @return [Types::ListPipelineBlueprintsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
620
+ #
621
+ # * {Types::ListPipelineBlueprintsResponse#blueprints #blueprints} => Array&lt;Types::PipelineBlueprintSummary&gt;
622
+ #
623
+ # @example Response structure
624
+ #
625
+ # resp.blueprints #=> Array
626
+ # resp.blueprints[0].blueprint_name #=> String
627
+ #
628
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/ListPipelineBlueprints AWS API Documentation
629
+ #
630
+ # @overload list_pipeline_blueprints(params = {})
631
+ # @param [Hash] params ({})
632
+ def list_pipeline_blueprints(params = {}, options = {})
633
+ req = build_request(:list_pipeline_blueprints, params)
634
+ req.send_request(options)
635
+ end
636
+
637
+ # Lists all OpenSearch Ingestion pipelines in the current Amazon Web
638
+ # Services account and Region. For more information, see [Creating and
639
+ # managing OpenSearch Ingestion pipelines][1].
640
+ #
641
+ #
642
+ #
643
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html
644
+ #
645
+ # @option params [Integer] :max_results
646
+ # An optional parameter that specifies the maximum number of results to
647
+ # return. You can use `nextToken` to get the next page of results.
648
+ #
649
+ # @option params [String] :next_token
650
+ # If your initial `ListPipelines` operation returns a `nextToken`, you
651
+ # can include the returned `nextToken` in subsequent `ListPipelines`
652
+ # operations, which returns results in the next page.
653
+ #
654
+ # @return [Types::ListPipelinesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
655
+ #
656
+ # * {Types::ListPipelinesResponse#next_token #next_token} => String
657
+ # * {Types::ListPipelinesResponse#pipelines #pipelines} => Array&lt;Types::PipelineSummary&gt;
658
+ #
659
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
660
+ #
661
+ # @example Request syntax with placeholder values
662
+ #
663
+ # resp = client.list_pipelines({
664
+ # max_results: 1,
665
+ # next_token: "NextToken",
666
+ # })
667
+ #
668
+ # @example Response structure
669
+ #
670
+ # resp.next_token #=> String
671
+ # resp.pipelines #=> Array
672
+ # resp.pipelines[0].status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
673
+ # resp.pipelines[0].status_reason.description #=> String
674
+ # resp.pipelines[0].pipeline_name #=> String
675
+ # resp.pipelines[0].pipeline_arn #=> String
676
+ # resp.pipelines[0].min_units #=> Integer
677
+ # resp.pipelines[0].max_units #=> Integer
678
+ # resp.pipelines[0].created_at #=> Time
679
+ # resp.pipelines[0].last_updated_at #=> Time
680
+ #
681
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/ListPipelines AWS API Documentation
682
+ #
683
+ # @overload list_pipelines(params = {})
684
+ # @param [Hash] params ({})
685
+ def list_pipelines(params = {}, options = {})
686
+ req = build_request(:list_pipelines, params)
687
+ req.send_request(options)
688
+ end
689
+
690
+ # Lists all resource tags associated with an OpenSearch Ingestion
691
+ # pipeline. For more information, see [Tagging OpenSearch Ingestion
692
+ # pipelines][1].
693
+ #
694
+ #
695
+ #
696
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html
697
+ #
698
+ # @option params [required, String] :arn
699
+ # The Amazon Resource Name (ARN) of the pipeline to retrieve tags for.
700
+ #
701
+ # @return [Types::ListTagsForResourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
702
+ #
703
+ # * {Types::ListTagsForResourceResponse#tags #tags} => Array&lt;Types::Tag&gt;
704
+ #
705
+ # @example Request syntax with placeholder values
706
+ #
707
+ # resp = client.list_tags_for_resource({
708
+ # arn: "PipelineArn", # required
709
+ # })
710
+ #
711
+ # @example Response structure
712
+ #
713
+ # resp.tags #=> Array
714
+ # resp.tags[0].key #=> String
715
+ # resp.tags[0].value #=> String
716
+ #
717
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/ListTagsForResource AWS API Documentation
718
+ #
719
+ # @overload list_tags_for_resource(params = {})
720
+ # @param [Hash] params ({})
721
+ def list_tags_for_resource(params = {}, options = {})
722
+ req = build_request(:list_tags_for_resource, params)
723
+ req.send_request(options)
724
+ end
725
+
726
+ # Starts an OpenSearch Ingestion pipeline. For more information, see
727
+ # [Starting pipelines][1].
728
+ #
729
+ #
730
+ #
731
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html#start-pipeline
732
+ #
733
+ # @option params [required, String] :pipeline_name
734
+ # The name of the pipeline to start.
735
+ #
736
+ # @return [Types::StartPipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
737
+ #
738
+ # * {Types::StartPipelineResponse#pipeline #pipeline} => Types::Pipeline
739
+ #
740
+ # @example Request syntax with placeholder values
741
+ #
742
+ # resp = client.start_pipeline({
743
+ # pipeline_name: "PipelineName", # required
744
+ # })
745
+ #
746
+ # @example Response structure
747
+ #
748
+ # resp.pipeline.pipeline_name #=> String
749
+ # resp.pipeline.pipeline_arn #=> String
750
+ # resp.pipeline.min_units #=> Integer
751
+ # resp.pipeline.max_units #=> Integer
752
+ # resp.pipeline.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
753
+ # resp.pipeline.status_reason.description #=> String
754
+ # resp.pipeline.pipeline_configuration_body #=> String
755
+ # resp.pipeline.created_at #=> Time
756
+ # resp.pipeline.last_updated_at #=> Time
757
+ # resp.pipeline.ingest_endpoint_urls #=> Array
758
+ # resp.pipeline.ingest_endpoint_urls[0] #=> String
759
+ # resp.pipeline.log_publishing_options.is_logging_enabled #=> Boolean
760
+ # resp.pipeline.log_publishing_options.cloud_watch_log_destination.log_group #=> String
761
+ # resp.pipeline.vpc_endpoints #=> Array
762
+ # resp.pipeline.vpc_endpoints[0].vpc_endpoint_id #=> String
763
+ # resp.pipeline.vpc_endpoints[0].vpc_id #=> String
764
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids #=> Array
765
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids[0] #=> String
766
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids #=> Array
767
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids[0] #=> String
768
+ #
769
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/StartPipeline AWS API Documentation
770
+ #
771
+ # @overload start_pipeline(params = {})
772
+ # @param [Hash] params ({})
773
+ def start_pipeline(params = {}, options = {})
774
+ req = build_request(:start_pipeline, params)
775
+ req.send_request(options)
776
+ end
777
+
778
+ # Stops an OpenSearch Ingestion pipeline. For more information, see
779
+ # [Stopping pipelines][1].
780
+ #
781
+ #
782
+ #
783
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html#stop-pipeline
784
+ #
785
+ # @option params [required, String] :pipeline_name
786
+ # The name of the pipeline to stop.
787
+ #
788
+ # @return [Types::StopPipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
789
+ #
790
+ # * {Types::StopPipelineResponse#pipeline #pipeline} => Types::Pipeline
791
+ #
792
+ # @example Request syntax with placeholder values
793
+ #
794
+ # resp = client.stop_pipeline({
795
+ # pipeline_name: "PipelineName", # required
796
+ # })
797
+ #
798
+ # @example Response structure
799
+ #
800
+ # resp.pipeline.pipeline_name #=> String
801
+ # resp.pipeline.pipeline_arn #=> String
802
+ # resp.pipeline.min_units #=> Integer
803
+ # resp.pipeline.max_units #=> Integer
804
+ # resp.pipeline.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
805
+ # resp.pipeline.status_reason.description #=> String
806
+ # resp.pipeline.pipeline_configuration_body #=> String
807
+ # resp.pipeline.created_at #=> Time
808
+ # resp.pipeline.last_updated_at #=> Time
809
+ # resp.pipeline.ingest_endpoint_urls #=> Array
810
+ # resp.pipeline.ingest_endpoint_urls[0] #=> String
811
+ # resp.pipeline.log_publishing_options.is_logging_enabled #=> Boolean
812
+ # resp.pipeline.log_publishing_options.cloud_watch_log_destination.log_group #=> String
813
+ # resp.pipeline.vpc_endpoints #=> Array
814
+ # resp.pipeline.vpc_endpoints[0].vpc_endpoint_id #=> String
815
+ # resp.pipeline.vpc_endpoints[0].vpc_id #=> String
816
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids #=> Array
817
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids[0] #=> String
818
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids #=> Array
819
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids[0] #=> String
820
+ #
821
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/StopPipeline AWS API Documentation
822
+ #
823
+ # @overload stop_pipeline(params = {})
824
+ # @param [Hash] params ({})
825
+ def stop_pipeline(params = {}, options = {})
826
+ req = build_request(:stop_pipeline, params)
827
+ req.send_request(options)
828
+ end
829
+
830
+ # Tags an OpenSearch Ingestion pipeline. For more information, see
831
+ # [Tagging OpenSearch Ingestion pipelines][1].
832
+ #
833
+ #
834
+ #
835
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html
836
+ #
837
+ # @option params [required, String] :arn
838
+ # The Amazon Resource Name (ARN) of the pipeline to tag.
839
+ #
840
+ # @option params [required, Array<Types::Tag>] :tags
841
+ # The list of key-value tags to add to the pipeline.
842
+ #
843
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
844
+ #
845
+ # @example Request syntax with placeholder values
846
+ #
847
+ # resp = client.tag_resource({
848
+ # arn: "PipelineArn", # required
849
+ # tags: [ # required
850
+ # {
851
+ # key: "TagKey", # required
852
+ # value: "TagValue", # required
853
+ # },
854
+ # ],
855
+ # })
856
+ #
857
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/TagResource AWS API Documentation
858
+ #
859
+ # @overload tag_resource(params = {})
860
+ # @param [Hash] params ({})
861
+ def tag_resource(params = {}, options = {})
862
+ req = build_request(:tag_resource, params)
863
+ req.send_request(options)
864
+ end
865
+
866
+ # Removes one or more tags from an OpenSearch Ingestion pipeline. For
867
+ # more information, see [Tagging OpenSearch Ingestion pipelines][1].
868
+ #
869
+ #
870
+ #
871
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/tag-pipeline.html
872
+ #
873
+ # @option params [required, String] :arn
874
+ # The Amazon Resource Name (ARN) of the pipeline to remove tags from.
875
+ #
876
+ # @option params [required, Array<String>] :tag_keys
877
+ # The tag keys to remove.
878
+ #
879
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
880
+ #
881
+ # @example Request syntax with placeholder values
882
+ #
883
+ # resp = client.untag_resource({
884
+ # arn: "PipelineArn", # required
885
+ # tag_keys: ["String"], # required
886
+ # })
887
+ #
888
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/UntagResource AWS API Documentation
889
+ #
890
+ # @overload untag_resource(params = {})
891
+ # @param [Hash] params ({})
892
+ def untag_resource(params = {}, options = {})
893
+ req = build_request(:untag_resource, params)
894
+ req.send_request(options)
895
+ end
896
+
897
+ # Updates an OpenSearch Ingestion pipeline. For more information, see
898
+ # [Creating and managing OpenSearch Ingestion pipelines][1].
899
+ #
900
+ #
901
+ #
902
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html
903
+ #
904
+ # @option params [required, String] :pipeline_name
905
+ # The name of the pipeline to update.
906
+ #
907
+ # @option params [Integer] :min_units
908
+ # The minimum pipeline capacity, in Ingestion Compute Units (ICUs).
909
+ #
910
+ # @option params [Integer] :max_units
911
+ # The maximum pipeline capacity, in Ingestion Compute Units (ICUs)
912
+ #
913
+ # @option params [String] :pipeline_configuration_body
914
+ # The pipeline configuration in YAML format. The command accepts the
915
+ # pipeline configuration as a string or within a .yaml file. If you
916
+ # provide the configuration as a string, each new line must be escaped
917
+ # with `\n`.
918
+ #
919
+ # @option params [Types::LogPublishingOptions] :log_publishing_options
920
+ # Key-value pairs to configure log publishing.
921
+ #
922
+ # @return [Types::UpdatePipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
923
+ #
924
+ # * {Types::UpdatePipelineResponse#pipeline #pipeline} => Types::Pipeline
925
+ #
926
+ # @example Request syntax with placeholder values
927
+ #
928
+ # resp = client.update_pipeline({
929
+ # pipeline_name: "PipelineName", # required
930
+ # min_units: 1,
931
+ # max_units: 1,
932
+ # pipeline_configuration_body: "PipelineConfigurationBody",
933
+ # log_publishing_options: {
934
+ # is_logging_enabled: false,
935
+ # cloud_watch_log_destination: {
936
+ # log_group: "LogGroup", # required
937
+ # },
938
+ # },
939
+ # })
940
+ #
941
+ # @example Response structure
942
+ #
943
+ # resp.pipeline.pipeline_name #=> String
944
+ # resp.pipeline.pipeline_arn #=> String
945
+ # resp.pipeline.min_units #=> Integer
946
+ # resp.pipeline.max_units #=> Integer
947
+ # resp.pipeline.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "CREATE_FAILED", "UPDATE_FAILED", "STARTING", "START_FAILED", "STOPPING", "STOPPED"
948
+ # resp.pipeline.status_reason.description #=> String
949
+ # resp.pipeline.pipeline_configuration_body #=> String
950
+ # resp.pipeline.created_at #=> Time
951
+ # resp.pipeline.last_updated_at #=> Time
952
+ # resp.pipeline.ingest_endpoint_urls #=> Array
953
+ # resp.pipeline.ingest_endpoint_urls[0] #=> String
954
+ # resp.pipeline.log_publishing_options.is_logging_enabled #=> Boolean
955
+ # resp.pipeline.log_publishing_options.cloud_watch_log_destination.log_group #=> String
956
+ # resp.pipeline.vpc_endpoints #=> Array
957
+ # resp.pipeline.vpc_endpoints[0].vpc_endpoint_id #=> String
958
+ # resp.pipeline.vpc_endpoints[0].vpc_id #=> String
959
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids #=> Array
960
+ # resp.pipeline.vpc_endpoints[0].vpc_options.subnet_ids[0] #=> String
961
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids #=> Array
962
+ # resp.pipeline.vpc_endpoints[0].vpc_options.security_group_ids[0] #=> String
963
+ #
964
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/UpdatePipeline AWS API Documentation
965
+ #
966
+ # @overload update_pipeline(params = {})
967
+ # @param [Hash] params ({})
968
+ def update_pipeline(params = {}, options = {})
969
+ req = build_request(:update_pipeline, params)
970
+ req.send_request(options)
971
+ end
972
+
973
+ # Checks whether an OpenSearch Ingestion pipeline configuration is valid
974
+ # prior to creation. For more information, see [Creating and managing
975
+ # OpenSearch Ingestion pipelines][1].
976
+ #
977
+ #
978
+ #
979
+ # [1]: https://docs.aws.amazon.com/opensearch-service/latest/developerguide/manage-pipeline.html
980
+ #
981
+ # @option params [required, String] :pipeline_configuration_body
982
+ # The pipeline configuration in YAML format. The command accepts the
983
+ # pipeline configuration as a string or within a .yaml file. If you
984
+ # provide the configuration as a string, each new line must be escaped
985
+ # with `\n`.
986
+ #
987
+ # @return [Types::ValidatePipelineResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
988
+ #
989
+ # * {Types::ValidatePipelineResponse#is_valid #is_valid} => Boolean
990
+ # * {Types::ValidatePipelineResponse#errors #errors} => Array&lt;Types::ValidationMessage&gt;
991
+ #
992
+ # @example Request syntax with placeholder values
993
+ #
994
+ # resp = client.validate_pipeline({
995
+ # pipeline_configuration_body: "PipelineConfigurationBody", # required
996
+ # })
997
+ #
998
+ # @example Response structure
999
+ #
1000
+ # resp.is_valid #=> Boolean
1001
+ # resp.errors #=> Array
1002
+ # resp.errors[0].message #=> String
1003
+ #
1004
+ # @see http://docs.aws.amazon.com/goto/WebAPI/osis-2022-01-01/ValidatePipeline AWS API Documentation
1005
+ #
1006
+ # @overload validate_pipeline(params = {})
1007
+ # @param [Hash] params ({})
1008
+ def validate_pipeline(params = {}, options = {})
1009
+ req = build_request(:validate_pipeline, params)
1010
+ req.send_request(options)
1011
+ end
1012
+
1013
+ # @!endgroup
1014
+
1015
+ # @param params ({})
1016
+ # @api private
1017
+ def build_request(operation_name, params = {})
1018
+ handlers = @handlers.for(operation_name)
1019
+ context = Seahorse::Client::RequestContext.new(
1020
+ operation_name: operation_name,
1021
+ operation: config.api.operation(operation_name),
1022
+ client: self,
1023
+ params: params,
1024
+ config: config)
1025
+ context[:gem_name] = 'aws-sdk-osis'
1026
+ context[:gem_version] = '1.0.0'
1027
+ Seahorse::Client::Request.new(handlers, context)
1028
+ end
1029
+
1030
+ # @api private
1031
+ # @deprecated
1032
+ def waiter_names
1033
+ []
1034
+ end
1035
+
1036
+ class << self
1037
+
1038
+ # @api private
1039
+ attr_reader :identifier
1040
+
1041
+ # @api private
1042
+ def errors_module
1043
+ Errors
1044
+ end
1045
+
1046
+ end
1047
+ end
1048
+ end