aws-sdk-iot 1.139.0 → 1.140.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0a90d0dc0dc9d4c7cc38efdbff2fd137c6a0966f53ab4365d55853b89a2c729f
4
- data.tar.gz: 53e8bcf23f214470b0e62b04b7e3d467f7ae31e18df3c461e21c52e2bac6e2fe
3
+ metadata.gz: 18ed550997651dc40a4b02646548042373efe25728d0dd6740d9ddcfdfab9865
4
+ data.tar.gz: 85b773dfc422142b20c81835bdfbb277f67ca16e7dd44bf74cee177624bceca1
5
5
  SHA512:
6
- metadata.gz: 8f5d367bf90d10ecd5117b515ae57e37d0172b61e5aa5147d9ebbc4966294ccfba1aab5ca1a9d389480cdbab189e3ee510503b90478bd15da89bb83b22667a3d
7
- data.tar.gz: 46843aa8b6b42abd7061c6a3404762021596138f1cd161e6961defa74e967dc134b2c6255703613e570ca3370470d216fc88da58dcaafa7487c2ee64232a0094
6
+ metadata.gz: 12e6cdc2862247a8a4aa4b803ed408a561c77d645c6eafb34e2bda8dd48e36d281dc6c1c47e6ddd7654220c113ae068be840635b49bb09761396224334bbe1da
7
+ data.tar.gz: e4b3f472a45de41d0658b292363ba8b12a52ad9f3f1bcf5fcc7a718153fa3fbb40cfea565a81f422c3a45c491d2b2ac0da78efcd0d42eaf4dd4fdf19ef8eaa3f
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.140.0 (2024-11-21)
5
+ ------------------
6
+
7
+ * Feature - General Availability (GA) release of AWS IoT Device Management - Commands, to trigger light-weight remote actions on targeted devices
8
+
4
9
  1.139.0 (2024-11-15)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.139.0
1
+ 1.140.0
@@ -1538,6 +1538,109 @@ module Aws::IoT
1538
1538
  req.send_request(options)
1539
1539
  end
1540
1540
 
1541
+ # Creates a command. A command contains reusable configurations that can
1542
+ # be applied before they are sent to the devices.
1543
+ #
1544
+ # @option params [required, String] :command_id
1545
+ # A unique identifier for the command. We recommend using UUID.
1546
+ # Alpha-numeric characters, hyphens, and underscores are valid for use
1547
+ # here.
1548
+ #
1549
+ # @option params [String] :namespace
1550
+ # The namespace of the command. The MQTT reserved topics and validations
1551
+ # will be used for command executions according to the namespace
1552
+ # setting.
1553
+ #
1554
+ # @option params [String] :display_name
1555
+ # The user-friendly name in the console for the command. This name
1556
+ # doesn't have to be unique. You can update the user-friendly name
1557
+ # after you define it.
1558
+ #
1559
+ # @option params [String] :description
1560
+ # A short text decription of the command.
1561
+ #
1562
+ # @option params [Types::CommandPayload] :payload
1563
+ # The payload object for the command. You must specify this information
1564
+ # when using the `AWS-IoT` namespace.
1565
+ #
1566
+ # You can upload a static payload file from your local storage that
1567
+ # contains the instructions for the device to process. The payload file
1568
+ # can use any format. To make sure that the device correctly interprets
1569
+ # the payload, we recommend you to specify the payload content type.
1570
+ #
1571
+ # @option params [Array<Types::CommandParameter>] :mandatory_parameters
1572
+ # A list of parameters that are required by the `StartCommandExecution`
1573
+ # API. These parameters need to be specified only when using the
1574
+ # `AWS-IoT-FleetWise` namespace. You can either specify them here or
1575
+ # when running the command using the `StartCommandExecution` API.
1576
+ #
1577
+ # @option params [String] :role_arn
1578
+ # The IAM role that allows access to create the command.
1579
+ #
1580
+ # @option params [Array<Types::Tag>] :tags
1581
+ # Name-value pairs that are used as metadata to manage a command.
1582
+ #
1583
+ # @return [Types::CreateCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1584
+ #
1585
+ # * {Types::CreateCommandResponse#command_id #command_id} => String
1586
+ # * {Types::CreateCommandResponse#command_arn #command_arn} => String
1587
+ #
1588
+ # @example Request syntax with placeholder values
1589
+ #
1590
+ # resp = client.create_command({
1591
+ # command_id: "CommandId", # required
1592
+ # namespace: "AWS-IoT", # accepts AWS-IoT, AWS-IoT-FleetWise
1593
+ # display_name: "DisplayName",
1594
+ # description: "CommandDescription",
1595
+ # payload: {
1596
+ # content: "data",
1597
+ # content_type: "MimeType",
1598
+ # },
1599
+ # mandatory_parameters: [
1600
+ # {
1601
+ # name: "CommandParameterName", # required
1602
+ # value: {
1603
+ # s: "StringParameterValue",
1604
+ # b: false,
1605
+ # i: 1,
1606
+ # l: 1,
1607
+ # d: 1.0,
1608
+ # bin: "data",
1609
+ # ul: "UnsignedLongParameterValue",
1610
+ # },
1611
+ # default_value: {
1612
+ # s: "StringParameterValue",
1613
+ # b: false,
1614
+ # i: 1,
1615
+ # l: 1,
1616
+ # d: 1.0,
1617
+ # bin: "data",
1618
+ # ul: "UnsignedLongParameterValue",
1619
+ # },
1620
+ # description: "CommandParameterDescription",
1621
+ # },
1622
+ # ],
1623
+ # role_arn: "RoleArn",
1624
+ # tags: [
1625
+ # {
1626
+ # key: "TagKey", # required
1627
+ # value: "TagValue",
1628
+ # },
1629
+ # ],
1630
+ # })
1631
+ #
1632
+ # @example Response structure
1633
+ #
1634
+ # resp.command_id #=> String
1635
+ # resp.command_arn #=> String
1636
+ #
1637
+ # @overload create_command(params = {})
1638
+ # @param [Hash] params ({})
1639
+ def create_command(params = {}, options = {})
1640
+ req = build_request(:create_command, params)
1641
+ req.send_request(options)
1642
+ end
1643
+
1541
1644
  # Use this API to define a Custom Metric published by your devices to
