aws-sdk-ssm 1.82.0 → 1.88.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 89b2780e964aac2f35594fa42eb0d85067d33aa4a6657a09971bc86354742967
4
- data.tar.gz: 5092209c6f492e36e4a38b368ed7c5a0ff1ab81a93af8b5b1cd8d037dab947f5
3
+ metadata.gz: ccfcc1f5cd007ee807848d67691877af750ab3e1ba71f2b8e75323b2c4b95c85
4
+ data.tar.gz: e68e2792c8b397d4f3a39908fc767dc820e7f025ff409baa60ab712b1cb8887c
5
5
  SHA512:
6
- metadata.gz: f7ca28f04dd0818bf47537d947019bed780e3eeb96a795cc1296108e82f356479710d9e6570662e731e13a3f308d5dc54cf9f4640460b6179e0b58808cced98c
7
- data.tar.gz: a4a5a8b221a34265a4d89b16ba0454905fac8b449531ca6650e5ca97a835232213d400e1c84b63cb81a089d6dcae7641eac9171f9e8b5caaaa9d0918601b1996
6
+ metadata.gz: 338e0b8b4c1468367fe703ad8391070b2f66830219df0630228ca79be86a90222bdc256000d0fb8f50d65200bf18dea44d7a2d08b98dd49b3de1cadd77ec7345
7
+ data.tar.gz: 3dff46d2f7d78c1b3a7010f26570719bc0d8cfaa3dc269f317ce7e12249b0156afe40d17dd244ab6c4887e58207b67375677aa8e036a2a1b542c7c0019b49a38
@@ -14,6 +14,7 @@ require_relative 'aws-sdk-ssm/types'
14
14
  require_relative 'aws-sdk-ssm/client_api'
15
15
  require_relative 'aws-sdk-ssm/client'
16
16
  require_relative 'aws-sdk-ssm/errors'
17
+ require_relative 'aws-sdk-ssm/waiters'
17
18
  require_relative 'aws-sdk-ssm/resource'
18
19
  require_relative 'aws-sdk-ssm/customizations'
19
20
 
@@ -44,9 +45,9 @@ require_relative 'aws-sdk-ssm/customizations'
44
45
  #
45
46
  # See {Errors} for more information.
46
47
  #
47
- # @service
48
+ # @!group service
48
49
  module Aws::SSM
49
50
 
50
- GEM_VERSION = '1.82.0'
51
+ GEM_VERSION = '1.88.0'
51
52
 
52
53
  end
@@ -85,13 +85,28 @@ module Aws::SSM
85
85
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
86
86
  # credentials.
87
87
  #
88
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
89
+ # shared file, such as `~/.aws/config`.
90
+ #
91
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
92
+ #
93
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
94
+ # assume a role after providing credentials via the web.
95
+ #
96
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
97
+ # access token generated from `aws login`.
98
+ #
99
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
100
+ # process that outputs to stdout.
101
+ #
88
102
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
89
103
  # from an EC2 IMDS on an EC2 instance.
90
104
  #
91
- # * `Aws::SharedCredentials` - Used for loading credentials from a
92
- # shared file, such as `~/.aws/config`.
105
+ # * `Aws::ECSCredentials` - Used for loading credentials from
106
+ # instances running in ECS.
93
107
  #
94
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
108
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
109
+ # from the Cognito Identity service.
95
110
  #
96
111
  # When `:credentials` are not configured directly, the following
97
112
  # locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::SSM
101
116
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
102
117
  # * `~/.aws/credentials`
103
118
  # * `~/.aws/config`
104
- # * EC2 IMDS instance profile - When used by default, the timeouts are
105
- # very aggressive. Construct and pass an instance of
106
- # `Aws::InstanceProfileCredentails` to enable retries and extended
107
- # timeouts.
119
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
+ # are very aggressive. Construct and pass an instance of
121
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
+ # enable retries and extended timeouts.
108
123
  #
109
124
  # @option options [required, String] :region
110
125
  # The AWS region to connect to. The configured `:region` is
@@ -1771,13 +1786,13 @@ module Aws::SSM
1771
1786
  req.send_request(options)
1772
1787
  end
1773
1788
 
1774
- # Delete a custom inventory type, or the data associated with a custom
1789
+ # Delete a custom inventory type or the data associated with a custom
1775
1790
  # Inventory type. Deleting a custom inventory type is also referred to
1776
1791
  # as deleting a custom inventory schema.
