aws-sdk-iotwireless 1.23.0 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8883b8a8de1ae4ef97ea55d9392aed92b25f08b878c418e78672665dbe03f0de
-  data.tar.gz: 4f31738649dc5a4422b4ce4b44070b9e7742bc0c844da80c6495f93ae75a486f
+  metadata.gz: '09e1b9275998710a25dd3bf41d5929a3ea6575d9835593389e5a1805370861d4'
+  data.tar.gz: 81f4e2a7007fbecc50a6ec611f4add8df197e920e00a53e33a894305101041ff
 SHA512:
-  metadata.gz: 605999cadccf95349325fd9e06452914ca00cc20e4fcc1cb95d886f9d22bebc1745f452bbf501ca7171e8e95bde392b25f774c7b295975b1a8e4055f7de0a87a
-  data.tar.gz: 12d5525eacac6749dad871e2bac96523085c5fcb76544a05c641651d38c4483666711f4096ce8e18d6c3789f1edf0ada4f69f7d5332e9953163ec143bd556829
+  metadata.gz: 9dcb8d4a51e744ee0690eec2da1302db90caee10b5c97b94a73b2fa630243fbe5a2bbb46bf7a208748ad6455e00449143097a364196ca882b0cc875d7638e8aa
+  data.tar.gz: e1b96038b56ad5fc5358572de10a5e6e7b62a36274fd8feae22e48a8cb4efbc8c573e8e159504b0c586780ac854d7761559281a39471bef57ffa499df11fe915

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.24.0 (2022-07-07)
+------------------
+
+* Feature - Adds 5 APIs: PutPositionConfiguration, GetPositionConfiguration, ListPositionConfigurations, UpdatePosition, GetPosition for the new Positioning Service feature which enables customers to configure solvers to calculate position of LoRaWAN devices, or specify position of LoRaWAN devices & gateways.
+
 1.23.0 (2022-04-27)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.23.0
+1.24.0

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

@@ -1041,6 +1041,11 @@ module Aws::IoTWireless
     #         fuota: 1,
     #         multicast: 1,
     #         clock_sync: 1,
+    #         positioning: {
+    #           clock_sync: 1,
+    #           stream: 1,
+    #           gnss: 1,
+    #         },
     #       },
     #     },
     #     tags: [
@@ -1713,7 +1718,7 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
-    # Get the event configuration by resource types.
+    # Get the event configuration based on resource types.
     #
     # @return [Types::GetEventConfigurationByResourceTypesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1956,6 +1961,85 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
+    # Get the position information for a given resource.
+    #
+    # @option params [required, String] :resource_identifier
+    #   Resource identifier used to retrieve the position information.
+    #
+    # @option params [required, String] :resource_type
+    #   Resource type of the resource for which position information is
+    #   retrieved.
+    #
+    # @return [Types::GetPositionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetPositionResponse#position #position} => Array<Float>
+    #   * {Types::GetPositionResponse#accuracy #accuracy} => Types::Accuracy
+    #   * {Types::GetPositionResponse#solver_type #solver_type} => String
+    #   * {Types::GetPositionResponse#solver_provider #solver_provider} => String
+    #   * {Types::GetPositionResponse#solver_version #solver_version} => String
+    #   * {Types::GetPositionResponse#timestamp #timestamp} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_position({
+    #     resource_identifier: "PositionResourceIdentifier", # required
+    #     resource_type: "WirelessDevice", # required, accepts WirelessDevice, WirelessGateway
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.position #=> Array
+    #   resp.position[0] #=> Float
+    #   resp.accuracy.horizontal_accuracy #=> Float
+    #   resp.accuracy.vertical_accuracy #=> Float
+    #   resp.solver_type #=> String, one of "GNSS"
+    #   resp.solver_provider #=> String, one of "Semtech"
+    #   resp.solver_version #=> String
+    #   resp.timestamp #=> String
+    #
+    # @overload get_position(params = {})
+    # @param [Hash] params ({})
+    def get_position(params = {}, options = {})
+      req = build_request(:get_position, params)
+      req.send_request(options)
+    end
+
+    # Get position configuration for a given resource.
+    #
+    # @option params [required, String] :resource_identifier
+    #   Resource identifier used in a position configuration.
+    #
+    # @option params [required, String] :resource_type
+    #   Resource type of the resource for which position configuration is
+    #   retrieved.
+    #
+    # @return [Types::GetPositionConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetPositionConfigurationResponse#solvers #solvers} => Types::PositionSolverDetails
+    #   * {Types::GetPositionConfigurationResponse#destination #destination} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_position_configuration({
+    #     resource_identifier: "PositionResourceIdentifier", # required
+    #     resource_type: "WirelessDevice", # required, accepts WirelessDevice, WirelessGateway
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.solvers.semtech_gnss.provider #=> String, one of "Semtech"
+    #   resp.solvers.semtech_gnss.type #=> String, one of "GNSS"
+    #   resp.solvers.semtech_gnss.status #=> String, one of "Enabled", "Disabled"
+    #   resp.solvers.semtech_gnss.fec #=> String, one of "ROSE", "NONE"
+    #   resp.destination #=> String
+    #
+    # @overload get_position_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_position_configuration(params = {}, options = {})
+      req = build_request(:get_position_configuration, params)
+      req.send_request(options)
+    end
+
     # Get the event configuration for a particular resource identifier.
     #
     # @option params [required, String] :identifier
