aws-sdk-iotwireless 1.23.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8883b8a8de1ae4ef97ea55d9392aed92b25f08b878c418e78672665dbe03f0de
-  data.tar.gz: 4f31738649dc5a4422b4ce4b44070b9e7742bc0c844da80c6495f93ae75a486f
+  metadata.gz: de2cd1030f6463f43e6039c63c9d0ce1abe0b87712fd3e5bdef30925a75ecc40
+  data.tar.gz: e07d5378e005db37fc7e0ddc1aa8dea81f43fe79c2c699f05c75fe976952034e
 SHA512:
-  metadata.gz: 605999cadccf95349325fd9e06452914ca00cc20e4fcc1cb95d886f9d22bebc1745f452bbf501ca7171e8e95bde392b25f774c7b295975b1a8e4055f7de0a87a
-  data.tar.gz: 12d5525eacac6749dad871e2bac96523085c5fcb76544a05c641651d38c4483666711f4096ce8e18d6c3789f1edf0ada4f69f7d5332e9953163ec143bd556829
+  metadata.gz: 97dae7af4746b100d79f770cdd12e9b5d5df16e10fb75e519f9c4f9147b6167bd28f37c8db1254b4fc61ccef84f3f9519ba7b521fc8dd9e09a4d7d970da35591
+  data.tar.gz: 30a7e816ceac4805ac8246ec9b5490ddfb90e17be1188d7d810ca6a8de376a13a8db9807d9b8c1fce4acce619c06c88d7137d5dc2fa07dc7dac723f0af031d11

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.26.0 (2022-08-25)
+------------------
+
+* Feature - This release includes a new feature for the customers to enable the LoRa gateways to send out beacons for Class B devices and an option to select one or more gateways for Class C devices when sending the LoRaWAN downlink messages.
+
+1.25.0 (2022-08-08)
+------------------
+
+* Feature - AWS IoT Wireless release support for sidewalk data reliability.
+
+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.26.0

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

@@ -939,6 +939,8 @@ module Aws::IoTWireless
     #     name: "ServiceProfileName",
     #     lo_ra_wan: {
     #       add_gw_metadata: false,
+    #       dr_min: 1,
+    #       dr_max: 1,
     #     },
     #     tags: [
     #       {
@@ -1041,6 +1043,11 @@ module Aws::IoTWireless
     #         fuota: 1,
     #         multicast: 1,
     #         clock_sync: 1,
+    #         positioning: {
+    #           clock_sync: 1,
+    #           stream: 1,
+    #           gnss: 1,
+    #         },
     #       },
     #     },
     #     tags: [
@@ -1106,6 +1113,10 @@ module Aws::IoTWireless
     #       ],
     #       net_id_filters: ["NetId"],
     #       sub_bands: [1],
+    #       beaconing: {
+    #         data_rate: 1,
+    #         frequencies: [1],
+    #       },
     #     },
     #     tags: [
     #       {
@@ -1713,7 +1724,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:
     #
@@ -1721,6 +1732,7 @@ module Aws::IoTWireless
     #   * {Types::GetEventConfigurationByResourceTypesResponse#proximity #proximity} => Types::ProximityResourceTypeEventConfiguration
     #   * {Types::GetEventConfigurationByResourceTypesResponse#join #join} => Types::JoinResourceTypeEventConfiguration
     #   * {Types::GetEventConfigurationByResourceTypesResponse#connection_status #connection_status} => Types::ConnectionStatusResourceTypeEventConfiguration
+    #   * {Types::GetEventConfigurationByResourceTypesResponse#message_delivery_status #message_delivery_status} => Types::MessageDeliveryStatusResourceTypeEventConfiguration
     #
     # @example Response structure
     #
@@ -1728,6 +1740,7 @@ module Aws::IoTWireless
     #   resp.proximity.sidewalk.wireless_device_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.join.lo_ra_wan.wireless_device_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.connection_status.lo_ra_wan.wireless_gateway_event_topic #=> String, one of "Enabled", "Disabled"
+    #   resp.message_delivery_status.sidewalk.wireless_device_event_topic #=> String, one of "Enabled", "Disabled"
     #
     # @overload get_event_configuration_by_resource_types(params = {})
     # @param [Hash] params ({})