1777
1792
  #
1778
1793
  # @option params [required, String] :type_name
1779
1794
  # The name of the custom inventory type for which you want to delete
1780
- # either all previously collected data, or the inventory type itself.
1795
+ # either all previously collected data or the inventory type itself.
1781
1796
  #
1782
1797
  # @option params [String] :schema_delete_option
1783
1798
  # Use the `SchemaDeleteOption` to delete a custom inventory type
@@ -1818,7 +1833,7 @@ module Aws::SSM
1818
1833
  # type_name: "InventoryItemTypeName", # required
1819
1834
  # schema_delete_option: "DisableSchema", # accepts DisableSchema, DeleteSchema
1820
1835
  # dry_run: false,
1821
- # client_token: "ClientToken",
1836
+ # client_token: "UUID",
1822
1837
  # })
1823
1838
  #
1824
1839
  # @example Response structure
@@ -2295,6 +2310,8 @@ module Aws::SSM
2295
2310
  # * {Types::DescribeAssociationExecutionTargetsResult#association_execution_targets #association_execution_targets} => Array<Types::AssociationExecutionTarget>
2296
2311
  # * {Types::DescribeAssociationExecutionTargetsResult#next_token #next_token} => String
2297
2312
  #
2313
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2314
+ #
2298
2315
  # @example Request syntax with placeholder values
2299
2316
  #
2300
2317
  # resp = client.describe_association_execution_targets({
@@ -2365,6 +2382,8 @@ module Aws::SSM
2365
2382
  # * {Types::DescribeAssociationExecutionsResult#association_executions #association_executions} => Array<Types::AssociationExecution>
2366
2383
  # * {Types::DescribeAssociationExecutionsResult#next_token #next_token} => String
2367
2384
  #
2385
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2386
+ #
2368
2387
  # @example Request syntax with placeholder values
2369
2388
  #
2370
2389
  # resp = client.describe_association_executions({
@@ -2422,6 +2441,8 @@ module Aws::SSM
2422
2441
  # * {Types::DescribeAutomationExecutionsResult#automation_execution_metadata_list #automation_execution_metadata_list} => Array<Types::AutomationExecutionMetadata>
2423
2442
  # * {Types::DescribeAutomationExecutionsResult#next_token #next_token} => String
2424
2443
  #
2444
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2445
+ #
2425
2446
  # @example Request syntax with placeholder values
2426
2447
  #
2427
2448
  # resp = client.describe_automation_executions({
@@ -2510,6 +2531,8 @@ module Aws::SSM
2510
2531
  # * {Types::DescribeAutomationStepExecutionsResult#step_executions #step_executions} => Array<Types::StepExecution>
2511
2532
  # * {Types::DescribeAutomationStepExecutionsResult#next_token #next_token} => String
2512
2533
  #
2534
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2535
+ #
2513
2536
  # @example Request syntax with placeholder values
2514
2537
  #
2515
2538
  # resp = client.describe_automation_step_executions({
@@ -2597,6 +2620,8 @@ module Aws::SSM
2597
2620
  # * {Types::DescribeAvailablePatchesResult#patches #patches} => Array<Types::Patch>
2598
2621
  # * {Types::DescribeAvailablePatchesResult#next_token #next_token} => String
2599
2622
  #
2623
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2624
+ #
2600
2625
  # @example Request syntax with placeholder values
2601
2626
  #
2602
2627
  # resp = client.describe_available_patches({
@@ -2767,6 +2792,8 @@ module Aws::SSM
2767
2792
  # * {Types::DescribeEffectiveInstanceAssociationsResult#associations #associations} => Array<Types::InstanceAssociation>
2768
2793
  # * {Types::DescribeEffectiveInstanceAssociationsResult#next_token #next_token} => String
2769
2794
  #
2795
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2796
+ #
2770
2797
  # @example Request syntax with placeholder values
2771
2798
  #
2772
2799
  # resp = client.describe_effective_instance_associations({
@@ -2812,6 +2839,8 @@ module Aws::SSM
2812
2839
  # * {Types::DescribeEffectivePatchesForPatchBaselineResult#effective_patches #effective_patches} => Array<Types::EffectivePatch>
2813
2840
  # * {Types::DescribeEffectivePatchesForPatchBaselineResult#next_token #next_token} => String
2814
2841
  #
2842
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2843
+ #
2815
2844
  # @example Request syntax with placeholder values
2816
2845
  #
