aws-sdk-iot 1.157.0 → 1.158.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f493efc48d76220a54cd6294d3875b39dd66e50182dd9651ce05b13101ebc7e7
-  data.tar.gz: a798ee78c816c0ed49b9fc0e61f639302fdd46a26acb7f8c4f767663e4908691
+  metadata.gz: 0e10ebdad95b1a29e3f98d3abb270e9a59120374064441cc1901c9e1a7e1b1c0
+  data.tar.gz: 8267795bd471aeeb16e1e482282f68a222220d6173d31ff598fddfc5c1da1f74
 SHA512:
-  metadata.gz: 5c5a20d0b6553ec8ae0b8f7ee96fc31234dc8bd0f1270f8370738ac542ad6800cbb23af1574ecc4f27bc2993a18ff565a5fca95f9f4dcd7d4da0a264c54ad538
-  data.tar.gz: f73b2aaedfe56b0c89974d6002c4ab5f75bb2c3bfafe4cef1450bfab36080b16ea9aeba6acb79a5dc4278b6cefbd8cf9fe5253fea09137e6f13203ff51f45f39
+  metadata.gz: 135b4face451a2601c09a3d365be7db79a04284e2912ecaf03e8dfe8fb077f648bdf2aaa4ddf84164f73e6df797919f5d3875490e971b46cc0a6ca51c0f13e7b
+  data.tar.gz: 7d8b9997b255b3f4da66633aec1036c11ce87c65208a8dae2e2841ae31c7b548cf21920e829b0c6e44b6d42c88108c784fa0063607d440be6bde3df1bcf69e62

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.158.0 (2025-12-16)
+------------------
+
+* Feature - Add support for dynamic payloads in IoT Device Management Commands
+
 1.157.0 (2025-11-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.157.0
+1.158.0

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

@@ -1589,25 +1589,40 @@ module Aws::IoT
     #   A short text decription of the command.
     #
     # @option params [Types::CommandPayload] :payload
-    #   The payload object for the command. You must specify this information
-    #   when using the `AWS-IoT` namespace.
+    #   The payload object for the static command.
     #
     #   You can upload a static payload file from your local storage that
     #   contains the instructions for the device to process. The payload file
     #   can use any format. To make sure that the device correctly interprets
     #   the payload, we recommend you to specify the payload content type.
     #
+    # @option params [String] :payload_template
+    #   The payload template for the dynamic command.
+    #
+    #   <note markdown="1"> This parameter is required for dynamic commands where the command
+    #   execution placeholders are supplied either from `mandatoryParameters`
+    #   or when `StartCommandExecution` is invoked.
+    #
+    #    </note>
+    #
+    # @option params [Types::CommandPreprocessor] :preprocessor
+    #   Configuration that determines how `payloadTemplate` is processed to
+    #   generate command execution payload.
+    #
+    #   <note markdown="1"> This parameter is required for dynamic commands, along with
+    #   `payloadTemplate`, and `mandatoryParameters`.
+    #
+    #    </note>
+    #
     # @option params [Array<Types::CommandParameter>] :mandatory_parameters
-    #   A list of parameters that are required by the `StartCommandExecution`
-    #   API. These parameters need to be specified only when using the
-    #   `AWS-IoT-FleetWise` namespace. You can either specify them here or
-    #   when running the command using the `StartCommandExecution` API.
+    #   A list of parameters that are used by `StartCommandExecution` API for
+    #   execution payload generation.
     #
     # @option params [String] :role_arn
     #   The IAM role that you must provide when using the `AWS-IoT-FleetWise`
     #   namespace. The role grants IoT Device Management the permission to
     #   access IoT FleetWise resources for generating the payload for the
-    #   command. This field is not required when you use the `AWS-IoT`
+    #   command. This field is not supported when you use the `AWS-IoT`
     #   namespace.
     #
     # @option params [Array<Types::Tag>] :tags
@@ -1629,9 +1644,16 @@ module Aws::IoT
     #       content: "data",
     #       content_type: "MimeType",
     #     },
+    #     payload_template: "CommandPayloadTemplateString",
+    #     preprocessor: {
+    #       aws_json_substitution: {
+    #         output_format: "JSON", # required, accepts JSON, CBOR
+    #       },
+    #     },
     #     mandatory_parameters: [
     #       {
     #         name: "CommandParameterName", # required
+    #         type: "STRING", # accepts STRING, INTEGER, DOUBLE, LONG, UNSIGNEDLONG, BOOLEAN, BINARY
     #         value: {
     #           s: "StringParameterValue",
     #           b: false,
@@ -1650,6 +1672,21 @@ module Aws::IoT
     #           bin: "data",
     #           ul: "UnsignedLongParameterValue",
     #         },
+    #         value_conditions: [
+    #           {
+    #             comparison_operator: "EQUALS", # required, accepts EQUALS, NOT_EQUALS, LESS_THAN, LESS_THAN_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, IN_SET, NOT_IN_SET, IN_RANGE, NOT_IN_RANGE
+    #             operand: { # required
+    #               number: "StringParameterValue",
+    #               numbers: ["StringParameterValue"],
+    #               string: "StringParameterValue",
+    #               strings: ["StringParameterValue"],
+    #               number_range: {
+    #                 min: "StringParameterValue", # required
+    #                 max: "StringParameterValue", # required
+    #               },
+    #             },
+    #           },
+    #         ],
     #         description: "CommandParameterDescription",
     #       },
     #     ],
@@ -6377,12 +6414,12 @@ module Aws::IoT
 
     # Retrieves the encryption configuration for resources and data of your
     # Amazon Web Services account in Amazon Web Services IoT Core. For more
-    # information, see [Key management in IoT][1] from the *Amazon Web
+    # information, see [Data encryption at rest][1] in the *Amazon Web
     # Services IoT Core Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/iot/latest/developerguide/key-management.html
+    # [1]: https://docs.aws.amazon.com/iot/latest/developerguide/encryption-at-rest.html
     #
     # @return [Types::DescribeEncryptionConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -7845,6 +7882,8 @@ module Aws::IoT
     #   * {Types::GetCommandResponse#description #description} => String
     #   * {Types::GetCommandResponse#mandatory_parameters #mandatory_parameters} => Array&lt;Types::CommandParameter&gt;
     #   * {Types::GetCommandResponse#payload #payload} => Types::CommandPayload
+    #   * {Types::GetCommandResponse#payload_template #payload_template} => String
+    #   * {Types::GetCommandResponse#preprocessor #preprocessor} => Types::CommandPreprocessor
     #   * {Types::GetCommandResponse#role_arn #role_arn} => String
     #   * {Types::GetCommandResponse#created_at #created_at} => Time
     #   * {Types::GetCommandResponse#last_updated_at #last_updated_at} => Time
@@ -7866,6 +7905,7 @@ module Aws::IoT
     #   resp.description #=> String
     #   resp.mandatory_parameters #=> Array
     #   resp.mandatory_parameters[0].name #=> String
+    #   resp.mandatory_parameters[0].type #=> String, one of "STRING", "INTEGER", "DOUBLE", "LONG", "UNSIGNEDLONG", "BOOLEAN", "BINARY"
     #   resp.mandatory_parameters[0].value.s #=> String
     #   resp.mandatory_parameters[0].value.b #=> Boolean
     #   resp.mandatory_parameters[0].value.i #=> Integer
@@ -7880,9 +7920,21 @@ module Aws::IoT
     #   resp.mandatory_parameters[0].default_value.d #=> Float
     #   resp.mandatory_parameters[0].default_value.bin #=> String
     #   resp.mandatory_parameters[0].default_value.ul #=> String
+    #   resp.mandatory_parameters[0].value_conditions #=> Array
+    #   resp.mandatory_parameters[0].value_conditions[0].comparison_operator #=> String, one of "EQUALS", "NOT_EQUALS", "LESS_THAN", "LESS_THAN_EQUALS", "GREATER_THAN", "GREATER_THAN_EQUALS", "IN_SET", "NOT_IN_SET", "IN_RANGE", "NOT_IN_RANGE"
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.number #=> String
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.numbers #=> Array
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.numbers[0] #=> String
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.string #=> String
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.strings #=> Array
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.strings[0] #=> String
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.number_range.min #=> String
+    #   resp.mandatory_parameters[0].value_conditions[0].operand.number_range.max #=> String
     #   resp.mandatory_parameters[0].description #=> String
     #   resp.payload.content #=> String
     #   resp.payload.content_type #=> String
+    #   resp.payload_template #=> String
+    #   resp.preprocessor.aws_json_substitution.output_format #=> String, one of "JSON", "CBOR"
     #   resp.role_arn #=> String
     #   resp.created_at #=> Time
     #   resp.last_updated_at #=> Time
@@ -14233,9 +14285,8 @@ module Aws::IoT
     #
     # @option params [String] :principal
     #   The principal. Valid principals are CertificateArn
-    #   (arn:aws:iot:*region*:*accountId*:cert/*certificateId*), thingGroupArn
-    #   (arn:aws:iot:*region*:*accountId*:thinggroup/*groupName*) and
-    #   CognitoId (*region*:*id*).
+    #   (arn:aws:iot:*region*:*accountId*:cert/*certificateId*) and CognitoId
+    #   (*region*:*id*).
     #
     # @option params [String] :cognito_identity_pool_id
     #   The Cognito identity pool ID.
@@ -14381,10 +14432,10 @@ module Aws::IoT
     #
     # Requires permission to access the [TransferCertificate][1] action.
     #
-    # You can cancel the transfer until it is acknowledged by the recipient.
+    # You can cancel the transfer until it is accepted by the recipient.
     #
-    # No notification is sent to the transfer destination's account. It's
-    # up to the caller to notify the transfer target.
+    # No notification is sent to the transfer destination's account. The
+    # caller is responsible for notifying the transfer target.
     #
     # The certificate being transferred must not be in the `ACTIVE` state.
     # You can use the UpdateCertificate action to deactivate it.
@@ -14393,15 +14444,16 @@ module Aws::IoT
     # the DetachPolicy action to detach them.
     #
     # **Customer managed key behavior:** When you use a customer managed key
-    # to secure your data and then transfer the key to a customer in a
-    # different account using the TransferCertificate operation, the
-    # certificates will no longer be protected by their customer managed key
+    # to encrypt your data and then transfer the certificate to a customer
+    # in a different account using the `TransferCertificate` operation, the
+    # certificates will no longer be encrypted by their customer managed key
     # configuration. During the transfer process, certificates are encrypted
-    # using IoT owned keys.
+    # using Amazon Web Services IoT Core owned keys.
     #
     # While a certificate is in the **PENDING\_TRANSFER** state, it's
-    # always protected by IoT owned keys, regardless of the customer managed
-    # key configuration of either the source or destination account.
+    # always protected by Amazon Web Services IoT Core owned keys,
+    # regardless of the customer managed key configuration of either the
+    # source or destination account.
     #
     # Once the transfer is completed through AcceptCertificateTransfer,
     # RejectCertificateTransfer, or CancelCertificateTransfer, the
@@ -14409,8 +14461,8 @@ module Aws::IoT
     # configuration of the account that owns the certificate after the
     # transfer operation:
     #
-    # * If the transfer is accepted: The certificate is protected by the
-    #   destination account's customer managed key configuration.
+    # * If the transfer is accepted: The certificate is encrypted by the
+    #   target account's customer managed key configuration.
     #
     # * If the transfer is rejected or cancelled: The certificate is
     #   protected by the source account's customer managed key
@@ -15208,24 +15260,27 @@ module Aws::IoT
       req.send_request(options)
     end
 
-    # Updates the encryption configuration. By default, all Amazon Web
-    # Services IoT Core data at rest is encrypted using Amazon Web Services
-    # owned keys. Amazon Web Services IoT Core also supports symmetric
-    # customer managed keys from Amazon Web Services Key Management Service
-    # (KMS). With customer managed keys, you create, own, and manage the KMS
-    # keys in your Amazon Web Services account. For more information, see
-    # [Data encryption][1] in the *Amazon Web Services IoT Core Developer
+    # Updates the encryption configuration. By default, Amazon Web Services
+    # IoT Core encrypts your data at rest using Amazon Web Services owned
+    # keys. Amazon Web Services IoT Core also supports symmetric customer
+    # managed keys from Key Management Service (KMS). With customer managed
+    # keys, you create, own, and manage the KMS keys in your Amazon Web
+    # Services account.
+    #
+    # Before using this API, you must set up permissions for Amazon Web
+    # Services IoT Core to access KMS. For more information, see [Data
+    # encryption at rest][1] in the *Amazon Web Services IoT Core Developer
     # Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/iot/latest/developerguide/data-encryption.html
+    # [1]: https://docs.aws.amazon.com/iot/latest/developerguide/encryption-at-rest.html
     #
     # @option params [required, String] :encryption_type
-    #   The type of the Amazon Web Services Key Management Service (KMS) key.
+    #   The type of the KMS key.
     #
     # @option params [String] :kms_key_arn
-    #   The ARN of the customer-managed KMS key.
+    #   The ARN of the customer managedKMS key.
     #
     # @option params [String] :kms_access_role_arn
     #   The Amazon Resource Name (ARN) of the IAM role assumed by Amazon Web
@@ -16546,7 +16601,7 @@ module Aws::IoT
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-iot'
-      context[:gem_version] = '1.157.0'
+      context[:gem_version] = '1.158.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -149,6 +149,7 @@ module Aws::IoT
     AwsJobRolloutRatePerMinute = Shapes::IntegerShape.new(name: 'AwsJobRolloutRatePerMinute')
     AwsJobTimeoutConfig = Shapes::StructureShape.new(name: 'AwsJobTimeoutConfig')
     AwsJobTimeoutInProgressTimeoutInMinutes = Shapes::IntegerShape.new(name: 'AwsJobTimeoutInProgressTimeoutInMinutes')
+    AwsJsonSubstitutionCommandPreprocessorConfig = Shapes::StructureShape.new(name: 'AwsJsonSubstitutionCommandPreprocessorConfig')
     BatchMode = Shapes::BooleanShape.new(name: 'BatchMode')
     BeforeSubstitutionFlag = Shapes::BooleanShape.new(name: 'BeforeSubstitutionFlag')
     Behavior = Shapes::StructureShape.new(name: 'Behavior')
@@ -258,9 +259,18 @@ module Aws::IoT
     CommandParameterDescription = Shapes::StringShape.new(name: 'CommandParameterDescription')
     CommandParameterList = Shapes::ListShape.new(name: 'CommandParameterList')
     CommandParameterName = Shapes::StringShape.new(name: 'CommandParameterName')
+    CommandParameterType = Shapes::StringShape.new(name: 'CommandParameterType')
     CommandParameterValue = Shapes::StructureShape.new(name: 'CommandParameterValue')
+    CommandParameterValueComparisonOperand = Shapes::StructureShape.new(name: 'CommandParameterValueComparisonOperand')
+    CommandParameterValueComparisonOperator = Shapes::StringShape.new(name: 'CommandParameterValueComparisonOperator')
+    CommandParameterValueCondition = Shapes::StructureShape.new(name: 'CommandParameterValueCondition')
+    CommandParameterValueConditionList = Shapes::ListShape.new(name: 'CommandParameterValueConditionList')
+    CommandParameterValueNumberRange = Shapes::StructureShape.new(name: 'CommandParameterValueNumberRange')
+    CommandParameterValueStringList = Shapes::ListShape.new(name: 'CommandParameterValueStringList')
     CommandPayload = Shapes::StructureShape.new(name: 'CommandPayload')
     CommandPayloadBlob = Shapes::BlobShape.new(name: 'CommandPayloadBlob')
+    CommandPayloadTemplateString = Shapes::StringShape.new(name: 'CommandPayloadTemplateString')
+    CommandPreprocessor = Shapes::StructureShape.new(name: 'CommandPreprocessor')
     CommandSummary = Shapes::StructureShape.new(name: 'CommandSummary')
     CommandSummaryList = Shapes::ListShape.new(name: 'CommandSummaryList')
     Comment = Shapes::StringShape.new(name: 'Comment')
@@ -991,6 +1001,7 @@ module Aws::IoT
     OptionalVersion = Shapes::IntegerShape.new(name: 'OptionalVersion')
     OutgoingCertificate = Shapes::StructureShape.new(name: 'OutgoingCertificate')
     OutgoingCertificates = Shapes::ListShape.new(name: 'OutgoingCertificates')
+    OutputFormat = Shapes::StringShape.new(name: 'OutputFormat')
     OverrideDynamicGroups = Shapes::BooleanShape.new(name: 'OverrideDynamicGroups')
     PackageArn = Shapes::StringShape.new(name: 'PackageArn')
     PackageCatalogMaxResults = Shapes::IntegerShape.new(name: 'PackageCatalogMaxResults')
@@ -1819,6 +1830,9 @@ module Aws::IoT
     AwsJobTimeoutConfig.add_member(:in_progress_timeout_in_minutes, Shapes::ShapeRef.new(shape: AwsJobTimeoutInProgressTimeoutInMinutes, location_name: "inProgressTimeoutInMinutes"))
     AwsJobTimeoutConfig.struct_class = Types::AwsJobTimeoutConfig
 
+    AwsJsonSubstitutionCommandPreprocessorConfig.add_member(:output_format, Shapes::ShapeRef.new(shape: OutputFormat, required: true, location_name: "outputFormat"))
+    AwsJsonSubstitutionCommandPreprocessorConfig.struct_class = Types::AwsJsonSubstitutionCommandPreprocessorConfig
+
     Behavior.add_member(:name, Shapes::ShapeRef.new(shape: BehaviorName, required: true, location_name: "name"))
     Behavior.add_member(:metric, Shapes::ShapeRef.new(shape: BehaviorMetric, location_name: "metric"))
     Behavior.add_member(:metric_dimension, Shapes::ShapeRef.new(shape: MetricDimension, location_name: "metricDimension"))
@@ -2038,8 +2052,10 @@ module Aws::IoT
     CommandExecutionSummaryList.member = Shapes::ShapeRef.new(shape: CommandExecutionSummary)
 
     CommandParameter.add_member(:name, Shapes::ShapeRef.new(shape: CommandParameterName, required: true, location_name: "name"))
+    CommandParameter.add_member(:type, Shapes::ShapeRef.new(shape: CommandParameterType, location_name: "type"))
     CommandParameter.add_member(:value, Shapes::ShapeRef.new(shape: CommandParameterValue, location_name: "value"))
     CommandParameter.add_member(:default_value, Shapes::ShapeRef.new(shape: CommandParameterValue, location_name: "defaultValue"))
+    CommandParameter.add_member(:value_conditions, Shapes::ShapeRef.new(shape: CommandParameterValueConditionList, location_name: "valueConditions"))
     CommandParameter.add_member(:description, Shapes::ShapeRef.new(shape: CommandParameterDescription, location_name: "description"))
     CommandParameter.struct_class = Types::CommandParameter
 
@@ -2054,10 +2070,32 @@ module Aws::IoT
     CommandParameterValue.add_member(:ul, Shapes::ShapeRef.new(shape: UnsignedLongParameterValue, location_name: "UL"))
     CommandParameterValue.struct_class = Types::CommandParameterValue
 
+    CommandParameterValueComparisonOperand.add_member(:number, Shapes::ShapeRef.new(shape: StringParameterValue, location_name: "number"))
+    CommandParameterValueComparisonOperand.add_member(:numbers, Shapes::ShapeRef.new(shape: CommandParameterValueStringList, location_name: "numbers"))
+    CommandParameterValueComparisonOperand.add_member(:string, Shapes::ShapeRef.new(shape: StringParameterValue, location_name: "string"))
+    CommandParameterValueComparisonOperand.add_member(:strings, Shapes::ShapeRef.new(shape: CommandParameterValueStringList, location_name: "strings"))
+    CommandParameterValueComparisonOperand.add_member(:number_range, Shapes::ShapeRef.new(shape: CommandParameterValueNumberRange, location_name: "numberRange"))
+    CommandParameterValueComparisonOperand.struct_class = Types::CommandParameterValueComparisonOperand
+
+    CommandParameterValueCondition.add_member(:comparison_operator, Shapes::ShapeRef.new(shape: CommandParameterValueComparisonOperator, required: true, location_name: "comparisonOperator"))
+    CommandParameterValueCondition.add_member(:operand, Shapes::ShapeRef.new(shape: CommandParameterValueComparisonOperand, required: true, location_name: "operand"))
+    CommandParameterValueCondition.struct_class = Types::CommandParameterValueCondition
+
+    CommandParameterValueConditionList.member = Shapes::ShapeRef.new(shape: CommandParameterValueCondition)
+
+    CommandParameterValueNumberRange.add_member(:min, Shapes::ShapeRef.new(shape: StringParameterValue, required: true, location_name: "min"))
+    CommandParameterValueNumberRange.add_member(:max, Shapes::ShapeRef.new(shape: StringParameterValue, required: true, location_name: "max"))
+    CommandParameterValueNumberRange.struct_class = Types::CommandParameterValueNumberRange
+
+    CommandParameterValueStringList.member = Shapes::ShapeRef.new(shape: StringParameterValue)
+
     CommandPayload.add_member(:content, Shapes::ShapeRef.new(shape: CommandPayloadBlob, location_name: "content"))
     CommandPayload.add_member(:content_type, Shapes::ShapeRef.new(shape: MimeType, location_name: "contentType"))
     CommandPayload.struct_class = Types::CommandPayload
 
+    CommandPreprocessor.add_member(:aws_json_substitution, Shapes::ShapeRef.new(shape: AwsJsonSubstitutionCommandPreprocessorConfig, location_name: "awsJsonSubstitution"))
+    CommandPreprocessor.struct_class = Types::CommandPreprocessor
+
     CommandSummary.add_member(:command_arn, Shapes::ShapeRef.new(shape: CommandArn, location_name: "commandArn"))
     CommandSummary.add_member(:command_id, Shapes::ShapeRef.new(shape: CommandId, location_name: "commandId"))
     CommandSummary.add_member(:display_name, Shapes::ShapeRef.new(shape: DisplayName, location_name: "displayName"))
@@ -2148,6 +2186,8 @@ module Aws::IoT
     CreateCommandRequest.add_member(:display_name, Shapes::ShapeRef.new(shape: DisplayName, location_name: "displayName"))
     CreateCommandRequest.add_member(:description, Shapes::ShapeRef.new(shape: CommandDescription, location_name: "description"))
     CreateCommandRequest.add_member(:payload, Shapes::ShapeRef.new(shape: CommandPayload, location_name: "payload"))
+    CreateCommandRequest.add_member(:payload_template, Shapes::ShapeRef.new(shape: CommandPayloadTemplateString, location_name: "payloadTemplate"))
+    CreateCommandRequest.add_member(:preprocessor, Shapes::ShapeRef.new(shape: CommandPreprocessor, location_name: "preprocessor"))
     CreateCommandRequest.add_member(:mandatory_parameters, Shapes::ShapeRef.new(shape: CommandParameterList, location_name: "mandatoryParameters"))
     CreateCommandRequest.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "roleArn"))
     CreateCommandRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "tags"))
