aws-sdk-iot 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: efdd153930e54bae43e1eeaa0d90cc519bbeb765
-  data.tar.gz: 4db4e822cd8f6ad6df18405abd7b641d4197d7dc
+  metadata.gz: 073b8d33a7af1864dc147256d09aacd565d0cc54
+  data.tar.gz: e65dffb408fd522f5edadbf9f557275811b3a665
 SHA512:
-  metadata.gz: af8df7b0eee14ac837ae1e8a4fc80ac3948cda8a9a2d7fbf017aff1758024ab5f19fdae3fb884051f05bf6f30a3d75451a0cf033d2a51065727fb926c8ca08ee
-  data.tar.gz: 720f953d9ee44b17487c63aab96f5dff4c17e43f2d78758731907deccf0020250856503a7c3220d14cfacc3d9d6e78cd29a93af96d1c49a9eb716898b1376b50
+  metadata.gz: 7c6ea0273873890a70eb87f5bd3d2b48ec4fec650ed27cd99d97857aa135cab40eda18b442df6e9a897aa74a2251d28f675f5175e9d772d37c0f274219ecaa42
+  data.tar.gz: 5c9af5e3b0b7b491055e920ebeb83ddf0ff8c6d4cef6a3f241632e3b86c89ca061b85ff2d9c17efbcf7bc90da1f7625ae0473c12176804ed41654f7c5c472b79

data/lib/aws-sdk-iot.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-iot/customizations'
 # @service
 module Aws::IoT
 
-  GEM_VERSION = '1.27.0'
+  GEM_VERSION = '1.28.0'
 
 end

data/lib/aws-sdk-iot/client.rb

@@ -1523,7 +1523,10 @@ module Aws::IoT
       req.send_request(options)
     end
 
-    # Creates a thing record in the registry.
+    # Creates a thing record in the registry. If this call is made multiple
+    # times using the same thing name and configuration, the call will
+    # succeed. If this call is made with the same thing name but different
+    # configuration a `ResourceAlreadyExistsException` is thrown.
     #
     # <note markdown="1"> This is a control plane operation. See [Authorization][1] for
     # information about authorizing control plane actions.
@@ -3729,6 +3732,45 @@ module Aws::IoT
       req.send_request(options)
     end
 