2817
2846
  # resp = client.describe_effective_patches_for_patch_baseline({
@@ -2869,6 +2898,8 @@ module Aws::SSM
2869
2898
  # * {Types::DescribeInstanceAssociationsStatusResult#instance_association_status_infos #instance_association_status_infos} => Array<Types::InstanceAssociationStatusInfo>
2870
2899
  # * {Types::DescribeInstanceAssociationsStatusResult#next_token #next_token} => String
2871
2900
  #
2901
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2902
+ #
2872
2903
  # @example Request syntax with placeholder values
2873
2904
  #
2874
2905
  # resp = client.describe_instance_associations_status({
@@ -3023,6 +3054,8 @@ module Aws::SSM
3023
3054
  # * {Types::DescribeInstancePatchStatesResult#instance_patch_states #instance_patch_states} => Array<Types::InstancePatchState>
3024
3055
  # * {Types::DescribeInstancePatchStatesResult#next_token #next_token} => String
3025
3056
  #
3057
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3058
+ #
3026
3059
  # @example Request syntax with placeholder values
3027
3060
  #
3028
3061
  # resp = client.describe_instance_patch_states({
@@ -3092,6 +3125,8 @@ module Aws::SSM
3092
3125
  # * {Types::DescribeInstancePatchStatesForPatchGroupResult#instance_patch_states #instance_patch_states} => Array<Types::InstancePatchState>
3093
3126
  # * {Types::DescribeInstancePatchStatesForPatchGroupResult#next_token #next_token} => String
3094
3127
  #
3128
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3129
+ #
3095
3130
  # @example Request syntax with placeholder values
3096
3131
  #
3097
3132
  # resp = client.describe_instance_patch_states_for_patch_group({
@@ -3165,6 +3200,8 @@ module Aws::SSM
3165
3200
  # * {Types::DescribeInstancePatchesResult#patches #patches} => Array<Types::PatchComplianceData>
3166
3201
  # * {Types::DescribeInstancePatchesResult#next_token #next_token} => String
3167
3202
  #
3203
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3204
+ #
3168
3205
  # @example Request syntax with placeholder values
3169
3206
  #
3170
3207
  # resp = client.describe_instance_patches({
@@ -3219,10 +3256,12 @@ module Aws::SSM
3219
3256
  # * {Types::DescribeInventoryDeletionsResult#inventory_deletions #inventory_deletions} => Array<Types::InventoryDeletionStatusItem>
3220
3257
  # * {Types::DescribeInventoryDeletionsResult#next_token #next_token} => String
3221
3258
  #
3259
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3260
+ #
3222
3261
  # @example Request syntax with placeholder values
3223
3262
  #
3224
3263
  # resp = client.describe_inventory_deletions({
3225
- # deletion_id: "InventoryDeletionId",
3264
+ # deletion_id: "UUID",
3226
3265
  # next_token: "NextToken",
3227
3266
  # max_results: 1,
3228
3267
  # })
@@ -3282,6 +3321,8 @@ module Aws::SSM
3282
3321
  # * {Types::DescribeMaintenanceWindowExecutionTaskInvocationsResult#window_execution_task_invocation_identities #window_execution_task_invocation_identities} => Array<Types::MaintenanceWindowExecutionTaskInvocationIdentity>
3283
3322
  # * {Types::DescribeMaintenanceWindowExecutionTaskInvocationsResult#next_token #next_token} => String
3284
3323
  #
3324
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3325
+ #
3285
3326
  # @example Request syntax with placeholder values
3286
3327
  #
3287
3328
  # resp = client.describe_maintenance_window_execution_task_invocations({
@@ -3349,6 +3390,8 @@ module Aws::SSM
3349
3390
  # * {Types::DescribeMaintenanceWindowExecutionTasksResult#window_execution_task_identities #window_execution_task_identities} => Array<Types::MaintenanceWindowExecutionTaskIdentity>
3350
3391
  # * {Types::DescribeMaintenanceWindowExecutionTasksResult#next_token #next_token} => String
3351
3392
  #
3393
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3394
+ #
3352
3395
  # @example Request syntax with placeholder values
3353
3396
  #
3354
3397
  # resp = client.describe_maintenance_window_execution_tasks({
@@ -3417,6 +3460,8 @@ module Aws::SSM
3417
3460
  # * {Types::DescribeMaintenanceWindowExecutionsResult#window_executions #window_executions} => Array<Types::MaintenanceWindowExecution>