@@ -3305,6 +3345,8 @@ module Aws::IoT
     GetCommandResponse.add_member(:description, Shapes::ShapeRef.new(shape: CommandDescription, location_name: "description"))
     GetCommandResponse.add_member(:mandatory_parameters, Shapes::ShapeRef.new(shape: CommandParameterList, location_name: "mandatoryParameters"))
     GetCommandResponse.add_member(:payload, Shapes::ShapeRef.new(shape: CommandPayload, location_name: "payload"))
+    GetCommandResponse.add_member(:payload_template, Shapes::ShapeRef.new(shape: CommandPayloadTemplateString, location_name: "payloadTemplate"))
+    GetCommandResponse.add_member(:preprocessor, Shapes::ShapeRef.new(shape: CommandPreprocessor, location_name: "preprocessor"))
     GetCommandResponse.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleArn, location_name: "roleArn"))
     GetCommandResponse.add_member(:created_at, Shapes::ShapeRef.new(shape: DateType, location_name: "createdAt"))
     GetCommandResponse.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: DateType, location_name: "lastUpdatedAt"))

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

@@ -1357,6 +1357,22 @@ module Aws::IoT
       include Aws::Structure
     end
 
+    # Configures the command to treat the `payloadTemplate` as a JSON
+    # document for preprocessing. This preprocessor substitutes placeholders
+    # with parameter values to generate the command execution request
+    # payload.
+    #
+    # @!attribute [rw] output_format
+    #   Converts the command preprocessor result to the format defined by
+    #   this parameter, before sending it to the device.
+    #   @return [String]
+    #
+    class AwsJsonSubstitutionCommandPreprocessorConfig < Struct.new(
+      :output_format)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A Device Defender security profile behavior.
     #
     # @!attribute [rw] name
