aws-sdk-iotthingsgraph 1.3.0 → 1.8.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: 2be9d0056ace6704b60e83a90af5a3de49eb68a5
4
- data.tar.gz: 03e29e57129c1d91eeab01ffcd79eb5d2a214c51
2
+ SHA256:
3
+ metadata.gz: bde5f12ac605c51746b4ba388773ebd3daf62bdad9814905855cecd039442b3d
4
+ data.tar.gz: c97a34aaa037cfcd5dc2ba8c754068bde453c3168c7c9f550c51098cc36e7aaf
5
5
  SHA512:
6
- metadata.gz: a47a82a4eeb470385d34c4a7a043ef3a7884c1c2741bf802c1fea6d2b3e5ccbb4135f8c31d43f4106fa40111de4cf4dc424e73af3900f354161bca6984233094
7
- data.tar.gz: f17c2fce00c40dcb8a33a1c0c1470ae560e0f341dec3efd58a33699e0dd4b131dc5bee06147708404e5a4d7958e2d35e3b92b48c93b5824ab75d3e13dfb96686
6
+ metadata.gz: 7d5714b02b4d2d3d3236c273f41d189ed1258faa8c117a2e35ebebff3f43d2d61e8620685e155ae67472926f6af5157adb430cc2aafed9c99040d8b7b33aaa51
7
+ data.tar.gz: 1df61e7ee009994c17ecd4372c6ec5d82f90f74726ed862cacb41ed54e54f135c4621081c778ac785ef499a92ac956f3bda5b4e882a4f3ee5a3efcea89e06eee
@@ -24,17 +24,20 @@ require_relative 'aws-sdk-iotthingsgraph/customizations'
24
24
  # methods each accept a hash of request parameters and return a response
25
25
  # structure.
26
26
  #
27
+ # io_t_things_graph = Aws::IoTThingsGraph::Client.new
28
+ # resp = io_t_things_graph.associate_entity_to_thing(params)
29
+ #
27
30
  # See {Client} for more information.
28
31
  #
29
32
  # # Errors
30
33
  #
31
- # Errors returned from AWS IoT Things Graph all
32
- # extend {Errors::ServiceError}.
34
+ # Errors returned from AWS IoT Things Graph 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::IoTThingsGraph::Errors::ServiceError
37
- # # rescues all service API errors
40
+ # # rescues all AWS IoT Things Graph API errors
38
41
  # end
39
42
  #
40
43
  # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-iotthingsgraph/customizations'
42
45
  # @service
43
46
  module Aws::IoTThingsGraph
44
47
 
45
- GEM_VERSION = '1.3.0'
48
+ GEM_VERSION = '1.8.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/json_rpc.rb'
29
30
 
30
31
  Aws::Plugins::GlobalConfiguration.add_identifier(:iotthingsgraph)
31
32
 
32
33
  module Aws::IoTThingsGraph
34
+ # An API client for IoTThingsGraph. To construct a client, you need to configure a `:region` and `:credentials`.
35
+ #
36
+ # client = Aws::IoTThingsGraph::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::IoTThingsGraph
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::JsonRpc)
62
76
 
@@ -93,7 +107,7 @@ module Aws::IoTThingsGraph
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::IoTThingsGraph
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::IoTThingsGraph
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::IoTThingsGraph
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::IoTThingsGraph
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::IoTThingsGraph
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::IoTThingsGraph
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
  #
@@ -219,16 +276,15 @@ module Aws::IoTThingsGraph
219
276
  # requests through. Formatted like 'http://proxy.com:123'.
220
277
  #
221
278
  # @option options [Float] :http_open_timeout (15) The number of
222
- # seconds to wait when opening a HTTP session before rasing a
279
+ # seconds to wait when opening a HTTP session before raising a
223
280
  # `Timeout::Error`.
224
281
  #
225
282
  # @option options [Integer] :http_read_timeout (60) The default
226
283
  # number of seconds to wait for response data. This value can
227
- # safely be set
228
- # per-request on the session yeidled by {#session_for}.
284
+ # safely be set per-request on the session.
229
285
  #
230
286
  # @option options [Float] :http_idle_timeout (5) The number of
231
- # seconds a connection is allowed to sit idble before it is
287
+ # seconds a connection is allowed to sit idle before it is
232
288
  # considered stale. Stale connections are closed and removed
233
289
  # from the pool before making a request.
234
290
  #
@@ -237,7 +293,7 @@ module Aws::IoTThingsGraph
237
293
  # request body. This option has no effect unless the request has