3418
3461
  # * {Types::DescribeMaintenanceWindowExecutionsResult#next_token #next_token} => String
3419
3462
  #
3463
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3464
+ #
3420
3465
  # @example Request syntax with placeholder values
3421
3466
  #
3422
3467
  # resp = client.describe_maintenance_window_executions({
@@ -3483,6 +3528,8 @@ module Aws::SSM
3483
3528
  # * {Types::DescribeMaintenanceWindowScheduleResult#scheduled_window_executions #scheduled_window_executions} => Array<Types::ScheduledWindowExecution>
3484
3529
  # * {Types::DescribeMaintenanceWindowScheduleResult#next_token #next_token} => String
3485
3530
  #
3531
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3532
+ #
3486
3533
  # @example Request syntax with placeholder values
3487
3534
  #
3488
3535
  # resp = client.describe_maintenance_window_schedule({
@@ -3545,6 +3592,8 @@ module Aws::SSM
3545
3592
  # * {Types::DescribeMaintenanceWindowTargetsResult#targets #targets} => Array<Types::MaintenanceWindowTarget>
3546
3593
  # * {Types::DescribeMaintenanceWindowTargetsResult#next_token #next_token} => String
3547
3594
  #
3595
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3596
+ #
3548
3597
  # @example Request syntax with placeholder values
3549
3598
  #
3550
3599
  # resp = client.describe_maintenance_window_targets({
@@ -3607,6 +3656,8 @@ module Aws::SSM
3607
3656
  # * {Types::DescribeMaintenanceWindowTasksResult#tasks #tasks} => Array<Types::MaintenanceWindowTask>
3608
3657
  # * {Types::DescribeMaintenanceWindowTasksResult#next_token #next_token} => String
3609
3658
  #
3659
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3660
+ #
3610
3661
  # @example Request syntax with placeholder values
3611
3662
  #
3612
3663
  # resp = client.describe_maintenance_window_tasks({
@@ -3676,6 +3727,8 @@ module Aws::SSM
3676
3727
  # * {Types::DescribeMaintenanceWindowsResult#window_identities #window_identities} => Array<Types::MaintenanceWindowIdentity>
3677
3728
  # * {Types::DescribeMaintenanceWindowsResult#next_token #next_token} => String
3678
3729
  #
3730
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3731
+ #
3679
3732
  # @example Request syntax with placeholder values
3680
3733
  #
3681
3734
  # resp = client.describe_maintenance_windows({
@@ -3739,6 +3792,8 @@ module Aws::SSM
3739
3792
  # * {Types::DescribeMaintenanceWindowsForTargetResult#window_identities #window_identities} => Array<Types::MaintenanceWindowIdentityForTarget>
3740
3793
  # * {Types::DescribeMaintenanceWindowsForTargetResult#next_token #next_token} => String
3741
3794
  #
3795
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3796
+ #
3742
3797
  # @example Request syntax with placeholder values
3743
3798
  #
3744
3799
  # resp = client.describe_maintenance_windows_for_target({
@@ -3858,6 +3913,8 @@ module Aws::SSM
3858
3913
  # * {Types::DescribeOpsItemsResponse#next_token #next_token} => String
3859
3914
  # * {Types::DescribeOpsItemsResponse#ops_item_summaries #ops_item_summaries} => Array<Types::OpsItemSummary>
3860
3915
  #
3916
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3917
+ #
3861
3918
  # @example Request syntax with placeholder values
3862
3919
  #
3863
3920
  # resp = client.describe_ops_items({
@@ -4005,6 +4062,8 @@ module Aws::SSM
4005
4062
  # * {Types::DescribePatchBaselinesResult#baseline_identities #baseline_identities} => Array<Types::PatchBaselineIdentity>
4006
4063
  # * {Types::DescribePatchBaselinesResult#next_token #next_token} => String
4007
4064
  #
4065
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4066
+ #
4008
4067
  # @example Request syntax with placeholder values
4009
4068
  #
4010
4069
  # resp = client.describe_patch_baselines({
@@ -4091,6 +4150,22 @@ module Aws::SSM
4091
4150
  # One or more filters. Use a filter to return a more specific list of
4092
4151
  # results.
4093
4152
  #