@@ -2299,10 +2315,12 @@ module Aws::IoT
     #   execution.
     #   @return [String]
     #
+    # @!attribute [rw] type
+    #   The type of the command parameter.
+    #   @return [String]
+    #
     # @!attribute [rw] value
-    #   The value used to describe the command. When you assign a value to a
-    #   parameter, it will override any default value that you had already
-    #   specified.
+    #   Parameter value that overrides the default value, if set.
     #   @return [Types::CommandParameterValue]
     #
     # @!attribute [rw] default_value
@@ -2310,21 +2328,27 @@ module Aws::IoT
     #   assumed by the parameter if no other value is assigned to it.
     #   @return [Types::CommandParameterValue]
     #
+    # @!attribute [rw] value_conditions
+    #   The list of conditions that a command parameter value must satisfy
+    #   to create a command execution.
+    #   @return [Array<Types::CommandParameterValueCondition>]
+    #
     # @!attribute [rw] description
     #   The description of the command parameter.
     #   @return [String]
     #
     class CommandParameter < Struct.new(
       :name,
+      :type,
       :value,
       :default_value,
+      :value_conditions,
       :description)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # The range of possible values that's used to describe a specific
-    # command parameter.
+    # The value of a command parameter used to create a command execution.
     #
     # <note markdown="1"> The `commandParameterValue` can only have one of the below fields
     # listed.
