aws-sdk-sagemakerruntime 1.18.0 → 1.23.1

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: cdd78866b378ff87ac88b85ca0b05932f2e69a4e
4
- data.tar.gz: cbc26a182202bf07191c777c5150a7d5e36be268
2
+ SHA256:
3
+ metadata.gz: efb6d0b84f65889ce75ee13840ae83c8b28352e91ee46f550bdf3b3b14e4dfb0
4
+ data.tar.gz: 4bdea73c4814def06d0b658ced795a15bfb6891aee56101dcd20718db8dbb238
5
5
  SHA512:
6
- metadata.gz: 660411a31b3df17ae3e3f72cde28f309e5f88b3493a0ee093aa682725f0454283fc6525cc299419e3a0688024044e52c509acb0e3302c8b3c63333d77c2ede3d
7
- data.tar.gz: 8de9b7b3b171d1eae62b38c039dfa7e86a02ed7cffb29ee77f7158860531eb15909885600829c675837642d1a583cccd57670b6b538778151480f87fa0f8af98
6
+ metadata.gz: 9d09cbcae663faa8fdb12c664abc7024f3d73c009d9f65c1daa7ef0d5d553ddee319bf68060a63aabf4dab598194faf9c27aeaec32294df9c7a79a6629399af3
7
+ data.tar.gz: 24ecb4efb768ca06cc093aee6965399249d8288b3d28191889ac757084ed32132d45d2bdc4f3b728f326af2fa4b4e2d076f3bb35aaa24840e6f9aad68aa166a9
@@ -24,17 +24,20 @@ require_relative 'aws-sdk-sagemakerruntime/customizations'
24
24
  # methods each accept a hash of request parameters and return a response
25
25
  # structure.
26
26
  #
27
+ # sage_maker_runtime = Aws::SageMakerRuntime::Client.new
28
+ # resp = sage_maker_runtime.invoke_endpoint(params)
29
+ #
27
30
  # See {Client} for more information.
28
31
  #
29
32
  # # Errors
30
33
  #
31
- # Errors returned from Amazon SageMaker Runtime all
32
- # extend {Errors::ServiceError}.
34
+ # Errors returned from Amazon SageMaker Runtime are defined in the
35
+ # {Errors} module and all extend {Errors::ServiceError}.
33
36
  #
34
37
  # begin
35
38
  # # do stuff
36
39
  # rescue Aws::SageMakerRuntime::Errors::ServiceError
37
- # # rescues all service API errors
40
+ # # rescues all Amazon SageMaker Runtime API errors
38
41
  # end
39
42
  #
40
43
  # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-sagemakerruntime/customizations'
42
45
  # @service
43
46
  module Aws::SageMakerRuntime
44
47
 
45
- GEM_VERSION = '1.18.0'
48
+ GEM_VERSION = '1.23.1'
46
49
 
47
50
  end
@@ -24,12 +24,25 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
24
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
25
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
26
26
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
27
+ require 'aws-sdk-core/plugins/http_checksum.rb'
27
28
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
29
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
29
30
 
30
31
  Aws::Plugins::GlobalConfiguration.add_identifier(:sagemakerruntime)
31
32
 
32
33
  module Aws::SageMakerRuntime
34
+ # An API client for SageMakerRuntime. To construct a client, you need to configure a `:region` and `:credentials`.
35
+ #
36
+ # client = Aws::SageMakerRuntime::Client.new(
37
+ # region: region_name,
38
+ # credentials: credentials,
39
+ # # ...
40
+ # )
41
+ #
42
+ # For details on configuring region and credentials see
43
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
44
+ #
45
+ # See {#initialize} for a full list of supported configuration options.
33
46
  class Client < Seahorse::Client::Base
34
47
 
35
48
  include Aws::ClientStubs
@@ -57,6 +70,7 @@ module Aws::SageMakerRuntime
57
70
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
58
71
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
59
72
  add_plugin(Aws::Plugins::TransferEncoding)