1542
1645
  # Device Defender.
1543
1646
  #
@@ -2040,9 +2143,9 @@ module Aws::IoT
2040
2143
  # [1]: https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions
2041
2144
  #
2042
2145
  # @option params [required, String] :job_id
2043
- # A job identifier which must be unique for your Amazon Web Services
2044
- # account. We recommend using a UUID. Alpha-numeric characters, "-"
2045
- # and "\_" are valid for use here.
2146
+ # A job identifier which must be unique for your account. We recommend
2147
+ # using a UUID. Alpha-numeric characters, "-" and "\_" are valid for
2148
+ # use here.
2046
2149
  #
2047
2150
  # @option params [required, Array<String>] :targets
2048
2151
  # A list of things and thing groups to which the job should be sent.
@@ -4472,6 +4575,63 @@ module Aws::IoT
4472
4575
  req.send_request(options)
4473
4576
  end
4474
4577
 
4578
+ # Delete a command resource.
4579
+ #
4580
+ # @option params [required, String] :command_id
4581
+ # The unique identifier of the command to be deleted.
4582
+ #
4583
+ # @return [Types::DeleteCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4584
+ #
4585
+ # * {Types::DeleteCommandResponse#status_code #status_code} => Integer
4586
+ #
4587
+ # @example Request syntax with placeholder values
4588
+ #
4589
+ # resp = client.delete_command({
4590
+ # command_id: "CommandId", # required
4591
+ # })
4592
+ #
4593
+ # @example Response structure
4594
+ #
4595
+ # resp.status_code #=> Integer
4596
+ #
4597
+ # @overload delete_command(params = {})
4598
+ # @param [Hash] params ({})
4599
+ def delete_command(params = {}, options = {})
4600
+ req = build_request(:delete_command, params)
4601
+ req.send_request(options)
4602
+ end
4603
+
4604
+ # Delete a command execution.
4605
+ #
4606
+ # <note markdown="1"> Only command executions that enter a terminal state can be deleted
4607
+ # from your account.
4608
+ #
4609
+ # </note>
4610
+ #
4611
+ # @option params [required, String] :execution_id
4612
+ # The unique identifier of the command execution that you want to delete
4613
+ # from your account.
4614
+ #
4615
+ # @option params [required, String] :target_arn
4616
+ # The Amazon Resource Number (ARN) of the target device for which you
4617
+ # want to delete command executions.
4618
+ #
4619
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4620
+ #
4621
+ # @example Request syntax with placeholder values
4622
+ #
4623
+ # resp = client.delete_command_execution({
4624
+ # execution_id: "CommandExecutionId", # required
4625
+ # target_arn: "TargetArn", # required
4626
+ # })
4627
+ #
4628
+ # @overload delete_command_execution(params = {})
4629
+ # @param [Hash] params ({})
4630
+ def delete_command_execution(params = {}, options = {})
4631
+ req = build_request(:delete_command_execution, params)
4632
+ req.send_request(options)
4633
+ end
4634
+
4475
4635
  # Deletes a Device Defender detect custom metric.