@@ -2377,6 +2401,79 @@ module Aws::IoT
       include Aws::Structure
     end
 
+    # The comparison operand used to compare the defined value against the
+    # value supplied in request.
+    #
+    # @!attribute [rw] number
+    #   An operand of number value type, defined as a string.
+    #   @return [String]
+    #
+    # @!attribute [rw] numbers
+    #   A List of operands of numerical value type, defined as strings.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] string
+    #   An operand of string value type.
+    #   @return [String]
+    #
+    # @!attribute [rw] strings
+    #   A List of operands of string value type.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] number_range
+    #   An operand of numerical range value type.
+    #   @return [Types::CommandParameterValueNumberRange]
+    #
+    class CommandParameterValueComparisonOperand < Struct.new(
+      :number,
+      :numbers,
+      :string,
+      :strings,
+      :number_range)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A condition for the command parameter that must be evaluated to true
+    # for successful creation of a command execution.
+    #
+    # @!attribute [rw] comparison_operator
+    #   The comparison operator for the command parameter.
+    #
+    #   <note markdown="1"> IN\_RANGE, and NOT\_IN\_RANGE operators include boundary values.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] operand
+    #   The comparison operand for the command parameter.
+    #   @return [Types::CommandParameterValueComparisonOperand]
+    #
+    class CommandParameterValueCondition < Struct.new(
+      :comparison_operator,
+      :operand)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The numerical range value type to compare a command parameter value
+    # against.
+    #
+    # @!attribute [rw] min
+    #   The minimum value of a numerical range of a command parameter value.
+    #   @return [String]
+    #
+    # @!attribute [rw] max
+    #   The maximum value of a numerical range of a command parameter value.
+    #   @return [String]
+    #
+    class CommandParameterValueNumberRange < Struct.new(
+      :min,
+      :max)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The command payload object that contains the instructions for the
     # device to process.
     #
