aws-sdk-iotthingsgraph 1.3.0 → 1.8.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: 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