@@ -1967,7 +2051,7 @@ module Aws::IoTWireless
     #
     # @option params [String] :partner_type
     #   Partner type of the resource if the identifier type is
-    #   PartnerAccountId.
+    #   `PartnerAccountId`.
     #
     # @return [Types::GetResourceEventConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2181,6 +2265,9 @@ module Aws::IoTWireless
     #   resp.lo_ra_wan.f_ports.fuota #=> Integer
     #   resp.lo_ra_wan.f_ports.multicast #=> Integer
     #   resp.lo_ra_wan.f_ports.clock_sync #=> Integer
+    #   resp.lo_ra_wan.f_ports.positioning.clock_sync #=> Integer
+    #   resp.lo_ra_wan.f_ports.positioning.stream #=> Integer
+    #   resp.lo_ra_wan.f_ports.positioning.gnss #=> Integer
     #   resp.sidewalk.amazon_id #=> String
     #   resp.sidewalk.sidewalk_id #=> String
     #   resp.sidewalk.sidewalk_manufacturing_sn #=> String
@@ -2776,6 +2863,54 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
+    # List position configurations for a given resource, such as positioning
+    # solvers.
+    #
+    # @option params [String] :resource_type
+    #   Resource type for which position configurations are listed.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return in this operation.
+    #
+    # @option params [String] :next_token
+    #   To retrieve the next set of results, the `nextToken` value from a
+    #   previous response; otherwise **null** to receive the first set of
+    #   results.
+    #
+    # @return [Types::ListPositionConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListPositionConfigurationsResponse#position_configuration_list #position_configuration_list} => Array<Types::PositionConfigurationItem>
+    #   * {Types::ListPositionConfigurationsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_position_configurations({
+    #     resource_type: "WirelessDevice", # accepts WirelessDevice, WirelessGateway
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.position_configuration_list #=> Array
+    #   resp.position_configuration_list[0].resource_identifier #=> String
+    #   resp.position_configuration_list[0].resource_type #=> String, one of "WirelessDevice", "WirelessGateway"
+    #   resp.position_configuration_list[0].solvers.semtech_gnss.provider #=> String, one of "Semtech"
+    #   resp.position_configuration_list[0].solvers.semtech_gnss.type #=> String, one of "GNSS"
+    #   resp.position_configuration_list[0].solvers.semtech_gnss.status #=> String, one of "Enabled", "Disabled"
+    #   resp.position_configuration_list[0].solvers.semtech_gnss.fec #=> String, one of "ROSE", "NONE"
+    #   resp.position_configuration_list[0].destination #=> String
+    #   resp.next_token #=> String
+    #
+    # @overload list_position_configurations(params = {})
+    # @param [Hash] params ({})
+    def list_position_configurations(params = {}, options = {})
+      req = build_request(:list_position_configurations, params)
+      req.send_request(options)
+    end
+
     # List queued messages in the downlink queue.
     #
     # @option params [required, String] :id