@@ -2402,6 +2499,20 @@ module Aws::IoT
       include Aws::Structure
     end
 
+    # Configuration that determines how the `payloadTemplate` is processed
+    # by the service to generate the final payload sent to devices at
+    # `StartCommandExecution` API invocation.
+    #
+    # @!attribute [rw] aws_json_substitution
+    #   Configuration for the JSON substitution preprocessor.
+    #   @return [Types::AwsJsonSubstitutionCommandPreprocessorConfig]
+    #
+    class CommandPreprocessor < Struct.new(
+      :aws_json_substitution)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary information about a particular command resource.
     #
     # @!attribute [rw] command_arn
@@ -2457,13 +2568,13 @@ module Aws::IoT
     end
 
     # The encryption configuration details that include the status
-    # information of the Amazon Web Services Key Management Service (KMS)
-    # key and the KMS access role.
+    # information of the Key Management Service (KMS) key and the KMS access
+    # role.
     #
     # @!attribute [rw] configuration_status
     #   The health status of KMS key and KMS access role. If either KMS key
     #   or KMS access role is `UNHEALTHY`, the return value will be
-    #   `UNHEALTHY`. To use a customer-managed KMS key, the value of
+    #   `UNHEALTHY`. To use a customer managed KMS key, the value of
     #   `configurationStatus` must be `HEALTHY`.
     #   @return [String]
     #
