aws-sdk-sagemakerruntime 1.18.0 → 1.23.1

Sign up to get free protection for your applications and to get access to all the features.
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