+    # Gets statistics about things that match the specified query.
+    #
+    # @option params [String] :index_name
+    #   The name of the index to search. The default value is `AWS_Things`.
+    #
+    # @option params [required, String] :query_string
+    #   The query used to search. You can specify "*" for the query string
+    #   to get the count of all indexed things in your AWS account.
+    #
+    # @option params [String] :aggregation_field
+    #   The aggregation field name. Currently not supported.
+    #
+    # @option params [String] :query_version
+    #   The version of the query used to search.
+    #
+    # @return [Types::GetStatisticsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetStatisticsResponse#statistics #statistics} => Types::Statistics
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_statistics({
+    #     index_name: "IndexName",
+    #     query_string: "QueryString", # required
+    #     aggregation_field: "AggregationField",
+    #     query_version: "QueryVersion",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.statistics.count #=> Integer
+    #
+    # @overload get_statistics(params = {})
+    # @param [Hash] params ({})
+    def get_statistics(params = {}, options = {})
+      req = build_request(:get_statistics, params)
+      req.send_request(options)
+    end
+
     # Gets information about the rule.
     #
     # @option params [required, String] :rule_name
@@ -4377,8 +4419,8 @@ module Aws::IoT
     # Lists the search indices.
     #
     # @option params [String] :next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are no
+    #   additional results.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return at one time.
@@ -5758,7 +5800,7 @@ module Aws::IoT
     #   registered.
     #
     # @option params [Boolean] :set_as_active
-    #   A boolean value that specifies if the CA certificate is set to active.
+    #   A boolean value that specifies if the certificate is set to active.
     #
     # @option params [String] :status
     #   The status of the register certificate request.
@@ -6161,8 +6203,8 @@ module Aws::IoT
     #   The search query string.
     #
     # @option params [String] :next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are no
+    #   additional results.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to return at one time.
@@ -7529,7 +7571,7 @@ module Aws::IoT
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iot'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-iot/client_api.rb

@@ -28,6 +28,7 @@ module Aws::IoT
     AddThingToThingGroupResponse = Shapes::StructureShape.new(name: 'AddThingToThingGroupResponse')
     AdditionalMetricsToRetainList = Shapes::ListShape.new(name: 'AdditionalMetricsToRetainList')
     AdditionalParameterMap = Shapes::MapShape.new(name: 'AdditionalParameterMap')
+    AggregationField = Shapes::StringShape.new(name: 'AggregationField')
     AlarmName = Shapes::StringShape.new(name: 'AlarmName')
     AlertTarget = Shapes::StructureShape.new(name: 'AlertTarget')
     AlertTargetArn = Shapes::StringShape.new(name: 'AlertTargetArn')
@@ -352,6 +353,8 @@ module Aws::IoT
     GetPolicyVersionResponse = Shapes::StructureShape.new(name: 'GetPolicyVersionResponse')
     GetRegistrationCodeRequest = Shapes::StructureShape.new(name: 'GetRegistrationCodeRequest')
     GetRegistrationCodeResponse = Shapes::StructureShape.new(name: 'GetRegistrationCodeResponse')
+    GetStatisticsRequest = Shapes::StructureShape.new(name: 'GetStatisticsRequest')
+    GetStatisticsResponse = Shapes::StructureShape.new(name: 'GetStatisticsResponse')
     GetTopicRuleRequest = Shapes::StructureShape.new(name: 'GetTopicRuleRequest')
     GetTopicRuleResponse = Shapes::StructureShape.new(name: 'GetTopicRuleResponse')
     GetV2LoggingOptionsRequest = Shapes::StructureShape.new(name: 'GetV2LoggingOptionsRequest')
@@ -374,6 +377,7 @@ module Aws::IoT
     InputName = Shapes::StringShape.new(name: 'InputName')
     InternalException = Shapes::StructureShape.new(name: 'InternalException')
     InternalFailureException = Shapes::StructureShape.new(name: 'InternalFailureException')
+    InvalidAggregationException = Shapes::StructureShape.new(name: 'InvalidAggregationException')
     InvalidQueryException = Shapes::StructureShape.new(name: 'InvalidQueryException')
     InvalidRequestException = Shapes::StructureShape.new(name: 'InvalidRequestException')
     InvalidResponseException = Shapes::StructureShape.new(name: 'InvalidResponseException')
@@ -683,6 +687,7 @@ module Aws::IoT
     StateReason = Shapes::StringShape.new(name: 'StateReason')
     StateValue = Shapes::StringShape.new(name: 'StateValue')
     StatisticalThreshold = Shapes::StructureShape.new(name: 'StatisticalThreshold')
+    Statistics = Shapes::StructureShape.new(name: 'Statistics')
     Status = Shapes::StringShape.new(name: 'Status')
     StepFunctionsAction = Shapes::StructureShape.new(name: 'StepFunctionsAction')
     StopThingRegistrationTaskRequest = Shapes::StructureShape.new(name: 'StopThingRegistrationTaskRequest')
@@ -1804,6 +1809,15 @@ module Aws::IoT
     GetRegistrationCodeResponse.add_member(:registration_code, Shapes::ShapeRef.new(shape: RegistrationCode, location_name: "registrationCode"))
     GetRegistrationCodeResponse.struct_class = Types::GetRegistrationCodeResponse
 
+    GetStatisticsRequest.add_member(:index_name, Shapes::ShapeRef.new(shape: IndexName, location_name: "indexName"))
+    GetStatisticsRequest.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "queryString"))
+    GetStatisticsRequest.add_member(:aggregation_field, Shapes::ShapeRef.new(shape: AggregationField, location_name: "aggregationField"))
+    GetStatisticsRequest.add_member(:query_version, Shapes::ShapeRef.new(shape: QueryVersion, location_name: "queryVersion"))
+    GetStatisticsRequest.struct_class = Types::GetStatisticsRequest
+
+    GetStatisticsResponse.add_member(:statistics, Shapes::ShapeRef.new(shape: Statistics, location_name: "statistics"))
+    GetStatisticsResponse.struct_class = Types::GetStatisticsResponse
+
     GetTopicRuleRequest.add_member(:rule_name, Shapes::ShapeRef.new(shape: RuleName, required: true, location: "uri", location_name: "ruleName"))
     GetTopicRuleRequest.struct_class = Types::GetTopicRuleRequest
 