@@ -2811,8 +2922,7 @@ module Aws::IoT
     #   @return [String]
     #
     # @!attribute [rw] payload
-    #   The payload object for the command. You must specify this
-    #   information when using the `AWS-IoT` namespace.
+    #   The payload object for the static command.
     #
     #   You can upload a static payload file from your local storage that
     #   contains the instructions for the device to process. The payload
@@ -2821,20 +2931,37 @@ module Aws::IoT
     #   content type.
     #   @return [Types::CommandPayload]
     #
+    # @!attribute [rw] payload_template
+    #   The payload template for the dynamic command.
+    #
+    #   <note markdown="1"> This parameter is required for dynamic commands where the command
+    #   execution placeholders are supplied either from
+    #   `mandatoryParameters` or when `StartCommandExecution` is invoked.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @!attribute [rw] preprocessor
+    #   Configuration that determines how `payloadTemplate` is processed to
+    #   generate command execution payload.
+    #
+    #   <note markdown="1"> This parameter is required for dynamic commands, along with
+    #   `payloadTemplate`, and `mandatoryParameters`.
+    #
+    #    </note>
+    #   @return [Types::CommandPreprocessor]
+    #
     # @!attribute [rw] mandatory_parameters
-    #   A list of parameters that are required by the
-    #   `StartCommandExecution` API. These parameters need to be specified
-    #   only when using the `AWS-IoT-FleetWise` namespace. You can either
-    #   specify them here or when running the command using the
-    #   `StartCommandExecution` API.
+    #   A list of parameters that are used by `StartCommandExecution` API
+    #   for execution payload generation.
     #   @return [Array<Types::CommandParameter>]
     #
     # @!attribute [rw] role_arn
     #   The IAM role that you must provide when using the
     #   `AWS-IoT-FleetWise` namespace. The role grants IoT Device Management
     #   the permission to access IoT FleetWise resources for generating the