73
+ add_plugin(Aws::Plugins::HttpChecksum)
60
74
  add_plugin(Aws::Plugins::SignatureV4)
61
75
  add_plugin(Aws::Plugins::Protocols::RestJson)
62
76
 
@@ -93,7 +107,7 @@ module Aws::SageMakerRuntime
93
107
  # @option options [required, String] :region
94
108
  # The AWS region to connect to. The configured `:region` is
95
109
  # used to determine the service `:endpoint`. When not passed,
96
- # a default `:region` is search for in the following locations:
110
+ # a default `:region` is searched for in the following locations:
97
111
  #
98
112
  # * `Aws.config[:region]`
99
113
  # * `ENV['AWS_REGION']`
@@ -108,6 +122,12 @@ module Aws::SageMakerRuntime
108
122
  # When set to `true`, a thread polling for endpoints will be running in
109
123
  # the background every 60 secs (default). Defaults to `false`.
110
124
  #
125
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
126
+ # Used only in `adaptive` retry mode. When true, the request will sleep
127
+ # until there is sufficent client side capacity to retry the request.
128
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
129
+ # not retry instead of sleeping.
130
+ #
111
131
  # @option options [Boolean] :client_side_monitoring (false)
112
132
  # When `true`, client-side metrics will be collected for all API requests from
113
133
  # this client.
@@ -132,6 +152,10 @@ module Aws::SageMakerRuntime
132
152
  # When `true`, an attempt is made to coerce request parameters into
133
153
  # the required types.
134
154
  #
155
+ # @option options [Boolean] :correct_clock_skew (true)
156
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
157
+ # a clock skew correction and retry requests with skewed client clocks.
158
+ #
135
159
  # @option options [Boolean] :disable_host_prefix_injection (false)
136
160
  # Set to true to disable SDK automatically adding host prefix
137
161
  # to default service endpoint when available.
@@ -139,7 +163,7 @@ module Aws::SageMakerRuntime
139
163
  # @option options [String] :endpoint
140
164
  # The client endpoint is normally constructed from the `:region`
141
165
  # option. You should only configure an `:endpoint` when connecting
142
- # to test endpoints. This should be avalid HTTP(S) URI.
166
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
143
167
  #
144
168
  # @option options [Integer] :endpoint_cache_max_entries (1000)
145
169
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +178,7 @@ module Aws::SageMakerRuntime
154
178
  # requests fetching endpoints information. Defaults to 60 sec.
155
179
  #
156
180
  # @option options [Boolean] :endpoint_discovery (false)
157
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
181
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
158
182
  #
159
183
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
160
184
  # The log formatter.
@@ -166,15 +190,29 @@ module Aws::SageMakerRuntime
166
190
  # The Logger instance to send log messages to. If this option
167
191
  # is not set, logging will be disabled.
168
192
  #
193
+ # @option options [Integer] :max_attempts (3)
194
+ # An integer representing the maximum number attempts that will be made for
195
+ # a single request, including the initial attempt. For example,
196
+ # setting this value to 5 will result in a request being retried up to
197
+ # 4 times. Used in `standard` and `adaptive` retry modes.
198
+ #
169
199
  # @option options [String] :profile ("default")
170
200
  # Used when loading credentials from the shared credentials file
171
201
  # at HOME/.aws/credentials. When not specified, 'default' is used.
172
202
  #
203
+ # @option options [Proc] :retry_backoff
204
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
205
+ # This option is only used in the `legacy` retry mode.
206
+ #
173
207
  # @option options [Float] :retry_base_delay (0.3)
174
- # The base delay in seconds used by the default backoff function.
208
+ # The base delay in seconds used by the default backoff function. This option
209
+ # is only used in the `legacy` retry mode.
175
210
  #
176
211
  # @option options [Symbol] :retry_jitter (:none)
177
- # A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
212
+ # A delay randomiser function used by the default backoff function.
213
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
214
+ # otherwise a Proc that takes and returns a number. This option is only used
215
+ # in the `legacy` retry mode.
178
216
  #
179
217
  # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
180
218
  #
