aws-sdk-iotmanagedintegrations 1.11.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9be42f03863a0bf99ef79faf700bc86b0073b54a4490caedc9f56337d8cd1968
-  data.tar.gz: 99e1a51f1349dd44d8a527b0e081c9261029b1a25122817c40866386e4f17485
+  metadata.gz: a98e0c8b6e017f16c9f041e90b3e7d1d3d6eb260dcd0544b9d73eba0045f139d
+  data.tar.gz: 71e2b843673b5abba7ba2b5bbc46248150d6be87248be7b57e62c6def19bf778
 SHA512:
-  metadata.gz: 30b306118cd4292f409c36d56bb1f8fea758cd49e53128207c79454a30e3fa8d33c58754844fed51cc2d198e6a2f0d2f5c4a53e47befa061ae1ae8cceaf81dd0
-  data.tar.gz: fe42071a11ce71d56ead05bab0a333a871830b14099cd208006ec82a939b315619a550bded41ec2be7a8b3585808e028e142042964cdc42cb799d6bd4a7bdf13
+  metadata.gz: 9b1d012cb8110403559c4d1e22052ced3b9d60cb2a1232ad10d5c0e4a3f2437584edea9337926923046232d7c1bfb531030f05e10b582a554f5447267ef703be
+  data.tar.gz: 646b7d43834d943ba241dfe4d47f93304ed95ffcc2b2748128a3987064643b292735f6d5e4f835bd567bee1805e7d97b0d4c1f03f9e70d23afbf5ae352f0cdf6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.12.0 (2025-10-30)
+------------------
+
+* Feature - Add a new GetManagedThingCertificate API to expose Iot ManagedIntegrations (MI) device certificate, and add  "-"  support for name, properties, actions and events in the CapabilityReportCapability object.
+
 1.11.0 (2025-10-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.11.0
+1.12.0

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

@@ -713,9 +713,12 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Create a product credential locker. This operation will trigger the
-    # creation of all the manufacturing resources including the Wi-Fi setup
-    # key pair and device certificate.
+    # Create a credential locker.
+    #
+    # <note markdown="1"> This operation will not trigger the creation of all the manufacturing
+    # resources.
+    #
+    #  </note>
     #
     # @option params [String] :name
     #   The name of the credential locker.
@@ -762,8 +765,10 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Create a destination. IoT managed integrations uses the destination to
-    # determine where to deliver notifications for a device.
+    # Create a notification destination such as Kinesis Data Streams that
+    # receive events and notifications from Managed integrations. Managed
+    # integrations uses the destination to determine where to deliver
+    # notifications.
     #
     # @option params [required, String] :delivery_destination_arn
     #   The Amazon Resource Name (ARN) of the customer-managed destination.
@@ -868,7 +873,7 @@ module Aws::IoTManagedIntegrations
 
     # Creates a managed thing. A managed thing contains the device
     # identifier, protocol supported, and capabilities of the device in a
-    # protocol-specific format.
+    # data model format defined by Managed integrations.
     #
     # @option params [required, String] :role
     #   The type of device used. This will be the hub controller, cloud
@@ -1060,7 +1065,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Create an over-the-air (OTA) task to update a device.
+    # Create an over-the-air (OTA) task to target a device.
     #
     # @option params [String] :description
     #   The description of the over-the-air (OTA) task.
@@ -1297,7 +1302,13 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Remove a third party account and related devices from an end user.
+    # Remove a third-party account association for an end user.
+    #
+    # <note markdown="1"> You must first call the `DeregisterAccountAssociation` to remove the
+    # connection between the managed thing and the third-party account
+    # before calling the `DeleteAccountAssociation` API.
+    #
+    #  </note>
     #
     # @option params [required, String] :account_association_id
     #   The unique identifier of the account association to be deleted.
@@ -1337,8 +1348,13 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Delete a connector destination for connecting a cloud-to-cloud (C2C)
-    # connector to the customer's Amazon Web Services account.
+    # Delete a connector destination linked to a cloud-to-cloud (C2C)
+    # connector.
+    #
+    # <note markdown="1"> Deletion can't be done if the account association has used this
+    # connector destination.
+    #
+    #  </note>
     #
     # @option params [required, String] :identifier
     #   The identifier of the connector destination.
@@ -1383,7 +1399,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Deletes a customer-managed destination specified by id.
+    # Deletes a notification destination specified by name.
     #
     # @option params [required, String] :name
     #   The id of the customer-managed destination.
@@ -1423,9 +1439,10 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Delete a managed thing. If a controller is deleted, all of the devices
-    # connected to it will have their status changed to `PENDING`. It is not
-    # possible to remove a cloud device.
+    # Delete a managed thing. For direct-connected and hub-connected devices
+    # connecting with Managed integrations via a controller, all of the
+    # devices connected to it will have their status changed to `PENDING`.
+    # It is not possible to remove a cloud-to-cloud device.
     #
     # @option params [required, String] :identifier
     #   The id of the managed thing.
@@ -1532,8 +1549,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Deregisters an account association, removing the connection between a
-    # managed thing and a third-party account.
+    # Deregister an account association from a managed thing.
     #
     # @option params [required, String] :managed_thing_id
     #   The identifier of the managed thing to be deregistered from the
@@ -1602,7 +1618,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Gets all the information about a connector for a connector developer.
+    # Get configuration details for a cloud connector.
     #
     # @option params [required, String] :identifier
     #   The identifier of the C2C connector.
@@ -1679,8 +1695,8 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Get a connector destination of a cloud-to-cloud (C2C) connector
-    # connecting to a customer's Amazon Web Services account.
+    # Get connector destination details linked to a cloud-to-cloud (C2C)
+    # connector.
     #
     # @option params [required, String] :identifier
     #   The identifier of the C2C connector destination.
@@ -1809,7 +1825,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Gets a destination by ID.
+    # Gets a destination by name.
     #
     # @option params [required, String] :name
     #   The name of the customer-managed destination.
@@ -1946,7 +1962,8 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Get the attributes and capabilities associated with a managed thing.
+    # Get details of a managed thing including its attributes and
+    # capabilities.
     #
     # @option params [required, String] :identifier
     #   The id of the managed thing.
@@ -2069,6 +2086,47 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
+    # Retrieves the certificate PEM for a managed IoT thing.
+    #
+    # @option params [required, String] :identifier
+    #   The identifier of the managed thing.
+    #
+    # @return [Types::GetManagedThingCertificateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetManagedThingCertificateResponse#managed_thing_id #managed_thing_id} => String
+    #   * {Types::GetManagedThingCertificateResponse#certificate_pem #certificate_pem} => String
+    #
+    #
+    # @example Example: Get managed thing certificate
+    #
+    #   resp = client.get_managed_thing_certificate({
+    #     identifier: "example-managed-thing-id", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     certificate_pem: "-----BEGIN CERTIFICATE-----\nMIIBkTCB+wIJAKHHH...\n-----END CERTIFICATE-----", 
+    #     managed_thing_id: "example-managed-thing-id", 
+    #   }
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_managed_thing_certificate({
+    #     identifier: "ManagedThingId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.managed_thing_id #=> String
+    #   resp.certificate_pem #=> String
+    #
+    # @overload get_managed_thing_certificate(params = {})
+    # @param [Hash] params ({})
+    def get_managed_thing_certificate(params = {}, options = {})
+      req = build_request(:get_managed_thing_certificate, params)
+      req.send_request(options)
+    end
+
     # Get the connectivity status of a managed thing.
     #
     # @option params [required, String] :identifier
@@ -2169,7 +2227,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Get a notification configuration.
+    # Get a notification configuration for a specified event type.
     #
     # @option params [required, String] :event_type
     #   The type of event triggering a device notification to the
@@ -2205,7 +2263,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Get the over-the-air (OTA) task.
+    # Get details of the over-the-air (OTA) task by its task id.
     #
     # @option params [required, String] :identifier
     #   The over-the-air (OTA) task id.
@@ -2363,8 +2421,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Get the runtime log configuration for a specific managed thing or for
-    # all managed things as a group.
+    # Get the runtime log configuration for a specific managed thing.
     #
     # @option params [required, String] :managed_thing_id
     #   The id for a managed thing.
@@ -2493,7 +2550,8 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Returns a list of connectors based on permissions.
+    # Returns a list of connectors filtered by its Lambda Amazon Resource
+    # Name (ARN) and `type`.
     #
     # @option params [String] :type
     #   The type of cloud connectors to filter by when listing available
@@ -2665,7 +2723,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # List all destination names under one Amazon Web Services account.
+    # List all notification destinations.
     #
     # @option params [String] :next_token
     #   A token that can be used to retrieve the next set of results.
@@ -3525,8 +3583,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Reset a runtime log configuration for a specific managed thing or for
-    # all managed things as a group.
+    # Reset a runtime log configuration for a specific managed thing.
     #
     # @option params [required, String] :managed_thing_id
     #   The id of a managed thing.
@@ -3603,9 +3660,9 @@ module Aws::IoTManagedIntegrations
     #    </note>
     #
     # @option params [String] :trace_id
-    #   The trace request identifier used to correlate a command request and
-    #   response. This is specified by the device owner, but will be generated
-    #   by IoT managed integrations if not provided by the device owner.
+    #   The trace request identifier. This is generated by IoT managed
+    #   integrations and can be used to trace this command and its related
+    #   operations in CloudWatch.
     #
     # @option params [Array<Types::Device>] :devices
     #   The list of devices.
@@ -3802,8 +3859,8 @@ module Aws::IoTManagedIntegrations
 
     # This API is used to start device discovery for hub-connected and
     # third-party-connected devices. The authentication material (install
-    # code) is passed as a message to the controller telling it to start the
-    # discovery.
+    # code) is delivered as a message to the controller instructing it to
+    # start the discovery.
     #
     # @option params [required, String] :discovery_type
     #   The discovery type supporting the type of device to be discovered in
@@ -4054,7 +4111,7 @@ module Aws::IoTManagedIntegrations
       req.send_request(options)
     end
 
-    # Update a destination specified by id.
+    # Update a destination specified by name.
     #
     # @option params [required, String] :name
     #   The name of the customer-managed destination.
@@ -4287,7 +4344,7 @@ module Aws::IoTManagedIntegrations
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-iotmanagedintegrations'
-      context[:gem_version] = '1.11.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -62,6 +62,7 @@ module Aws::IoTManagedIntegrations
     CapabilitySchemaItem = Shapes::StructureShape.new(name: 'CapabilitySchemaItem')
     CapabilitySchemas = Shapes::ListShape.new(name: 'CapabilitySchemas')
     CapabilityVersion = Shapes::StringShape.new(name: 'CapabilityVersion')
+    CertificatePem = Shapes::StringShape.new(name: 'CertificatePem')
     ClaimCertificate = Shapes::StringShape.new(name: 'ClaimCertificate')
     ClaimCertificatePrivateKey = Shapes::StringShape.new(name: 'ClaimCertificatePrivateKey')
     Classification = Shapes::StringShape.new(name: 'Classification')
@@ -215,6 +216,8 @@ module Aws::IoTManagedIntegrations
     GetHubConfigurationResponse = Shapes::StructureShape.new(name: 'GetHubConfigurationResponse')
     GetManagedThingCapabilitiesRequest = Shapes::StructureShape.new(name: 'GetManagedThingCapabilitiesRequest')
     GetManagedThingCapabilitiesResponse = Shapes::StructureShape.new(name: 'GetManagedThingCapabilitiesResponse')
+    GetManagedThingCertificateRequest = Shapes::StructureShape.new(name: 'GetManagedThingCertificateRequest')
+    GetManagedThingCertificateResponse = Shapes::StructureShape.new(name: 'GetManagedThingCertificateResponse')
     GetManagedThingConnectivityDataRequest = Shapes::StructureShape.new(name: 'GetManagedThingConnectivityDataRequest')
     GetManagedThingConnectivityDataResponse = Shapes::StructureShape.new(name: 'GetManagedThingConnectivityDataResponse')
     GetManagedThingMetaDataRequest = Shapes::StructureShape.new(name: 'GetManagedThingMetaDataRequest')
@@ -951,6 +954,13 @@ module Aws::IoTManagedIntegrations
     GetManagedThingCapabilitiesResponse.add_member(:capability_report, Shapes::ShapeRef.new(shape: CapabilityReport, location_name: "CapabilityReport"))
     GetManagedThingCapabilitiesResponse.struct_class = Types::GetManagedThingCapabilitiesResponse
 
+    GetManagedThingCertificateRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: ManagedThingId, required: true, location: "uri", location_name: "Identifier"))
+    GetManagedThingCertificateRequest.struct_class = Types::GetManagedThingCertificateRequest
+
+    GetManagedThingCertificateResponse.add_member(:managed_thing_id, Shapes::ShapeRef.new(shape: ManagedThingId, location_name: "ManagedThingId"))
+    GetManagedThingCertificateResponse.add_member(:certificate_pem, Shapes::ShapeRef.new(shape: CertificatePem, location_name: "CertificatePem"))
+    GetManagedThingCertificateResponse.struct_class = Types::GetManagedThingCertificateResponse
+
     GetManagedThingConnectivityDataRequest.add_member(:identifier, Shapes::ShapeRef.new(shape: ManagedThingId, required: true, location: "uri", location_name: "Identifier"))
     GetManagedThingConnectivityDataRequest.struct_class = Types::GetManagedThingConnectivityDataRequest
 
@@ -1721,6 +1731,7 @@ module Aws::IoTManagedIntegrations
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
@@ -1749,8 +1760,10 @@ module Aws::IoTManagedIntegrations
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
       api.add_operation(:create_credential_locker, Seahorse::Model::Operation.new.tap do |o|
@@ -1891,6 +1904,7 @@ module Aws::IoTManagedIntegrations
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
@@ -2201,6 +2215,21 @@ module Aws::IoTManagedIntegrations
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
+      api.add_operation(:get_managed_thing_certificate, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetManagedThingCertificate"
+        o.http_method = "GET"
+        o.http_request_uri = "/managed-things-certificate/{Identifier}"
+        o.input = Shapes::ShapeRef.new(shape: GetManagedThingCertificateRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetManagedThingCertificateResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+      end)
+
       api.add_operation(:get_managed_thing_connectivity_data, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetManagedThingConnectivityData"
         o.http_method = "POST"
@@ -2857,6 +2886,7 @@ module Aws::IoTManagedIntegrations
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)

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

@@ -1978,6 +1978,31 @@ module Aws::IoTManagedIntegrations
       include Aws::Structure
     end
 
+    # @!attribute [rw] identifier
+    #   The identifier of the managed thing.
+    #   @return [String]
+    #
+    class GetManagedThingCertificateRequest < Struct.new(
+      :identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] managed_thing_id
+    #   The identifier of the managed thing.
+    #   @return [String]
+    #
+    # @!attribute [rw] certificate_pem
+    #   The PEM-encoded certificate for the managed thing.
+    #   @return [String]
+    #
+    class GetManagedThingCertificateResponse < Struct.new(
+      :managed_thing_id,
+      :certificate_pem)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] identifier
     #   The identifier of a managed thing.
     #   @return [String]
@@ -2446,7 +2471,7 @@ module Aws::IoTManagedIntegrations
     #   @return [String]
     #
     # @!attribute [rw] id
-    #   The provisioning profile id..
+    #   The provisioning profile id.
     #   @return [String]
     #
     # @!attribute [rw] claim_certificate
@@ -4414,10 +4439,9 @@ module Aws::IoTManagedIntegrations
     #   @return [String]
     #
     # @!attribute [rw] trace_id
-    #   The trace request identifier used to correlate a command request and
-    #   response. This is specified by the device owner, but will be
-    #   generated by IoT managed integrations if not provided by the device
-    #   owner.
+    #   The trace request identifier. This is generated by IoT managed
+    #   integrations and can be used to trace this command and its related
+    #   operations in CloudWatch.
     #   @return [String]
     #
     # @!attribute [rw] devices
@@ -4483,9 +4507,9 @@ module Aws::IoTManagedIntegrations
     end
 
     # @!attribute [rw] trace_id
-    #   The trace request identifier. This is specified by the device owner,
-    #   but will be generated by IoT managed integrations if not provided by
-    #   the device owner.
+    #   The trace request identifier. This is generated by IoT managed
+    #   integrations and can be used to trace this command and its related
+    #   operations in CloudWatch.
     #   @return [String]
     #
     class SendManagedThingCommandResponse < Struct.new(

data/lib/aws-sdk-iotmanagedintegrations.rb

@@ -54,7 +54,7 @@ module Aws::IoTManagedIntegrations
   autoload :EndpointProvider, 'aws-sdk-iotmanagedintegrations/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-iotmanagedintegrations/endpoints'
 
-  GEM_VERSION = '1.11.0'
+  GEM_VERSION = '1.12.0'
 
 end
 

data/sig/client.rbs

@@ -616,6 +616,17 @@ module Aws
                                           ) -> _GetManagedThingCapabilitiesResponseSuccess
                                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetManagedThingCapabilitiesResponseSuccess
 
+      interface _GetManagedThingCertificateResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::GetManagedThingCertificateResponse]
+        def managed_thing_id: () -> ::String
+        def certificate_pem: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTManagedIntegrations/Client.html#get_managed_thing_certificate-instance_method
+      def get_managed_thing_certificate: (
+                                           identifier: ::String
+                                         ) -> _GetManagedThingCertificateResponseSuccess
+                                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetManagedThingCertificateResponseSuccess
+
       interface _GetManagedThingConnectivityDataResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::GetManagedThingConnectivityDataResponse]
         def managed_thing_id: () -> ::String

data/sig/types.rbs

@@ -597,6 +597,17 @@ module Aws::IoTManagedIntegrations
       SENSITIVE: []
     end
 
+    class GetManagedThingCertificateRequest
+      attr_accessor identifier: ::String
+      SENSITIVE: []
+    end
+
+    class GetManagedThingCertificateResponse
+      attr_accessor managed_thing_id: ::String
+      attr_accessor certificate_pem: ::String
+      SENSITIVE: []
+    end
+
     class GetManagedThingConnectivityDataRequest
       attr_accessor identifier: ::String
       SENSITIVE: []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-iotmanagedintegrations
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Amazon Web Services