238
294
  # "Expect" header set to "100-continue". Defaults to `nil` which
239
295
  # disables this behaviour. This value can safely be set per
240
- # request on the session yeidled by {#session_for}.
296
+ # request on the session.
241
297
  #
242
298
  # @option options [Boolean] :http_wire_trace (false) When `true`,
243
299
  # HTTP debug output will be sent to the `:logger`.
@@ -889,6 +945,8 @@ module Aws::IoTThingsGraph
889
945
  # * {Types::GetFlowTemplateRevisionsResponse#summaries #summaries} => Array&lt;Types::FlowTemplateSummary&gt;
890
946
  # * {Types::GetFlowTemplateRevisionsResponse#next_token #next_token} => String
891
947
  #
948
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
949
+ #
892
950
  # @example Request syntax with placeholder values
893
951
  #
894
952
  # resp = client.get_flow_template_revisions({
@@ -1052,6 +1110,8 @@ module Aws::IoTThingsGraph
1052
1110
  # * {Types::GetSystemTemplateRevisionsResponse#summaries #summaries} => Array&lt;Types::SystemTemplateSummary&gt;
1053
1111
  # * {Types::GetSystemTemplateRevisionsResponse#next_token #next_token} => String
1054
1112
  #
1113
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1114
+ #
1055
1115
  # @example Request syntax with placeholder values
1056
1116
  #
1057
1117
  # resp = client.get_system_template_revisions({
@@ -1134,6 +1194,8 @@ module Aws::IoTThingsGraph
1134
1194
  # * {Types::ListFlowExecutionMessagesResponse#messages #messages} => Array&lt;Types::FlowExecutionMessage&gt;
1135
1195
  # * {Types::ListFlowExecutionMessagesResponse#next_token #next_token} => String
1136
1196
  #
1197
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1198
+ #
1137
1199
  # @example Request syntax with placeholder values
1138
1200
  #
1139
1201
  # resp = client.list_flow_execution_messages({
@@ -1175,6 +1237,8 @@ module Aws::IoTThingsGraph
1175
1237
  # * {Types::ListTagsForResourceResponse#tags #tags} => Array&lt;Types::Tag&gt;
1176
1238
  # * {Types::ListTagsForResourceResponse#next_token #next_token} => String
1177
1239
  #
1240
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1241
+ #
1178
1242
  # @example Request syntax with placeholder values
1179
1243
  #
1180
1244
  # resp = client.list_tags_for_resource({
@@ -1230,6 +1294,8 @@ module Aws::IoTThingsGraph
1230
1294
  # * {Types::SearchEntitiesResponse#descriptions #descriptions} => Array&lt;Types::EntityDescription&gt;
1231
1295
  # * {Types::SearchEntitiesResponse#next_token #next_token} => String
1232
1296
  #
1297
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1298
+ #
1233
1299
  # @example Request syntax with placeholder values
1234
1300
  #
1235
1301
  # resp = client.search_entities({
@@ -1289,6 +1355,8 @@ module Aws::IoTThingsGraph
1289
1355
  # * {Types::SearchFlowExecutionsResponse#summaries #summaries} => Array&lt;Types::FlowExecutionSummary&gt;
1290
1356
  # * {Types::SearchFlowExecutionsResponse#next_token #next_token} => String
1291
1357
  #
1358
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1359
+ #
1292
1360
  # @example Request syntax with placeholder values
1293
1361
  #
1294
1362
  # resp = client.search_flow_executions({
@@ -1336,6 +1404,8 @@ module Aws::IoTThingsGraph
1336
1404
  # * {Types::SearchFlowTemplatesResponse#summaries #summaries} => Array&lt;Types::FlowTemplateSummary&gt;
1337
1405
  # * {Types::SearchFlowTemplatesResponse#next_token #next_token} => String
1338
1406
  #
1407
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1408
+ #
1339
1409
  # @example Request syntax with placeholder values
1340
1410
  #
1341
1411
  # resp = client.search_flow_templates({
@@ -1386,6 +1456,8 @@ module Aws::IoTThingsGraph
1386
1456
  # * {Types::SearchSystemInstancesResponse#summaries #summaries} => Array&lt;Types::SystemInstanceSummary&gt;
1387
1457
  # * {Types::SearchSystemInstancesResponse#next_token #next_token} => String
1388
1458
  #
1459
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1460
+ #
1389
1461
  # @example Request syntax with placeholder values
1390
1462
  #
1391
1463
  # resp = client.search_system_instances({