4476
4636
  #
4477
4637
  # Requires permission to access the [DeleteCustomMetric][1] action.
@@ -6378,8 +6538,8 @@ module Aws::IoT
6378
6538
  # The unique identifier you assigned to this job when it was created.
6379
6539
  #
6380
6540
  # @option params [Boolean] :before_substitution
6381
- # A flag that provides a view of the job document before and after the
6382
- # substitution parameters have been resolved with their exact values.
6541
+ # Provides a view of the job document before and after the substitution
6542
+ # parameters have been resolved with their exact values.
6383
6543
  #
6384
6544
  # @return [Types::DescribeJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6385
6545
  #
@@ -7582,6 +7742,148 @@ module Aws::IoT
7582
7742
  req.send_request(options)
7583
7743
  end
7584
7744
 
7745
+ # Gets information about the specified command.
7746
+ #
7747
+ # @option params [required, String] :command_id
7748
+ # The unique identifier of the command for which you want to retrieve
7749
+ # information.
7750
+ #
7751
+ # @return [Types::GetCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7752
+ #
7753
+ # * {Types::GetCommandResponse#command_id #command_id} => String
7754
+ # * {Types::GetCommandResponse#command_arn #command_arn} => String
7755
+ # * {Types::GetCommandResponse#namespace #namespace} => String
7756
+ # * {Types::GetCommandResponse#display_name #display_name} => String
7757
+ # * {Types::GetCommandResponse#description #description} => String
7758
+ # * {Types::GetCommandResponse#mandatory_parameters #mandatory_parameters} => Array&lt;Types::CommandParameter&gt;
7759
+ # * {Types::GetCommandResponse#payload #payload} => Types::CommandPayload
7760
+ # * {Types::GetCommandResponse#role_arn #role_arn} => String
7761
+ # * {Types::GetCommandResponse#created_at #created_at} => Time
7762
+ # * {Types::GetCommandResponse#last_updated_at #last_updated_at} => Time
7763
+ # * {Types::GetCommandResponse#deprecated #deprecated} => Boolean
7764
+ # * {Types::GetCommandResponse#pending_deletion #pending_deletion} => Boolean
7765
+ #
7766
+ # @example Request syntax with placeholder values
7767
+ #
7768
+ # resp = client.get_command({
7769
+ # command_id: "CommandId", # required
7770
+ # })
7771
+ #
7772
+ # @example Response structure
7773
+ #
7774
+ # resp.command_id #=> String
7775
+ # resp.command_arn #=> String
7776
+ # resp.namespace #=> String, one of "AWS-IoT", "AWS-IoT-FleetWise"
7777
+ # resp.display_name #=> String
7778
+ # resp.description #=> String
7779
+ # resp.mandatory_parameters #=> Array
7780
+ # resp.mandatory_parameters[0].name #=> String
7781
+ # resp.mandatory_parameters[0].value.s #=> String
7782
+ # resp.mandatory_parameters[0].value.b #=> Boolean
7783
+ # resp.mandatory_parameters[0].value.i #=> Integer
7784
+ # resp.mandatory_parameters[0].value.l #=> Integer
7785
+ # resp.mandatory_parameters[0].value.d #=> Float
7786
+ # resp.mandatory_parameters[0].value.bin #=> String
7787
+ # resp.mandatory_parameters[0].value.ul #=> String
7788
+ # resp.mandatory_parameters[0].default_value.s #=> String
7789
+ # resp.mandatory_parameters[0].default_value.b #=> Boolean
7790
+ # resp.mandatory_parameters[0].default_value.i #=> Integer
7791
+ # resp.mandatory_parameters[0].default_value.l #=> Integer
7792
+ # resp.mandatory_parameters[0].default_value.d #=> Float
7793
+ # resp.mandatory_parameters[0].default_value.bin #=> String
7794
+ # resp.mandatory_parameters[0].default_value.ul #=> String
7795
+ # resp.mandatory_parameters[0].description #=> String
7796
+ # resp.payload.content #=> String
7797
+ # resp.payload.content_type #=> String
7798
+ # resp.role_arn #=> String
7799
+ # resp.created_at #=> Time
7800
+ # resp.last_updated_at #=> Time
7801
+ # resp.deprecated #=> Boolean
7802
+ # resp.pending_deletion #=> Boolean
7803
+ #
7804
+ # @overload get_command(params = {})
7805
+ # @param [Hash] params ({})
7806
+ def get_command(params = {}, options = {})
7807
+ req = build_request(:get_command, params)
7808
+ req.send_request(options)
7809
+ end
7810
+
7811
+ # Gets information about the specific command execution on a single
7812
+ # device.
7813
+ #
7814
+ # @option params [required, String] :execution_id
7815
+ # The unique identifier for the command execution. This information is
7816
+ # returned as a response of the `StartCommandExecution` API request.
7817
+ #
7818
+ # @option params [required, String] :target_arn
7819
+ # The Amazon Resource Number (ARN) of the device on which the command
7820
+ # execution is being performed.
7821
+ #
7822
+ # @option params [Boolean] :include_result
7823
+ # Can be used to specify whether to include the result of the command
7824
+ # execution in the `GetCommandExecution` API response. Your device can
7825
+ # use this field to provide additional information about the command
7826
+ # execution. You only need to specify this field when using the
7827
+ # `AWS-IoT` namespace.
7828
+ #
7829
+ # @return [Types::GetCommandExecutionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7830
+ #
7831
+ # * {Types::GetCommandExecutionResponse#execution_id #execution_id} => String
7832
+ # * {Types::GetCommandExecutionResponse#command_arn #command_arn} => String
7833
+ # * {Types::GetCommandExecutionResponse#target_arn #target_arn} => String
7834
+ # * {Types::GetCommandExecutionResponse#status #status} => String
7835
+ # * {Types::GetCommandExecutionResponse#status_reason #status_reason} => Types::StatusReason
7836
+ # * {Types::GetCommandExecutionResponse#result #result} => Hash&lt;String,Types::CommandExecutionResult&gt;
7837
+ # * {Types::GetCommandExecutionResponse#parameters #parameters} => Hash&lt;String,Types::CommandParameterValue&gt;
7838
+ # * {Types::GetCommandExecutionResponse#execution_timeout_seconds #execution_timeout_seconds} => Integer
7839
+ # * {Types::GetCommandExecutionResponse#created_at #created_at} => Time
7840
+ # * {Types::GetCommandExecutionResponse#last_updated_at #last_updated_at} => Time
7841
+ # * {Types::GetCommandExecutionResponse#started_at #started_at} => Time
7842
+ # * {Types::GetCommandExecutionResponse#completed_at #completed_at} => Time
7843
+ # * {Types::GetCommandExecutionResponse#time_to_live #time_to_live} => Time
7844
+ #
7845
+ # @example Request syntax with placeholder values
7846
+ #
7847
+ # resp = client.get_command_execution({
7848
+ # execution_id: "CommandExecutionId", # required
7849
+ # target_arn: "TargetArn", # required
7850
+ # include_result: false,
7851
+ # })
7852
+ #
7853
+ # @example Response structure
7854
+ #
7855
+ # resp.execution_id #=> String
7856
+ # resp.command_arn #=> String
7857
+ # resp.target_arn #=> String
7858
+ # resp.status #=> String, one of "CREATED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "REJECTED", "TIMED_OUT"
7859
+ # resp.status_reason.reason_code #=> String
7860
+ # resp.status_reason.reason_description #=> String
7861
+ # resp.result #=> Hash
7862
+ # resp.result["CommandExecutionResultName"].s #=> String
7863
+ # resp.result["CommandExecutionResultName"].b #=> Boolean
7864
+ # resp.result["CommandExecutionResultName"].bin #=> String
7865
+ # resp.parameters #=> Hash
7866
+ # resp.parameters["CommandParameterName"].s #=> String
7867
+ # resp.parameters["CommandParameterName"].b #=> Boolean
7868
+ # resp.parameters["CommandParameterName"].i #=> Integer
7869
+ # resp.parameters["CommandParameterName"].l #=> Integer
7870
+ # resp.parameters["CommandParameterName"].d #=> Float
7871
+ # resp.parameters["CommandParameterName"].bin #=> String
7872
+ # resp.parameters["CommandParameterName"].ul #=> String
7873
+ # resp.execution_timeout_seconds #=> Integer
7874
+ # resp.created_at #=> Time
7875
+ # resp.last_updated_at #=> Time
7876
+ # resp.started_at #=> Time
7877
+ # resp.completed_at #=> Time
7878
+ # resp.time_to_live #=> Time
7879
+ #
7880
+ # @overload get_command_execution(params = {})
7881
+ # @param [Hash] params ({})
7882
+ def get_command_execution(params = {}, options = {})
7883
+ req = build_request(:get_command_execution, params)
7884
+ req.send_request(options)
7885
+ end
7886
+
7585
7887
  # Gets a list of the policies that have an effect on the authorization