@@ -182,11 +220,30 @@ module Aws::SageMakerRuntime
182
220
  # The maximum number of times to retry failed requests. Only
183
221
  # ~ 500 level server errors and certain ~ 400 level client errors
184
222
  # are retried. Generally, these are throttling errors, data
185
- # checksum errors, networking errors, timeout errors and auth
186
- # errors from expired credentials.
223
+ # checksum errors, networking errors, timeout errors, auth errors,
224
+ # endpoint discovery, and errors from expired credentials.
225
+ # This option is only used in the `legacy` retry mode.
187
226
  #
188
227
  # @option options [Integer] :retry_max_delay (0)
189
- # The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
228
+ # The maximum number of seconds to delay between retries (0 for no limit)
229
+ # used by the default backoff function. This option is only used in the
230
+ # `legacy` retry mode.
231
+ #
232
+ # @option options [String] :retry_mode ("legacy")
233
+ # Specifies which retry algorithm to use. Values are:
234
+ #
235
+ # * `legacy` - The pre-existing retry behavior. This is default value if
236
+ # no retry mode is provided.
237
+ #
238
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
239
+ # This includes support for retry quotas, which limit the number of
240
+ # unsuccessful retries a client can make.
241
+ #
242
+ # * `adaptive` - An experimental retry mode that includes all the
243
+ # functionality of `standard` mode along with automatic client side
244
+ # throttling. This is a provisional mode that may change behavior
245
+ # in the future.
246
+ #
190
247
  #
191
248
  # @option options [String] :secret_access_key
192
249
  #
@@ -209,16 +266,15 @@ module Aws::SageMakerRuntime
209
266
  # requests through. Formatted like 'http://proxy.com:123'.
210
267
  #
211
268
  # @option options [Float] :http_open_timeout (15) The number of
212
- # seconds to wait when opening a HTTP session before rasing a
269
+ # seconds to wait when opening a HTTP session before raising a
213
270
  # `Timeout::Error`.
214
271
  #
215
272
  # @option options [Integer] :http_read_timeout (60) The default
216
273
  # number of seconds to wait for response data. This value can
217
- # safely be set
218
- # per-request on the session yeidled by {#session_for}.
274
+ # safely be set per-request on the session.
219
275
  #
220
276
  # @option options [Float] :http_idle_timeout (5) The number of
221
- # seconds a connection is allowed to sit idble before it is
277
+ # seconds a connection is allowed to sit idle before it is
222
278
  # considered stale. Stale connections are closed and removed
223
279
  # from the pool before making a request.
224
280
  #
@@ -227,7 +283,7 @@ module Aws::SageMakerRuntime
227
283
  # request body. This option has no effect unless the request has
228
284
  # "Expect" header set to "100-continue". Defaults to `nil` which
229
285
  # disables this behaviour. This value can safely be set per
230
- # request on the session yeidled by {#session_for}.
286
+ # request on the session.
231
287
  #
232
288
  # @option options [Boolean] :http_wire_trace (false) When `true`,
233
289
  # HTTP debug output will be sent to the `:logger`.
@@ -301,7 +357,7 @@ module Aws::SageMakerRuntime
301
357
  # the model.
302
358
  #
303
359
  # For information about the format of the request body, see [Common Data
304
- # FormatsInference][1].
360
+ # Formats-Inference][1].
305
361
  #
306
362
  #
307
363
  #
@@ -330,8 +386,14 @@ module Aws::SageMakerRuntime
330
386
  # [1]: https://tools.ietf.org/html/rfc7230#section-3.2.6
331
387
  #
332
388
  # @option params [String] :target_model
333
- # Specifies the model to be requested for an inference when invoking a
334
- # multi-model endpoint.
389
+ # The model to request for inference when invoking a multi-model
390
+ # endpoint.
391
+ #
392
+ # @option params [String] :target_variant
393
+ # Specify the production variant to send the inference request to when
394
+ # invoking an endpoint that is running two or more variants. Note that
395
+ # this parameter overrides the default behavior for the endpoint, which
396
+ # is to distribute the invocation traffic based on the variant weights.
335
397
  #