4153
+ # For `DescribePatchGroups`,valid filter keys include the following:
4154
+ #
4155
+ # * `NAME_PREFIX`\: The name of the patch group. Wildcards (*) are
4156
+ # accepted.
4157
+ #
4158
+ # * `OPERATING_SYSTEM`\: The supported operating system type to return
4159
+ # results for. For valid operating system values, see
4160
+ # GetDefaultPatchBaselineRequest$OperatingSystem in
4161
+ # CreatePatchBaseline.
4162
+ #
4163
+ # Examples:
4164
+ #
4165
+ # * `--filters Key=NAME_PREFIX,Values=MyPatchGroup*`
4166
+ #
4167
+ # * `--filters Key=OPERATING_SYSTEM,Values=AMAZON_LINUX_2`
4168
+ #
4094
4169
  # @option params [String] :next_token
4095
4170
  # The token for the next set of items to return. (You received this
4096
4171
  # token from a previous call.)
@@ -4100,6 +4175,8 @@ module Aws::SSM
4100
4175
  # * {Types::DescribePatchGroupsResult#mappings #mappings} => Array<Types::PatchGroupPatchBaselineMapping>
4101
4176
  # * {Types::DescribePatchGroupsResult#next_token #next_token} => String
4102
4177
  #
4178
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4179
+ #
4103
4180
  # @example Request syntax with placeholder values
4104
4181
  #
4105
4182
  # resp = client.describe_patch_groups({
@@ -4197,6 +4274,8 @@ module Aws::SSM
4197
4274
  # * {Types::DescribePatchPropertiesResult#properties #properties} => Array<Hash<String,String>>
4198
4275
  # * {Types::DescribePatchPropertiesResult#next_token #next_token} => String
4199
4276
  #
4277
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4278
+ #
4200
4279
  # @example Request syntax with placeholder values
4201
4280
  #
4202
4281
  # resp = client.describe_patch_properties({
@@ -4248,6 +4327,8 @@ module Aws::SSM
4248
4327
  # * {Types::DescribeSessionsResponse#sessions #sessions} => Array<Types::Session>
4249
4328
  # * {Types::DescribeSessionsResponse#next_token #next_token} => String
4250
4329
  #
4330
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4331
+ #
4251
4332
  # @example Request syntax with placeholder values
4252
4333
  #
4253
4334
  # resp = client.describe_sessions({
@@ -4410,6 +4491,12 @@ module Aws::SSM
4410
4491
  # next time that the Change Calendar state will transition. If you do
4411
4492
  # not specify a time, `GetCalendarState` assumes the current time.
4412
4493
  # Change Calendar entries have two possible states: `OPEN` or `CLOSED`.
4494
+ #
4495
+ # If you specify more than one calendar in a request, the command
4496
+ # returns the status of `OPEN` only if all calendars in the request are
4497
+ # open. If one or more calendars in the request are closed, the status
4498
+ # returned is `CLOSED`.
4499
+ #
4413
4500
  # For more information about Systems Manager Change Calendar, see [AWS
4414
4501
  # Systems Manager Change Calendar][1] in the *AWS Systems Manager User
4415
4502
  # Guide*.
@@ -4476,6 +4563,9 @@ module Aws::SSM
4476
4563
  # If the document contains only one plugin, the name can be omitted and
4477
4564
  # the details will be returned.
4478
4565
  #
4566
+ # Plugin names are also referred to as step names in Systems Manager
4567
+ # documents.
4568
+ #
4479
4569
  # @return [Types::GetCommandInvocationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4480
4570
  #
4481
4571
  # * {Types::GetCommandInvocationResult#command_id #command_id} => String
@@ -4525,6 +4615,11 @@ module Aws::SSM
4525
4615
  # resp.cloud_watch_output_config.cloud_watch_log_group_name #=> String
4526
4616
  # resp.cloud_watch_output_config.cloud_watch_output_enabled #=> Boolean
4527
4617
  #
4618
+ #
4619
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
4620
+ #
4621
+ # * command_executed
4622
+ #
4528
4623
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetCommandInvocation AWS API Documentation
4529
4624
  #
4530
4625
  # @overload get_command_invocation(params = {})
@@ -4739,6 +4834,8 @@ module Aws::SSM
4739
4834
  # * {Types::GetInventoryResult#entities #entities} => Array<Types::InventoryResultEntity>
4740
4835
  # * {Types::GetInventoryResult#next_token #next_token} => String
4741
4836
  #
4837
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4838
+ #
4742
4839
  # @example Request syntax with placeholder values
4743
4840
  #