@@ -2644,6 +2658,9 @@ module Aws::IoT
     StatisticalThreshold.add_member(:statistic, Shapes::ShapeRef.new(shape: EvaluationStatistic, location_name: "statistic"))
     StatisticalThreshold.struct_class = Types::StatisticalThreshold
 
+    Statistics.add_member(:count, Shapes::ShapeRef.new(shape: Count, location_name: "count"))
+    Statistics.struct_class = Types::Statistics
+
     StepFunctionsAction.add_member(:execution_name_prefix, Shapes::ShapeRef.new(shape: ExecutionNamePrefix, location_name: "executionNamePrefix"))
     StepFunctionsAction.add_member(:state_machine_name, Shapes::ShapeRef.new(shape: StateMachineName, required: true, location_name: "stateMachineName"))
     StepFunctionsAction.add_member(:role_arn, Shapes::ShapeRef.new(shape: AwsArn, required: true, location_name: "roleArn"))
@@ -4206,6 +4223,23 @@ module Aws::IoT
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
       end)
 
+      api.add_operation(:get_statistics, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetStatistics"
+        o.http_method = "POST"
+        o.http_request_uri = "/indices/statistics"
+        o.input = Shapes::ShapeRef.new(shape: GetStatisticsRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetStatisticsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidQueryException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidAggregationException)
+        o.errors << Shapes::ShapeRef.new(shape: IndexNotReadyException)
+      end)
+
       api.add_operation(:get_topic_rule, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetTopicRule"
         o.http_method = "GET"

data/lib/aws-sdk-iot/types.rb

@@ -4039,17 +4039,17 @@ module Aws::IoT
     #   Contains a value that specifies the type of indexing performed.
     #   Valid values are:
     #
-    #   * REGISTRY – Your thing index will contain only registry data.
+    #   * REGISTRY – Your thing index contains only registry data.
     #
-    #   * REGISTRY\_AND\_SHADOW - Your thing index will contain registry
-    #     data and shadow data.
+    #   * REGISTRY\_AND\_SHADOW - Your thing index contains registry data
+    #     and shadow data.
     #
-    #   * REGISTRY\_AND\_CONNECTIVITY\_STATUS - Your thing index will
-    #     contain registry data and thing connectivity status data.
+    #   * REGISTRY\_AND\_CONNECTIVITY\_STATUS - Your thing index contains
+    #     registry data and thing connectivity status data.
     #
     #   * REGISTRY\_AND\_SHADOW\_AND\_CONNECTIVITY\_STATUS - Your thing
-    #     index will contain registry data, shadow data, and thing
-    #     connectivity status data.
+    #     index contains registry data, shadow data, and thing connectivity
+    #     status data.
     #   @return [String]
     #
     class DescribeIndexResponse < Struct.new(
@@ -5339,6 +5339,51 @@ module Aws::IoT
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetStatisticsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         index_name: "IndexName",
+    #         query_string: "QueryString", # required
+    #         aggregation_field: "AggregationField",
+    #         query_version: "QueryVersion",
+    #       }
+    #
+    # @!attribute [rw] index_name
+    #   The name of the index to search. The default value is `AWS_Things`.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_string
+    #   The query used to search. You can specify "*" for the query
+    #   string to get the count of all indexed things in your AWS account.
+    #   @return [String]
+    #
+    # @!attribute [rw] aggregation_field
+    #   The aggregation field name. Currently not supported.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_version
+    #   The version of the query used to search.
+    #   @return [String]
+    #
+    class GetStatisticsRequest < Struct.new(
+      :index_name,
+      :query_string,
+      :aggregation_field,
+      :query_version)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] statistics
+    #   The statistics returned by the Fleet Indexing service based on the
+    #   query and aggregation field.
+    #   @return [Types::Statistics]
+    #
+    class GetStatisticsResponse < Struct.new(
+      :statistics)
+      include Aws::Structure
+    end
+
     # The input for the GetTopicRule operation.
     #
     # @note When making an API call, you may pass GetTopicRuleRequest
@@ -6462,8 +6507,8 @@ module Aws::IoT
     #       }
     #
     # @!attribute [rw] next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are
+    #   no additional results.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -6481,8 +6526,8 @@ module Aws::IoT
     #   @return [Array<String>]
     #
     # @!attribute [rw] next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are
+    #   no additional results.
     #   @return [String]
     #
     class ListIndicesResponse < Struct.new(
@@ -8458,8 +8503,7 @@ module Aws::IoT
     #   @return [String]
     #
     # @!attribute [rw] set_as_active
-    #   A boolean value that specifies if the CA certificate is set to
-    #   active.
+    #   A boolean value that specifies if the certificate is set to active.
     #   @return [Boolean]
     #
     # @!attribute [rw] status
@@ -9193,8 +9237,8 @@ module Aws::IoT
     #   @return [String]
     #
     # @!attribute [rw] next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are
+    #   no additional results.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -9215,8 +9259,8 @@ module Aws::IoT
     end
 
     # @!attribute [rw] next_token
-    #   The token used to get the next set of results, or **null** if there
-    #   are no additional results.
+    #   The token used to get the next set of results, or null if there are
+    #   no additional results.
     #   @return [String]
     #
     # @!attribute [rw] things
@@ -9650,6 +9694,18 @@ module Aws::IoT
       include Aws::Structure
     end
 
+    # A map of key-value pairs for all supported statistics. Currently, only
+    # count is supported.
+    #
+    # @!attribute [rw] count
+    #   The count of things that match the query.
+    #   @return [Integer]
+    #
+    class Statistics < Struct.new(
+      :count)
+      include Aws::Structure
+    end
+
     # Starts execution of a Step Functions state machine.
     #
     # @note When making an API call, you may pass StepFunctionsAction
@@ -10081,14 +10137,14 @@ module Aws::IoT
     # The connectivity status of the thing.
     #
     # @!attribute [rw] connected
-    #   True if the thing is connected to the AWS IoT service, false if it
+    #   True if the thing is connected to the AWS IoT service; false if it
     #   is not connected.
     #   @return [Boolean]
     #
     # @!attribute [rw] timestamp
     #   The epoch time (in milliseconds) when the thing last connected or
-    #   disconnected. Note that if the thing has been disconnected for more
-    #   than a few weeks, the time value can be missing.
+    #   disconnected. If the thing has been disconnected for more than a few
+    #   weeks, the time value might be missing.
     #   @return [Integer]
     #
     class ThingConnectivity < Struct.new(
@@ -10124,8 +10180,7 @@ module Aws::IoT
     #   @return [String]
     #
     # @!attribute [rw] connectivity
-    #   Indicates whether or not the thing is connected to the AWS IoT
-    #   service.
+    #   Indicates whether the thing is connected to the AWS IoT service.
     #   @return [Types::ThingConnectivity]
     #
     class ThingDocument < Struct.new(
@@ -10256,9 +10311,9 @@ module Aws::IoT
     # @!attribute [rw] thing_indexing_mode
     #   Thing indexing mode. Valid values are:
     #
-    #   * REGISTRY – Your thing index will contain only registry data.
+    #   * REGISTRY – Your thing index contains registry data only.
     #
-    #   * REGISTRY\_AND\_SHADOW - Your thing index will contain registry and
+    #   * REGISTRY\_AND\_SHADOW - Your thing index contains registry and
     #     shadow data.
     #
     #   * OFF - Thing indexing is disabled.
@@ -10267,9 +10322,9 @@ module Aws::IoT
     # @!attribute [rw] thing_connectivity_indexing_mode
     #   Thing connectivity indexing mode. Valid values are:
     #
-    #   * STATUS – Your thing index will contain connectivity status. In
-    #     order to enable thing connectivity indexing, thingIndexMode must
-    #     not be set to OFF.
+    #   * STATUS – Your thing index contains connectivity status. To enable
+    #     thing connectivity indexing, thingIndexMode must not be set to
+    #     OFF.
     #
     #   * OFF - Thing connectivity status indexing is disabled.
     #   @return [String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-iot
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-03-18 00:00:00.000000000 Z
+date: 2019-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core