336
398
  # @return [Types::InvokeEndpointOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
337
399
  #
@@ -349,6 +411,7 @@ module Aws::SageMakerRuntime
349
411
  # accept: "Header",
350
412
  # custom_attributes: "CustomAttributesHeader",
351
413
  # target_model: "TargetModelHeader",
414
+ # target_variant: "TargetVariantHeader",
352
415
  # })
353
416
  #
354
417
  # @example Response structure
@@ -380,7 +443,7 @@ module Aws::SageMakerRuntime
380
443
  params: params,
381
444
  config: config)
382
445
  context[:gem_name] = 'aws-sdk-sagemakerruntime'
383
- context[:gem_version] = '1.18.0'
446
+ context[:gem_version] = '1.23.1'
384
447
  Seahorse::Client::Request.new(handlers, context)
385
448
  end
386
449
 
@@ -24,6 +24,7 @@ module Aws::SageMakerRuntime
24
24
  ServiceUnavailable = Shapes::StructureShape.new(name: 'ServiceUnavailable')
25
25
  StatusCode = Shapes::IntegerShape.new(name: 'StatusCode')
26
26
  TargetModelHeader = Shapes::StringShape.new(name: 'TargetModelHeader')
27
+ TargetVariantHeader = Shapes::StringShape.new(name: 'TargetVariantHeader')
27
28
  ValidationError = Shapes::StructureShape.new(name: 'ValidationError')
28
29
 
29
30
  InternalFailure.add_member(:message, Shapes::ShapeRef.new(shape: Message, location_name: "Message"))
@@ -35,6 +36,7 @@ module Aws::SageMakerRuntime
35
36
  InvokeEndpointInput.add_member(:accept, Shapes::ShapeRef.new(shape: Header, location: "header", location_name: "Accept"))
36
37
  InvokeEndpointInput.add_member(:custom_attributes, Shapes::ShapeRef.new(shape: CustomAttributesHeader, location: "header", location_name: "X-Amzn-SageMaker-Custom-Attributes"))
37
38
  InvokeEndpointInput.add_member(:target_model, Shapes::ShapeRef.new(shape: TargetModelHeader, location: "header", location_name: "X-Amzn-SageMaker-Target-Model"))
39
+ InvokeEndpointInput.add_member(:target_variant, Shapes::ShapeRef.new(shape: TargetVariantHeader, location: "header", location_name: "X-Amzn-SageMaker-Target-Variant"))
38
40
  InvokeEndpointInput.struct_class = Types::InvokeEndpointInput
39
41
  InvokeEndpointInput[:payload] = :body
40
42
  InvokeEndpointInput[:payload_member] = InvokeEndpointInput.member(:body)
@@ -6,6 +6,32 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::SageMakerRuntime
9
+
10
+ # When SageMakerRuntime returns an error response, the Ruby SDK constructs and raises an error.
11
+ # These errors all extend Aws::SageMakerRuntime::Errors::ServiceError < {Aws::Errors::ServiceError}
12
+ #
13
+ # You can rescue all SageMakerRuntime errors using ServiceError:
14
+ #
15
+ # begin
16
+ # # do stuff
17
+ # rescue Aws::SageMakerRuntime::Errors::ServiceError
18
+ # # rescues all SageMakerRuntime API errors
19
+ # end
20
+ #
21
+ #
22
+ # ## Request Context
23
+ # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
24
+ # information about the request that generated the error.
25
+ # See {Seahorse::Client::RequestContext} for more information.
26
+ #
27
+ # ## Error Classes
28
+ # * {InternalFailure}
29
+ # * {ModelError}
30
+ # * {ServiceUnavailable}
31
+ # * {ValidationError}
32
+ #
33
+ # Additionally, error classes are dynamically generated for service errors based on the error code
34
+ # if they are not defined above.
9
35
  module Errors
10
36
 
11
37
  extend Aws::Errors::DynamicErrors