@@ -1956,6 +1969,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 +2059,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:
     #
@@ -1975,6 +2067,7 @@ module Aws::IoTWireless
     #   * {Types::GetResourceEventConfigurationResponse#proximity #proximity} => Types::ProximityEventConfiguration
     #   * {Types::GetResourceEventConfigurationResponse#join #join} => Types::JoinEventConfiguration
     #   * {Types::GetResourceEventConfigurationResponse#connection_status #connection_status} => Types::ConnectionStatusEventConfiguration
+    #   * {Types::GetResourceEventConfigurationResponse#message_delivery_status #message_delivery_status} => Types::MessageDeliveryStatusEventConfiguration
     #
     # @example Request syntax with placeholder values
     #
@@ -1994,6 +2087,8 @@ module Aws::IoTWireless
     #   resp.join.wireless_device_id_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.connection_status.lo_ra_wan.gateway_eui_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.connection_status.wireless_gateway_id_event_topic #=> String, one of "Enabled", "Disabled"
+    #   resp.message_delivery_status.sidewalk.amazon_id_event_topic #=> String, one of "Enabled", "Disabled"
+    #   resp.message_delivery_status.wireless_device_id_event_topic #=> String, one of "Enabled", "Disabled"
     #
     # @overload get_resource_event_configuration(params = {})
     # @param [Hash] params ({})
@@ -2181,6 +2276,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
@@ -2277,6 +2375,9 @@ module Aws::IoTWireless
     #   resp.lo_ra_wan.net_id_filters[0] #=> String
     #   resp.lo_ra_wan.sub_bands #=> Array
     #   resp.lo_ra_wan.sub_bands[0] #=> Integer
+    #   resp.lo_ra_wan.beaconing.data_rate #=> Integer
+    #   resp.lo_ra_wan.beaconing.frequencies #=> Array
+    #   resp.lo_ra_wan.beaconing.frequencies[0] #=> Integer
     #   resp.arn #=> String
     #   resp.thing_name #=> String
     #   resp.thing_arn #=> String
@@ -2574,6 +2675,8 @@ module Aws::IoTWireless
     #   resp.event_configurations_list[0].events.join.wireless_device_id_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.event_configurations_list[0].events.connection_status.lo_ra_wan.gateway_eui_event_topic #=> String, one of "Enabled", "Disabled"
     #   resp.event_configurations_list[0].events.connection_status.wireless_gateway_id_event_topic #=> String, one of "Enabled", "Disabled"
+    #   resp.event_configurations_list[0].events.message_delivery_status.sidewalk.amazon_id_event_topic #=> String, one of "Enabled", "Disabled"
+    #   resp.event_configurations_list[0].events.message_delivery_status.wireless_device_id_event_topic #=> String, one of "Enabled", "Disabled"
     #
     # @overload list_event_configurations(params = {})
     # @param [Hash] params ({})
@@ -2776,6 +2879,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
@@ -2817,6 +2968,11 @@ module Aws::IoTWireless
     #   resp.downlink_queue_messages_list[0].transmit_mode #=> Integer
     #   resp.downlink_queue_messages_list[0].received_at #=> String
     #   resp.downlink_queue_messages_list[0].lo_ra_wan.f_port #=> Integer
+    #   resp.downlink_queue_messages_list[0].lo_ra_wan.participating_gateways.downlink_mode #=> String, one of "SEQUENTIAL", "CONCURRENT", "USING_UPLINK_GATEWAY"
+    #   resp.downlink_queue_messages_list[0].lo_ra_wan.participating_gateways.gateway_list #=> Array
+    #   resp.downlink_queue_messages_list[0].lo_ra_wan.participating_gateways.gateway_list[0].gateway_id #=> String
+    #   resp.downlink_queue_messages_list[0].lo_ra_wan.participating_gateways.gateway_list[0].downlink_frequency #=> Integer
+    #   resp.downlink_queue_messages_list[0].lo_ra_wan.participating_gateways.transmission_interval #=> Integer
     #
     # @overload list_queued_messages(params = {})
     # @param [Hash] params ({})