4744
4841
  # resp = client.get_inventory({
@@ -4830,6 +4927,8 @@ module Aws::SSM
4830
4927
  # * {Types::GetInventorySchemaResult#schemas #schemas} => Array<Types::InventoryItemSchema>
4831
4928
  # * {Types::GetInventorySchemaResult#next_token #next_token} => String
4832
4929
  #
4930
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4931
+ #
4833
4932
  # @example Request syntax with placeholder values
4834
4933
  #
4835
4934
  # resp = client.get_inventory_schema({
@@ -5258,6 +5357,8 @@ module Aws::SSM
5258
5357
  # * {Types::GetOpsSummaryResult#entities #entities} => Array<Types::OpsEntity>
5259
5358
  # * {Types::GetOpsSummaryResult#next_token #next_token} => String
5260
5359
  #
5360
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
5361
+ #
5261
5362
  # @example Request syntax with placeholder values
5262
5363
  #
5263
5364
  # resp = client.get_ops_summary({
@@ -5820,6 +5921,8 @@ module Aws::SSM
5820
5921
  # * {Types::ListAssociationVersionsResult#association_versions #association_versions} => Array<Types::AssociationVersionInfo>
5821
5922
  # * {Types::ListAssociationVersionsResult#next_token #next_token} => String
5822
5923
  #
5924
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
5925
+ #
5823
5926
  # @example Request syntax with placeholder values
5824
5927
  #
5825
5928
  # resp = client.list_association_versions({
@@ -6038,6 +6141,12 @@ module Aws::SSM
6038
6141
  # @option params [String] :instance_id
6039
6142
  # (Optional) Lists commands issued against this instance ID.
6040
6143
  #
6144
+ # <note markdown="1"> You can't specify an instance ID in the same command that you specify
6145
+ # `Status` = `Pending`. This is because the command has not reached the
6146
+ # instance yet.
6147
+ #
6148
+ # </note>
6149
+ #
6041
6150
  # @option params [Integer] :max_results
6042
6151
  # (Optional) The maximum number of items to return for this call. The
6043
6152
  # call also returns a token that you can specify in a subsequent call to
@@ -6152,6 +6261,8 @@ module Aws::SSM
6152
6261
  # * {Types::ListComplianceItemsResult#compliance_items #compliance_items} => Array&lt;Types::ComplianceItem&gt;
6153
6262
  # * {Types::ListComplianceItemsResult#next_token #next_token} => String
6154
6263
  #
6264
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6265
+ #
6155
6266
  # @example Request syntax with placeholder values
6156
6267
  #
6157
6268
  # resp = client.list_compliance_items({
@@ -6217,6 +6328,8 @@ module Aws::SSM
6217
6328
  # * {Types::ListComplianceSummariesResult#compliance_summary_items #compliance_summary_items} => Array&lt;Types::ComplianceSummaryItem&gt;
6218
6329
  # * {Types::ListComplianceSummariesResult#next_token #next_token} => String
6219
6330
  #
6331
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6332
+ #
6220
6333
  # @example Request syntax with placeholder values
6221
6334
  #
6222
6335
  # resp = client.list_compliance_summaries({
@@ -6280,6 +6393,8 @@ module Aws::SSM
6280
6393
  # * {Types::ListDocumentVersionsResult#document_versions #document_versions} => Array&lt;Types::DocumentVersionInfo&gt;
6281
6394
  # * {Types::ListDocumentVersionsResult#next_token #next_token} => String
6282
6395
  #
6396
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6397
+ #
6283
6398
  # @example Request syntax with placeholder values
6284
6399
  #
6285
6400
  # resp = client.list_document_versions({
@@ -6480,6 +6595,8 @@ module Aws::SSM
6480
6595
  # * {Types::ListResourceComplianceSummariesResult#resource_compliance_summary_items #resource_compliance_summary_items} => Array&lt;Types::ResourceComplianceSummaryItem&gt;
6481
6596
  # * {Types::ListResourceComplianceSummariesResult#next_token #next_token} => String
6482
6597
  #
6598
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6599
+ #
6483
6600
  # @example Request syntax with placeholder values
6484
6601
  #
6485
6602
  # resp = client.list_resource_compliance_summaries({
@@ -6563,6 +6680,8 @@ module Aws::SSM
6563
6680
  # * {Types::ListResourceDataSyncResult#resource_data_sync_items #resource_data_sync_items} => Array&lt;Types::ResourceDataSyncItem&gt;