@@ -23,7 +49,6 @@ module Aws::SageMakerRuntime
23
49
  def message
24
50
  @message || @data[:message]
25
51
  end
26
-
27
52
  end
28
53
 
29
54
  class ModelError < ServiceError
@@ -54,7 +79,6 @@ module Aws::SageMakerRuntime
54
79
  def log_stream_arn
55
80
  @data[:log_stream_arn]
56
81
  end
57
-
58
82
  end
59
83
 
60
84
  class ServiceUnavailable < ServiceError
@@ -70,7 +94,6 @@ module Aws::SageMakerRuntime
70
94
  def message
71
95
  @message || @data[:message]
72
96
  end
73
-
74
97
  end
75
98
 
76
99
  class ValidationError < ServiceError
@@ -86,7 +109,6 @@ module Aws::SageMakerRuntime
86
109
  def message
87
110
  @message || @data[:message]
88
111
  end
89
-
90
112
  end
91
113
 
92
114
  end
@@ -6,6 +6,7 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::SageMakerRuntime
9
+
9
10
  class Resource
10
11
 
11
12
  # @param options ({})
@@ -30,6 +30,7 @@ module Aws::SageMakerRuntime
30
30
  # accept: "Header",
31
31
  # custom_attributes: "CustomAttributesHeader",
32
32
  # target_model: "TargetModelHeader",
33
+ # target_variant: "TargetVariantHeader",
33
34
  # }
34
35
  #
35
36
  # @!attribute [rw] endpoint_name
@@ -47,7 +48,7 @@ module Aws::SageMakerRuntime
47
48
  # to the model.
48
49
  #
49
50
  # For information about the format of the request body, see [Common
50
- # Data FormatsInference][1].
51
+ # Data Formats-Inference][1].
51
52
  #
52
53
  #
53
54
  #
@@ -80,8 +81,16 @@ module Aws::SageMakerRuntime
80
81
  # @return [String]
81
82
  #
82
83
  # @!attribute [rw] target_model
83
- # Specifies the model to be requested for an inference when invoking a
84
- # multi-model endpoint.
84
+ # The model to request for inference when invoking a multi-model
85
+ # endpoint.
86
+ # @return [String]
87
+ #
88
+ # @!attribute [rw] target_variant
89
+ # Specify the production variant to send the inference request to when
90
+ # invoking an endpoint that is running two or more variants. Note that
91
+ # this parameter overrides the default behavior for the endpoint,
92
+ # which is to distribute the invocation traffic based on the variant
93
+ # weights.
85
94
  # @return [String]
86
95
  #
87
96
  # @see http://docs.aws.amazon.com/goto/WebAPI/runtime.sagemaker-2017-05-13/InvokeEndpointInput AWS API Documentation
@@ -92,7 +101,8 @@ module Aws::SageMakerRuntime
92
101
  :content_type,
93
102
  :accept,
94
103
  :custom_attributes,
95
- :target_model)
104
+ :target_model,
105
+ :target_variant)
96
106
  include Aws::Structure
97
107
  end
98
108
 
@@ -100,7 +110,7 @@ module Aws::SageMakerRuntime
100
110
  # Includes the inference provided by the model.
101
111
  #
102
112
  # For information about the format of the response body, see [Common
103
- # Data FormatsInference][1].
113
+ # Data Formats-Inference][1].
104
114
  #
105
115
  #
106
116
  #
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-sagemakerruntime
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.18.0
4
+ version: 1.23.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-11-18 00:00:00.000000000 Z
11
+ date: 2020-06-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.71.0
22
+ version: 3.99.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.71.0
32
+ version: 3.99.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement
@@ -81,7 +81,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
81
81
  version: '0'
82
82
  requirements: []
83
83
  rubyforge_project:
84
- rubygems_version: 2.5.2.3
84
+ rubygems_version: 2.7.6.2
85
85
  signing_key:
86
86
  specification_version: 4
87
87
  summary: AWS SDK for Ruby - Amazon SageMaker Runtime