@@ -3069,6 +3204,47 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
+    # Put position configuration for a given resource.
+    #
+    # @option params [required, String] :resource_identifier
+    #   Resource identifier used to update the position configuration.
+    #
+    # @option params [required, String] :resource_type
+    #   Resource type of the resource for which you want to update the
+    #   position configuration.
+    #
+    # @option params [Types::PositionSolverConfigurations] :solvers
+    #   The positioning solvers used to update the position configuration of
+    #   the resource.
+    #
+    # @option params [String] :destination
+    #   The position data destination that describes the AWS IoT rule that
+    #   processes the device's position data for use by AWS IoT Core for
+    #   LoRaWAN.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_position_configuration({
+    #     resource_identifier: "PositionResourceIdentifier", # required
+    #     resource_type: "WirelessDevice", # required, accepts WirelessDevice, WirelessGateway
+    #     solvers: {
+    #       semtech_gnss: {
+    #         status: "Enabled", # required, accepts Enabled, Disabled
+    #         fec: "ROSE", # required, accepts ROSE, NONE
+    #       },
+    #     },
+    #     destination: "DestinationName",
+    #   })
+    #
+    # @overload put_position_configuration(params = {})
+    # @param [Hash] params ({})
+    def put_position_configuration(params = {}, options = {})
+      req = build_request(:put_position_configuration, params)
+      req.send_request(options)
+    end
+
     # Sets the log-level override for a resource-ID and resource-type. This
     # option can be specified for a wireless gateway or a wireless device. A
     # limit of 200 log level override can be set per account.
@@ -3474,7 +3650,7 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
-    # Update the event configuration by resource types.
+    # Update the event configuration based on resource types.
     #
     # @option params [Types::DeviceRegistrationStateResourceTypeEventConfiguration] :device_registration_state
     #   Device registration state resource type event configuration object for
@@ -3744,6 +3920,34 @@ module Aws::IoTWireless
       req.send_request(options)
     end
 
+    # Update the position information of a resource.
+    #
+    # @option params [required, String] :resource_identifier
+    #   Resource identifier of the resource for which position is updated.
+    #
+    # @option params [required, String] :resource_type
+    #   Resource type of the resource for which position is updated.
+    #
+    # @option params [required, Array<Float>] :position
+    #   The position information of the resource.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_position({
+    #     resource_identifier: "PositionResourceIdentifier", # required
+    #     resource_type: "WirelessDevice", # required, accepts WirelessDevice, WirelessGateway
+    #     position: [1.0], # required
+    #   })
+    #
+    # @overload update_position(params = {})
+    # @param [Hash] params ({})
+    def update_position(params = {}, options = {})
+      req = build_request(:update_position, params)
+      req.send_request(options)
+    end
+
     # Update the event configuration for a particular resource identifier.
     #
     # @option params [required, String] :identifier
@@ -3755,19 +3959,19 @@ module Aws::IoTWireless
     #
     # @option params [String] :partner_type
     #   Partner type of the resource if the identifier type is
-    #   PartnerAccountId
+    #   `PartnerAccountId`
     #
     # @option params [Types::DeviceRegistrationStateEventConfiguration] :device_registration_state
-    #   Event configuration for the device registration state event
+    #   Event configuration for the device registration state event.
     #
     # @option params [Types::ProximityEventConfiguration] :proximity
-    #   Event configuration for the Proximity event
+    #   Event configuration for the proximity event.
     #
     # @option params [Types::JoinEventConfiguration] :join
-    #   Event configuration for the join event
+    #   Event configuration for the join event.
     #
     # @option params [Types::ConnectionStatusEventConfiguration] :connection_status
-    #   Event configuration for the connection status event
+    #   Event configuration for the connection status event.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3845,6 +4049,13 @@ module Aws::IoTWireless
     #       abp_v1_0_x: {
     #         f_cnt_start: 1,
     #       },
+    #       f_ports: {
+    #         positioning: {
+    #           clock_sync: 1,
+    #           stream: 1,
+    #           gnss: 1,
+    #         },
+    #       },
     #     },
     #   })
     #
@@ -3907,7 +4118,7 @@ module Aws::IoTWireless
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotwireless'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end