6564
6681
  # * {Types::ListResourceDataSyncResult#next_token #next_token} => String
6565
6682
  #
6683
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
6684
+ #
6566
6685
  # @example Request syntax with placeholder values
6567
6686
  #
6568
6687
  # resp = client.list_resource_data_sync({
@@ -6919,6 +7038,12 @@ module Aws::SSM
6919
7038
  # parameters have a value limit of 4 KB. Advanced parameters have a
6920
7039
  # value limit of 8 KB.
6921
7040
  #
7041
+ # <note markdown="1"> Parameters can't be referenced or nested in the values of other
7042
+ # parameters. You can't include `\{\{\}\}` or
7043
+ # `\{\{ssm:parameter-name\}\}` in a parameter value.
7044
+ #
7045
+ # </note>
7046
+ #
6922
7047
  # @option params [String] :type
6923
7048
  # The type of parameter that you want to add to the system.
6924
7049
  #
@@ -7699,23 +7824,37 @@ module Aws::SSM
7699
7824
  # Runs commands on one or more managed instances.
7700
7825
  #
7701
7826
  # @option params [Array<String>] :instance_ids
7702
- # The instance IDs where the command should run. You can specify a
7703
- # maximum of 50 IDs. If you prefer not to list individual instance IDs,
7704
- # you can instead send commands to a fleet of instances using the
7705
- # Targets parameter, which accepts EC2 tags. For more information about
7706
- # how to use targets, see [Using targets and rate controls to send
7707
- # commands to a fleet][1] in the *AWS Systems Manager User Guide*.
7827
+ # The IDs of the instances where the command should run. Specifying
7828
+ # instance IDs is most useful when you are targeting a limited number of
7829
+ # instances, though you can specify up to 50 IDs.
7830
+ #
7831
+ # To target a larger number of instances, or if you prefer not to list
7832
+ # individual instance IDs, we recommend using the `Targets` option
7833
+ # instead. Using `Targets`, which accepts tag key-value pairs to
7834
+ # identify the instances to send commands to, you can a send command to
7835
+ # tens, hundreds, or thousands of instances at once.
7836
+ #
7837
+ # For more information about how to use targets, see [Using targets and
7838
+ # rate controls to send commands to a fleet][1] in the *AWS Systems
7839
+ # Manager User Guide*.
7708
7840
  #
7709
7841
  #
7710
7842
  #
7711
7843
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html
7712
7844
  #
7713
7845
  # @option params [Array<Types::Target>] :targets
7714
- # (Optional) An array of search criteria that targets instances using a
7715
- # Key,Value combination that you specify. Targets is required if you
7716
- # don't provide one or more instance IDs in the call. For more
7717
- # information about how to use targets, see [Sending commands to a
7718
- # fleet][1] in the *AWS Systems Manager User Guide*.
7846
+ # An array of search criteria that targets instances using a `Key,Value`
7847
+ # combination that you specify. Specifying targets is most useful when
7848
+ # you want to send a command to a large number of instances at once.
7849
+ # Using `Targets`, which accepts tag key-value pairs to identify
7850
+ # instances, you can send a command to tens, hundreds, or thousands of
7851
+ # instances at once.
7852
+ #
7853
+ # To send a command to a smaller number of instances, you can use the
7854
+ # `InstanceIds` option instead.
7855
+ #
7856
+ # For more information about how to use targets, see [Sending commands
7857
+ # to a fleet][1] in the *AWS Systems Manager User Guide*.
7719
7858
  #
7720
7859
  #
7721
7860
  #
@@ -9579,14 +9718,127 @@ module Aws::SSM
9579
9718
  params: params,
9580
9719
  config: config)
9581
9720
  context[:gem_name] = 'aws-sdk-ssm'
9582
- context[:gem_version] = '1.82.0'
9721
+ context[:gem_version] = '1.88.0'
9583
9722
  Seahorse::Client::Request.new(handlers, context)
9584
9723
  end
9585
9724
 