7586
7888
  # behavior of the specified device when it connects to the IoT device
7587
7889
  # gateway.
@@ -7688,8 +7990,8 @@ module Aws::IoT
7688
7990
  # The unique identifier you assigned to this job when it was created.
7689
7991
  #
7690
7992
  # @option params [Boolean] :before_substitution
7691
- # A flag that provides a view of the job document before and after the
7692
- # substitution parameters have been resolved with their exact values.
7993
+ # Provides a view of the job document before and after the substitution
7994
+ # parameters have been resolved with their exact values.
7693
7995
  #
7694
7996
  # @return [Types::GetJobDocumentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7695
7997
  #
@@ -9438,6 +9740,166 @@ module Aws::IoT
9438
9740
  req.send_request(options)
9439
9741
  end
9440
9742
 
9743
+ # List all command executions.
9744
+ #
9745
+ # You must provide only the `startedTimeFilter` or the
9746
+ # `completedTimeFilter` information. If you provide both time filters,
9747
+ # the API will generate an error. You can use this information to find
9748
+ # command executions that started within a specific timeframe.
9749
+ #
9750
+ # @option params [Integer] :max_results
9751
+ # The maximum number of results to return in this operation.
9752
+ #
9753
+ # @option params [String] :next_token
9754
+ # To retrieve the next set of results, the `nextToken` value from a
9755
+ # previous response; otherwise `null` to receive the first set of
9756
+ # results.
9757
+ #
9758
+ # @option params [String] :namespace
9759
+ # The namespace of the command.
9760
+ #
9761
+ # @option params [String] :status
9762
+ # List all command executions for the device that have a particular
9763
+ # status. For example, you can filter the list to display only command
9764
+ # executions that have failed or timed out.
9765
+ #
9766
+ # @option params [String] :sort_order
9767
+ # Specify whether to list the command executions that were created in
9768
+ # the ascending or descending order. By default, the API returns all
9769
+ # commands in the descending order based on the start time or completion
9770
+ # time of the executions, that are determined by the `startTimeFilter`
9771
+ # and `completeTimeFilter` parameters.
9772
+ #
9773
+ # @option params [Types::TimeFilter] :started_time_filter
9774
+ # List all command executions that started any time before or after the
9775
+ # date and time that you specify. The date and time uses the format
9776
+ # `yyyy-MM-dd'T'HH:mm`.
9777
+ #
9778
+ # @option params [Types::TimeFilter] :completed_time_filter
9779
+ # List all command executions that completed any time before or after
9780
+ # the date and time that you specify. The date and time uses the format
9781
+ # `yyyy-MM-dd'T'HH:mm`.
9782
+ #
9783
+ # @option params [String] :target_arn
9784
+ # The Amazon Resource Number (ARN) of the target device. You can use
9785
+ # this information to list all command executions for a particular
9786
+ # device.
9787
+ #
9788
+ # @option params [String] :command_arn
9789
+ # The Amazon Resource Number (ARN) of the command. You can use this
9790
+ # information to list all command executions for a particular command.
9791
+ #
9792
+ # @return [Types::ListCommandExecutionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9793
+ #
9794
+ # * {Types::ListCommandExecutionsResponse#command_executions #command_executions} => Array&lt;Types::CommandExecutionSummary&gt;
9795
+ # * {Types::ListCommandExecutionsResponse#next_token #next_token} => String
9796
+ #
9797
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9798
+ #
9799
+ # @example Request syntax with placeholder values
9800
+ #
9801
+ # resp = client.list_command_executions({
9802
+ # max_results: 1,
9803
+ # next_token: "NextToken",
9804
+ # namespace: "AWS-IoT", # accepts AWS-IoT, AWS-IoT-FleetWise
9805
+ # status: "CREATED", # accepts CREATED, IN_PROGRESS, SUCCEEDED, FAILED, REJECTED, TIMED_OUT
9806
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
9807
+ # started_time_filter: {
9808
+ # after: "StringDateTime",
9809
+ # before: "StringDateTime",
9810
+ # },
9811
+ # completed_time_filter: {
9812
+ # after: "StringDateTime",
9813
+ # before: "StringDateTime",
9814
+ # },
9815
+ # target_arn: "TargetArn",
9816
+ # command_arn: "CommandArn",
9817
+ # })
9818
+ #
9819
+ # @example Response structure
9820
+ #
9821
+ # resp.command_executions #=> Array
9822
+ # resp.command_executions[0].command_arn #=> String
9823
+ # resp.command_executions[0].execution_id #=> String
9824
+ # resp.command_executions[0].target_arn #=> String
9825
+ # resp.command_executions[0].status #=> String, one of "CREATED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "REJECTED", "TIMED_OUT"
9826
+ # resp.command_executions[0].created_at #=> Time
9827
+ # resp.command_executions[0].started_at #=> Time
9828
+ # resp.command_executions[0].completed_at #=> Time
9829
+ # resp.next_token #=> String
9830
+ #
9831
+ # @overload list_command_executions(params = {})
9832
+ # @param [Hash] params ({})
9833
+ def list_command_executions(params = {}, options = {})
9834
+ req = build_request(:list_command_executions, params)
9835
+ req.send_request(options)
9836
+ end
9837
+
9838
+ # List all commands in your account.
9839
+ #
9840
+ # @option params [Integer] :max_results
9841
+ # The maximum number of results to return in this operation. By default,
9842
+ # the API returns up to a maximum of 25 results. You can override this
9843
+ # default value to return up to a maximum of 100 results for this
9844
+ # operation.
9845
+ #
9846
+ # @option params [String] :next_token
9847
+ # To retrieve the next set of results, the `nextToken` value from a
9848
+ # previous response; otherwise `null` to receive the first set of
9849
+ # results.
9850
+ #
9851
+ # @option params [String] :namespace
9852
+ # The namespace of the command. By default, the API returns all commands
9853
+ # that have been created for both `AWS-IoT` and `AWS-IoT-FleetWise`
9854
+ # namespaces. You can override this default value if you want to return
9855
+ # all commands that have been created only for a specific namespace.
9856
+ #
9857
+ # @option params [String] :command_parameter_name
9858
+ # A filter that can be used to display the list of commands that have a
9859
+ # specific command parameter name.
9860
+ #
9861
+ # @option params [String] :sort_order
9862
+ # Specify whether to list the commands that you have created in the
9863
+ # ascending or descending order. By default, the API returns all
9864
+ # commands in the descending order based on the time that they were
9865
+ # created.
9866
+ #
9867
+ # @return [Types::ListCommandsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9868
+ #
9869
+ # * {Types::ListCommandsResponse#commands #commands} => Array&lt;Types::CommandSummary&gt;
9870
+ # * {Types::ListCommandsResponse#next_token #next_token} => String
9871
+ #
9872
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
9873
+ #
9874
+ # @example Request syntax with placeholder values
9875
+ #
9876
+ # resp = client.list_commands({
9877
+ # max_results: 1,
9878
+ # next_token: "NextToken",
9879
+ # namespace: "AWS-IoT", # accepts AWS-IoT, AWS-IoT-FleetWise
9880
+ # command_parameter_name: "CommandParameterName",
9881
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
9882
+ # })
9883
+ #
9884
+ # @example Response structure
9885
+ #
9886
+ # resp.commands #=> Array
9887
+ # resp.commands[0].command_arn #=> String
9888
+ # resp.commands[0].command_id #=> String
9889
+ # resp.commands[0].display_name #=> String
9890
+ # resp.commands[0].deprecated #=> Boolean
9891
+ # resp.commands[0].created_at #=> Time
9892
+ # resp.commands[0].last_updated_at #=> Time
9893
+ # resp.commands[0].pending_deletion #=> Boolean
9894
+ # resp.next_token #=> String
9895
+ #
9896
+ # @overload list_commands(params = {})
9897
+ # @param [Hash] params ({})
9898
+ def list_commands(params = {}, options = {})
9899
+ req = build_request(:list_commands, params)
9900
+ req.send_request(options)
9901
+ end
9902
+
9441
9903
  # Lists your Device Defender detect custom metrics.
