aws-sdk-osis 1.0.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.
@@ -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