9725
+ # Polls an API operation until a resource enters a desired state.
9726
+ #
9727
+ # ## Basic Usage
9728
+ #
9729
+ # A waiter will call an API operation until:
9730
+ #
9731
+ # * It is successful
9732
+ # * It enters a terminal state
9733
+ # * It makes the maximum number of attempts
9734
+ #
9735
+ # In between attempts, the waiter will sleep.
9736
+ #
9737
+ # # polls in a loop, sleeping between attempts
9738
+ # client.wait_until(waiter_name, params)
9739
+ #
9740
+ # ## Configuration
9741
+ #
9742
+ # You can configure the maximum number of polling attempts, and the
9743
+ # delay (in seconds) between each polling attempt. You can pass
9744
+ # configuration as the final arguments hash.
9745
+ #
9746
+ # # poll for ~25 seconds
9747
+ # client.wait_until(waiter_name, params, {
9748
+ # max_attempts: 5,
9749
+ # delay: 5,
9750
+ # })
9751
+ #
9752
+ # ## Callbacks
9753
+ #
9754
+ # You can be notified before each polling attempt and before each
9755
+ # delay. If you throw `:success` or `:failure` from these callbacks,
9756
+ # it will terminate the waiter.
9757
+ #
9758
+ # started_at = Time.now
9759
+ # client.wait_until(waiter_name, params, {
9760
+ #
9761
+ # # disable max attempts
9762
+ # max_attempts: nil,
9763
+ #
9764
+ # # poll for 1 hour, instead of a number of attempts
9765
+ # before_wait: -> (attempts, response) do
9766
+ # throw :failure if Time.now - started_at > 3600
9767
+ # end
9768
+ # })
9769
+ #
9770
+ # ## Handling Errors
9771
+ #
9772
+ # When a waiter is unsuccessful, it will raise an error.
9773
+ # All of the failure errors extend from
9774
+ # {Aws::Waiters::Errors::WaiterFailed}.
9775
+ #
9776
+ # begin
9777
+ # client.wait_until(...)
9778
+ # rescue Aws::Waiters::Errors::WaiterFailed
9779
+ # # resource did not enter the desired state in time
9780
+ # end
9781
+ #
9782
+ # ## Valid Waiters
9783
+ #
9784
+ # The following table lists the valid waiter names, the operations they call,
9785
+ # and the default `:delay` and `:max_attempts` values.
9786
+ #
9787
+ # | waiter_name | params | :delay | :max_attempts |
9788
+ # | ---------------- | ------------------------------- | -------- | ------------- |
9789
+ # | command_executed | {Client#get_command_invocation} | 5 | 20 |
9790
+ #
9791
+ # @raise [Errors::FailureStateError] Raised when the waiter terminates
9792
+ # because the waiter has entered a state that it will not transition
9793
+ # out of, preventing success.
9794
+ #
9795
+ # @raise [Errors::TooManyAttemptsError] Raised when the configured
9796
+ # maximum number of attempts have been made, and the waiter is not
9797
+ # yet successful.
9798
+ #
9799
+ # @raise [Errors::UnexpectedError] Raised when an error is encounted
9800
+ # while polling for a resource that is not expected.
9801
+ #
9802
+ # @raise [Errors::NoSuchWaiterError] Raised when you request to wait
9803
+ # for an unknown state.
9804
+ #
9805
+ # @return [Boolean] Returns `true` if the waiter was successful.
9806
+ # @param [Symbol] waiter_name
9807
+ # @param [Hash] params ({})
9808
+ # @param [Hash] options ({})
9809
+ # @option options [Integer] :max_attempts
9810
+ # @option options [Integer] :delay
9811
+ # @option options [Proc] :before_attempt
9812
+ # @option options [Proc] :before_wait
9813
+ def wait_until(waiter_name, params = {}, options = {})
9814
+ w = waiter(waiter_name, options)
9815
+ yield(w.waiter) if block_given? # deprecated
9816
+ w.wait(params)
9817
+ end
9818
+
9586
9819
  # @api private
9587
9820
  # @deprecated
9588
9821
  def waiter_names
9589
- []
9822
+ waiters.keys
9823
+ end
9824
+
9825
+ private
9826
+
9827
+ # @param [Symbol] waiter_name
9828
+ # @param [Hash] options ({})
9829
+ def waiter(waiter_name, options = {})
9830
+ waiter_class = waiters[waiter_name]
9831
+ if waiter_class
9832
+ waiter_class.new(options.merge(client: self))
9833
+ else
9834
+ raise Aws::Waiters::Errors::NoSuchWaiterError.new(waiter_name, waiters.keys)
9835
+ end
9836
+ end
9837
+
9838
+ def waiters
9839
+ {
9840
+ command_executed: Waiters::CommandExecuted
9841
+ }
9590
9842
  end
9591
9843
 
9592
9844
  class << self