@@ -1440,6 +1512,8 @@ module Aws::IoTThingsGraph
1440
1512
  # * {Types::SearchSystemTemplatesResponse#summaries #summaries} => Array&lt;Types::SystemTemplateSummary&gt;
1441
1513
  # * {Types::SearchSystemTemplatesResponse#next_token #next_token} => String
1442
1514
  #
1515
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1516
+ #
1443
1517
  # @example Request syntax with placeholder values
1444
1518
  #
1445
1519
  # resp = client.search_system_templates({
@@ -1503,6 +1577,8 @@ module Aws::IoTThingsGraph
1503
1577
  # * {Types::SearchThingsResponse#things #things} => Array&lt;Types::Thing&gt;
1504
1578
  # * {Types::SearchThingsResponse#next_token #next_token} => String
1505
1579
  #
1580
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1581
+ #
1506
1582
  # @example Request syntax with placeholder values
1507
1583
  #
1508
1584
  # resp = client.search_things({
@@ -1804,7 +1880,7 @@ module Aws::IoTThingsGraph
1804
1880
  params: params,
1805
1881
  config: config)
1806
1882
  context[:gem_name] = 'aws-sdk-iotthingsgraph'
1807
- context[:gem_version] = '1.3.0'
1883
+ context[:gem_version] = '1.8.1'
1808
1884
  Seahorse::Client::Request.new(handlers, context)
1809
1885
  end
1810
1886
 
@@ -6,6 +6,35 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::IoTThingsGraph
9
+
10
+ # When IoTThingsGraph returns an error response, the Ruby SDK constructs and raises an error.
11
+ # These errors all extend Aws::IoTThingsGraph::Errors::ServiceError < {Aws::Errors::ServiceError}
12
+ #
13
+ # You can rescue all IoTThingsGraph errors using ServiceError:
14
+ #
15
+ # begin
16
+ # # do stuff
17
+ # rescue Aws::IoTThingsGraph::Errors::ServiceError
18
+ # # rescues all IoTThingsGraph 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
+ # * {InternalFailureException}
29
+ # * {InvalidRequestException}
30
+ # * {LimitExceededException}
31
+ # * {ResourceAlreadyExistsException}
32
+ # * {ResourceInUseException}
33
+ # * {ResourceNotFoundException}
34
+ # * {ThrottlingException}
35
+ #
36
+ # Additionally, error classes are dynamically generated for service errors based on the error code
37
+ # if they are not defined above.
9
38
  module Errors
10
39
 
11
40
  extend Aws::Errors::DynamicErrors
@@ -23,7 +52,6 @@ module Aws::IoTThingsGraph
23
52
  def message
24
53
  @message || @data[:message]
25
54
  end
26
-
27
55
  end
28
56
 
29
57
  class InvalidRequestException < ServiceError
@@ -39,7 +67,6 @@ module Aws::IoTThingsGraph
39
67
  def message
40
68
  @message || @data[:message]
41
69
  end
42
-
43
70
  end
44
71
 
45
72
  class LimitExceededException < ServiceError
@@ -55,7 +82,6 @@ module Aws::IoTThingsGraph
55
82
  def message
56
83
  @message || @data[:message]
57
84
  end
58
-
59
85
  end
60
86
 
61
87
  class ResourceAlreadyExistsException < ServiceError
@@ -71,7 +97,6 @@ module Aws::IoTThingsGraph
71
97
  def message
72
98
  @message || @data[:message]
73
99
  end
74
-
75
100
  end
76
101
 
77
102
  class ResourceInUseException < ServiceError
@@ -87,7 +112,6 @@ module Aws::IoTThingsGraph
87
112
  def message
88
113
  @message || @data[:message]
89
114
  end
90
-
91
115
  end
92
116
 
93
117
  class ResourceNotFoundException < ServiceError
@@ -103,7 +127,6 @@ module Aws::IoTThingsGraph
103
127
  def message
104
128
  @message || @data[:message]
105
129
  end
106
-
107
130
  end
108
131
 
109
132
  class ThrottlingException < ServiceError
@@ -119,7 +142,6 @@ module Aws::IoTThingsGraph
119
142
  def message
120
143
  @message || @data[:message]
121
144
  end
122
-
123
145
  end
124
146
 
125
147
  end
@@ -6,6 +6,7 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::IoTThingsGraph
9
+
9
10
  class Resource
10
11
 
11
12
  # @param options ({})
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-iotthingsgraph
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.3.0
4
+ version: 1.8.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-07-25 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.61.1
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.61.1
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 - AWS IoT Things Graph