9442
9904
  #
9443
9905
  # Requires permission to access the [ListCustomMetrics][1] action.
@@ -14231,6 +14693,52 @@ module Aws::IoT
14231
14693
  req.send_request(options)
14232
14694
  end
14233
14695
 
14696
+ # Update information about a command or mark a command for deprecation.
14697
+ #
14698
+ # @option params [required, String] :command_id
14699
+ # The unique identifier of the command to be updated.
14700
+ #
14701
+ # @option params [String] :display_name
14702
+ # The new user-friendly name to use in the console for the command.
14703
+ #
14704
+ # @option params [String] :description
14705
+ # A short text description of the command.
14706
+ #
14707
+ # @option params [Boolean] :deprecated
14708
+ # A boolean that you can use to specify whether to deprecate a command.
14709
+ #
14710
+ # @return [Types::UpdateCommandResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
14711
+ #
14712
+ # * {Types::UpdateCommandResponse#command_id #command_id} => String
14713
+ # * {Types::UpdateCommandResponse#display_name #display_name} => String
14714
+ # * {Types::UpdateCommandResponse#description #description} => String
14715
+ # * {Types::UpdateCommandResponse#deprecated #deprecated} => Boolean
14716
+ # * {Types::UpdateCommandResponse#last_updated_at #last_updated_at} => Time
14717
+ #
14718
+ # @example Request syntax with placeholder values
14719
+ #
14720
+ # resp = client.update_command({
14721
+ # command_id: "CommandId", # required
14722
+ # display_name: "DisplayName",
14723
+ # description: "CommandDescription",
14724
+ # deprecated: false,
14725
+ # })
14726
+ #
14727
+ # @example Response structure
14728
+ #
14729
+ # resp.command_id #=> String
14730
+ # resp.display_name #=> String
14731
+ # resp.description #=> String
14732
+ # resp.deprecated #=> Boolean
14733
+ # resp.last_updated_at #=> Time
14734
+ #
14735
+ # @overload update_command(params = {})
14736
+ # @param [Hash] params ({})
14737
+ def update_command(params = {}, options = {})
14738
+ req = build_request(:update_command, params)
14739
+ req.send_request(options)
14740
+ end
14741
+
14234
14742
  # Updates a Device Defender detect custom metric.
14235
14743
  #
14236
14744
  # Requires permission to access the [UpdateCustomMetric][1] action.
@@ -15828,7 +16336,7 @@ module Aws::IoT
15828
16336
  tracer: tracer
15829
16337
  )
15830
16338
  context[:gem_name] = 'aws-sdk-iot'
15831
- context[:gem_version] = '1.139.0'
16339
+ context[:gem_version] = '1.140.0'
15832
16340
  Seahorse::Client::Request.new(handlers, context)
15833
16341
  end
15834
16342