@@ -3060,6 +3216,9 @@ module Aws::IoTWireless
     #   resp.wireless_gateway_list[0].lo_ra_wan.net_id_filters[0] #=> String
     #   resp.wireless_gateway_list[0].lo_ra_wan.sub_bands #=> Array
     #   resp.wireless_gateway_list[0].lo_ra_wan.sub_bands[0] #=> Integer
+    #   resp.wireless_gateway_list[0].lo_ra_wan.beaconing.data_rate #=> Integer
+    #   resp.wireless_gateway_list[0].lo_ra_wan.beaconing.frequencies #=> Array
+    #   resp.wireless_gateway_list[0].lo_ra_wan.beaconing.frequencies[0] #=> Integer
     #   resp.wireless_gateway_list[0].last_uplink_received_at #=> String
     #
     # @overload list_wireless_gateways(params = {})
@@ -3069,6 +3228,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.
@@ -3211,10 +3411,21 @@ module Aws::IoTWireless
     #     wireless_metadata: {
     #       lo_ra_wan: {
     #         f_port: 1,
+    #         participating_gateways: {
+    #           downlink_mode: "SEQUENTIAL", # required, accepts SEQUENTIAL, CONCURRENT, USING_UPLINK_GATEWAY
+    #           gateway_list: [ # required
+    #             {
+    #               gateway_id: "WirelessGatewayId", # required
+    #               downlink_frequency: 1, # required
+    #             },
+    #           ],
+    #           transmission_interval: 1, # required
+    #         },
     #       },
     #       sidewalk: {
     #         seq: 1,
     #         message_type: "CUSTOM_COMMAND_ID_NOTIFY", # accepts CUSTOM_COMMAND_ID_NOTIFY, CUSTOM_COMMAND_ID_GET, CUSTOM_COMMAND_ID_SET, CUSTOM_COMMAND_ID_RESP
+    #         ack_mode_retry_duration_secs: 1,
     #       },
     #     },
     #   })
@@ -3474,7 +3685,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
@@ -3492,6 +3703,10 @@ module Aws::IoTWireless
     #   Connection status resource type event configuration object for
     #   enabling and disabling wireless gateway topic.
     #
+    # @option params [Types::MessageDeliveryStatusResourceTypeEventConfiguration] :message_delivery_status
+    #   Message delivery status resource type event configuration object for
+    #   enabling and disabling wireless device topic.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -3517,6 +3732,11 @@ module Aws::IoTWireless
     #         wireless_gateway_event_topic: "Enabled", # accepts Enabled, Disabled
     #       },
     #     },
+    #     message_delivery_status: {
+    #       sidewalk: {
+    #         wireless_device_event_topic: "Enabled", # accepts Enabled, Disabled
+    #       },
+    #     },
     #   })
     #
     # @overload update_event_configuration_by_resource_types(params = {})
@@ -3744,6 +3964,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 +4003,22 @@ 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.
+    #
+    # @option params [Types::MessageDeliveryStatusEventConfiguration] :message_delivery_status
+    #   Event configuration for the message delivery status event.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -3801,6 +4052,12 @@ module Aws::IoTWireless
     #       },
     #       wireless_gateway_id_event_topic: "Enabled", # accepts Enabled, Disabled
     #     },
+    #     message_delivery_status: {
+    #       sidewalk: {
+    #         amazon_id_event_topic: "Enabled", # accepts Enabled, Disabled
+    #       },
+    #       wireless_device_id_event_topic: "Enabled", # accepts Enabled, Disabled
+    #     },
     #   })
     #
     # @overload update_resource_event_configuration(params = {})
@@ -3845,6 +4102,13 @@ module Aws::IoTWireless
     #       abp_v1_0_x: {
     #         f_cnt_start: 1,
     #       },
+    #       f_ports: {
+    #         positioning: {
+    #           clock_sync: 1,
+    #           stream: 1,
+    #           gnss: 1,
+    #         },
+    #       },
     #     },
     #   })
     #
@@ -3907,7 +4171,7 @@ module Aws::IoTWireless
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotwireless'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end