-    #   payload for the command. This field is not required when you use the
-    #   `AWS-IoT` namespace.
+    #   payload for the command. This field is not supported when you use
+    #   the `AWS-IoT` namespace.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -2847,6 +2974,8 @@ module Aws::IoT
       :display_name,
       :description,
       :payload,
+      :payload_template,
+      :preprocessor,
       :mandatory_parameters,
       :role_arn,
       :tags)
@@ -6123,17 +6252,16 @@ module Aws::IoT
     class DescribeEncryptionConfigurationRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] encryption_type
-    #   The type of the Amazon Web Services Key Management Service (KMS)
-    #   key.
+    #   The type of the KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The Amazon Resource Name (ARN) of the IAM role assumed by Amazon Web
-    #   Services IoT Core to call KMS on behalf of the customer.
+    #   The ARN of the customer managed KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_access_role_arn
-    #   The ARN of the customer-managed KMS key.
+    #   The Amazon Resource Name (ARN) of the IAM role assumed by Amazon Web
+    #   Services IoT Core to call KMS on behalf of the customer.
     #   @return [String]
     #
     # @!attribute [rw] configuration_details
@@ -8223,6 +8351,15 @@ module Aws::IoT
     #   The payload object that you provided for the command.
     #   @return [Types::CommandPayload]
     #
+    # @!attribute [rw] payload_template
+    #   The payload template for the dynamic command.
+    #   @return [String]
+    #
+    # @!attribute [rw] preprocessor
+    #   Configuration that determines how `payloadTemplate` is processed to
+    #   generate command execution payload.
+    #   @return [Types::CommandPreprocessor]
+    #
     # @!attribute [rw] role_arn
     #   The IAM role that you provided when creating the command with
     #   `AWS-IoT-FleetWise` as the namespace.
@@ -8252,6 +8389,8 @@ module Aws::IoT
       :description,
       :mandatory_parameters,
       :payload,
+      :payload_template,
+      :preprocessor,
       :role_arn,
       :created_at,
       :last_updated_at,
@@ -15975,9 +16114,7 @@ module Aws::IoT
 
     # @!attribute [rw] principal
     #   The principal. Valid principals are CertificateArn
-    #   (arn:aws:iot:*region*:*accountId*:cert/*certificateId*),
-    #   thingGroupArn
-    #   (arn:aws:iot:*region*:*accountId*:thinggroup/*groupName*) and
+    #   (arn:aws:iot:*region*:*accountId*:cert/*certificateId*) and
     #   CognitoId (*region*:*id*).
     #   @return [String]
     #
@@ -17783,12 +17920,11 @@ module Aws::IoT
     end
 
     # @!attribute [rw] encryption_type
-    #   The type of the Amazon Web Services Key Management Service (KMS)
-    #   key.
+    #   The type of the KMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_key_arn
-    #   The ARN of the customer-managed KMS key.
+    #   The ARN of the customer managedKMS key.
     #   @return [String]
     #
     # @!attribute [rw] kms_access_role_arn

data/lib/aws-sdk-iot.rb

@@ -54,7 +54,7 @@ module Aws::IoT
   autoload :EndpointProvider, 'aws-sdk-iot/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-iot/endpoints'
 
-  GEM_VERSION = '1.157.0'
+  GEM_VERSION = '1.158.0'
 
 end
 

data/sig/client.rbs

@@ -381,9 +381,16 @@ module Aws
                               content: ::String?,
                               content_type: ::String?
                             },
+                            ?payload_template: ::String,
+                            ?preprocessor: {
+                              aws_json_substitution: {
+                                output_format: ("JSON" | "CBOR")
+                              }?
+                            },
                             ?mandatory_parameters: Array[
                               {
                                 name: ::String,
+                                type: ("STRING" | "INTEGER" | "DOUBLE" | "LONG" | "UNSIGNEDLONG" | "BOOLEAN" | "BINARY")?,
                                 value: {
                                   s: ::String?,
                                   b: bool?,
@@ -402,6 +409,21 @@ module Aws
                                   bin: ::String?,
                                   ul: ::String?
                                 }?,
+                                value_conditions: Array[
+                                  {
+                                    comparison_operator: ("EQUALS" | "NOT_EQUALS" | "LESS_THAN" | "LESS_THAN_EQUALS" | "GREATER_THAN" | "GREATER_THAN_EQUALS" | "IN_SET" | "NOT_IN_SET" | "IN_RANGE" | "NOT_IN_RANGE"),
+                                    operand: {
+                                      number: ::String?,
+                                      numbers: Array[::String]?,
+                                      string: ::String?,
+                                      strings: Array[::String]?,
+                                      number_range: {
+                                        min: ::String,
+                                        max: ::String
+                                      }?
+                                    }
+                                  },
+                                ]?,
                                 description: ::String?
                               },
                             ],
@@ -2619,6 +2641,8 @@ module Aws
         def description: () -> ::String
         def mandatory_parameters: () -> ::Array[Types::CommandParameter]
         def payload: () -> Types::CommandPayload
+        def payload_template: () -> ::String
+        def preprocessor: () -> Types::CommandPreprocessor
         def role_arn: () -> ::String
         def created_at: () -> ::Time
         def last_updated_at: () -> ::Time

data/sig/types.rbs

@@ -368,6 +368,11 @@ module Aws::IoT
       SENSITIVE: []
     end
 
+    class AwsJsonSubstitutionCommandPreprocessorConfig
+      attr_accessor output_format: ("JSON" | "CBOR")
+      SENSITIVE: []
+    end
+
     class Behavior
       attr_accessor name: ::String
       attr_accessor metric: ::String
@@ -625,8 +630,10 @@ module Aws::IoT
 
     class CommandParameter
       attr_accessor name: ::String
+      attr_accessor type: ("STRING" | "INTEGER" | "DOUBLE" | "LONG" | "UNSIGNEDLONG" | "BOOLEAN" | "BINARY")
       attr_accessor value: Types::CommandParameterValue
       attr_accessor default_value: Types::CommandParameterValue
+      attr_accessor value_conditions: ::Array[Types::CommandParameterValueCondition]
       attr_accessor description: ::String
       SENSITIVE: []
     end
@@ -642,12 +649,38 @@ module Aws::IoT
       SENSITIVE: []
     end
 
+    class CommandParameterValueComparisonOperand
+      attr_accessor number: ::String
+      attr_accessor numbers: ::Array[::String]
+      attr_accessor string: ::String
+      attr_accessor strings: ::Array[::String]
+      attr_accessor number_range: Types::CommandParameterValueNumberRange
+      SENSITIVE: []
+    end
+
+    class CommandParameterValueCondition
+      attr_accessor comparison_operator: ("EQUALS" | "NOT_EQUALS" | "LESS_THAN" | "LESS_THAN_EQUALS" | "GREATER_THAN" | "GREATER_THAN_EQUALS" | "IN_SET" | "NOT_IN_SET" | "IN_RANGE" | "NOT_IN_RANGE")
+      attr_accessor operand: Types::CommandParameterValueComparisonOperand
+      SENSITIVE: []
+    end
+
+    class CommandParameterValueNumberRange
+      attr_accessor min: ::String
+      attr_accessor max: ::String
+      SENSITIVE: []
+    end
+
     class CommandPayload
       attr_accessor content: ::String
       attr_accessor content_type: ::String
       SENSITIVE: []
     end
 
+    class CommandPreprocessor
+      attr_accessor aws_json_substitution: Types::AwsJsonSubstitutionCommandPreprocessorConfig
+      SENSITIVE: []
+    end
+
     class CommandSummary
       attr_accessor command_arn: ::String
       attr_accessor command_id: ::String
@@ -769,6 +802,8 @@ module Aws::IoT
       attr_accessor display_name: ::String
       attr_accessor description: ::String
       attr_accessor payload: Types::CommandPayload
+      attr_accessor payload_template: ::String
+      attr_accessor preprocessor: Types::CommandPreprocessor
       attr_accessor mandatory_parameters: ::Array[Types::CommandParameter]
       attr_accessor role_arn: ::String
       attr_accessor tags: ::Array[Types::Tag]
@@ -2315,6 +2350,8 @@ module Aws::IoT
       attr_accessor description: ::String
       attr_accessor mandatory_parameters: ::Array[Types::CommandParameter]
       attr_accessor payload: Types::CommandPayload
+      attr_accessor payload_template: ::String
+      attr_accessor preprocessor: Types::CommandPreprocessor
       attr_accessor role_arn: ::String
       attr_accessor created_at: ::Time
       attr_accessor last_updated_at: ::Time

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-iot
 version: !ruby/object:Gem::Version
-  version: 1.157.0
+  version: 1.158.0
 platform: ruby
 authors:
 - Amazon Web Services