aws-sdk-ssm 1.99.0 → 1.104.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.
@@ -34,6 +34,7 @@ module Aws::SSM
34
34
  # * {AssociationExecutionDoesNotExist}
35
35
  # * {AssociationLimitExceeded}
36
36
  # * {AssociationVersionLimitExceeded}
37
+ # * {AutomationDefinitionNotApprovedException}
37
38
  # * {AutomationDefinitionNotFoundException}
38
39
  # * {AutomationDefinitionVersionNotFoundException}
39
40
  # * {AutomationExecutionLimitExceededException}
@@ -243,6 +244,21 @@ module Aws::SSM
243
244
  end
244
245
  end
245
246
 
247
+ class AutomationDefinitionNotApprovedException < ServiceError
248
+
249
+ # @param [Seahorse::Client::RequestContext] context
250
+ # @param [String] message
251
+ # @param [Aws::SSM::Types::AutomationDefinitionNotApprovedException] data
252
+ def initialize(context, message, data = Aws::EmptyStructure.new)
253
+ super(context, message, data)
254
+ end
255
+
256
+ # @return [String]
257
+ def message
258
+ @message || @data[:message]
259
+ end
260
+ end
261
+
246
262
  class AutomationDefinitionNotFoundException < ServiceError
247
263
 
248
264
  # @param [Seahorse::Client::RequestContext] context
@@ -388,6 +388,11 @@ module Aws::SSM
388
388
  # supported for rate expressions.
389
389
  # @return [Boolean]
390
390
  #
391
+ # @!attribute [rw] target_locations
392
+ # The combination of AWS Regions and AWS accounts where you want to
393
+ # run the association.
394
+ # @return [Array<Types::TargetLocation>]
395
+ #
391
396
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationDescription AWS API Documentation
392
397
  #
393
398
  class AssociationDescription < Struct.new(
@@ -412,7 +417,8 @@ module Aws::SSM
412
417
  :max_concurrency,
413
418
  :compliance_severity,
414
419
  :sync_compliance,
415
- :apply_only_at_cron_interval)
420
+ :apply_only_at_cron_interval,
421
+ :target_locations)
416
422
  SENSITIVE = []
417
423
  include Aws::Structure
418
424
  end
@@ -819,6 +825,11 @@ module Aws::SSM
819
825
  # supported for rate expressions.
820
826
  # @return [Boolean]
821
827
  #
828
+ # @!attribute [rw] target_locations
829
+ # The combination of AWS Regions and AWS accounts where you wanted to
830
+ # run the association when this association version was created.
831
+ # @return [Array<Types::TargetLocation>]
832
+ #
822
833
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationVersionInfo AWS API Documentation
823
834
  #
824
835
  class AssociationVersionInfo < Struct.new(
@@ -836,7 +847,8 @@ module Aws::SSM
836
847
  :max_concurrency,
837
848
  :compliance_severity,
838
849
  :sync_compliance,
839
- :apply_only_at_cron_interval)
850
+ :apply_only_at_cron_interval,
851
+ :target_locations)
840
852
  SENSITIVE = []
841
853
  include Aws::Structure
842
854
  end
@@ -967,6 +979,20 @@ module Aws::SSM
967
979
  include Aws::Structure
968
980
  end
969
981
 
982
+ # Indicates that the Change Manager change template used in the change
983
+ # request was rejected or is still in a pending state.
984
+ #
985
+ # @!attribute [rw] message
986
+ # @return [String]
987
+ #
988
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AutomationDefinitionNotApprovedException AWS API Documentation
989
+ #
990
+ class AutomationDefinitionNotApprovedException < Struct.new(
991
+ :message)
992
+ SENSITIVE = []
993
+ include Aws::Structure
994
+ end
995
+
970
996
  # An Automation document with the specified name could not be found.
971
997
  #
972
998
  # @!attribute [rw] message
@@ -1109,6 +1135,40 @@ module Aws::SSM
1109
1135
  # for a multi-Region and multi-account Automation execution.
1110
1136
  # @return [Types::ProgressCounters]
1111
1137
  #
1138
+ # @!attribute [rw] automation_subtype
1139
+ # The subtype of the Automation operation. Currently, the only
1140
+ # supported value is `ChangeRequest`.
1141
+ # @return [String]
1142
+ #
1143
+ # @!attribute [rw] scheduled_time
1144
+ # The date and time the Automation operation is scheduled to start.
1145
+ # @return [Time]
1146
+ #
1147
+ # @!attribute [rw] runbooks
1148
+ # Information about the Automation runbooks (Automation documents)
1149
+ # that are run as part of a runbook workflow.
1150
+ #
1151
+ # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't
1152
+ # run until all required approvals for the change request have been
1153
+ # received.
1154
+ #
1155
+ # </note>
1156
+ # @return [Array<Types::Runbook>]
1157
+ #
1158
+ # @!attribute [rw] ops_item_id
1159
+ # The ID of an OpsItem that is created to represent a Change Manager
1160
+ # change request.
1161
+ # @return [String]
1162
+ #
1163
+ # @!attribute [rw] association_id
1164
+ # The ID of a State Manager association used in the Automation
1165
+ # operation.
1166
+ # @return [String]
1167
+ #
1168
+ # @!attribute [rw] change_request_name
1169
+ # The name of the Change Manager change request.
1170
+ # @return [String]
1171
+ #
1112
1172
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AutomationExecution AWS API Documentation
1113
1173
  #
1114
1174
  class AutomationExecution < Struct.new(
@@ -1136,7 +1196,13 @@ module Aws::SSM
1136
1196
  :max_errors,
1137
1197
  :target,
1138
1198
  :target_locations,
1139
- :progress_counters)
1199
+ :progress_counters,
1200
+ :automation_subtype,
1201
+ :scheduled_time,
1202
+ :runbooks,
1203
+ :ops_item_id,
1204
+ :association_id,
1205
+ :change_request_name)
1140
1206
  SENSITIVE = []
1141
1207
  include Aws::Structure
1142
1208
  end
@@ -1148,15 +1214,12 @@ module Aws::SSM
1148
1214
  # data as a hash:
1149
1215
  #
1150
1216
  # {
1151
- # key: "DocumentNamePrefix", # required, accepts DocumentNamePrefix, ExecutionStatus, ExecutionId, ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter, AutomationType, TagKey, TargetResourceGroup
1217
+ # key: "DocumentNamePrefix", # required, accepts DocumentNamePrefix, ExecutionStatus, ExecutionId, ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter, AutomationType, TagKey, TargetResourceGroup, AutomationSubtype, OpsItemId
1152
1218
  # values: ["AutomationExecutionFilterValue"], # required
1153
1219
  # }
1154
1220
  #
1155
1221
  # @!attribute [rw] key
1156
- # One or more keys to limit the results. Valid filter keys include the
1157
- # following: DocumentNamePrefix, ExecutionStatus, ExecutionId,
1158
- # ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter,
1159
- # TargetResourceGroup.
1222
+ # One or more keys to limit the results.
1160
1223
  # @return [String]
1161
1224
  #
1162
1225
  # @!attribute [rw] values
@@ -1289,6 +1352,40 @@ module Aws::SSM
1289
1352
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-automation-multiple-accounts-and-regions.html
1290
1353
  # @return [String]
1291
1354
  #
1355
+ # @!attribute [rw] automation_subtype
1356
+ # The subtype of the Automation operation. Currently, the only
1357
+ # supported value is `ChangeRequest`.
1358
+ # @return [String]
1359
+ #
1360
+ # @!attribute [rw] scheduled_time
1361
+ # The date and time the Automation operation is scheduled to start.
1362
+ # @return [Time]
1363
+ #
1364
+ # @!attribute [rw] runbooks
1365
+ # Information about the Automation runbooks (Automation documents)
1366
+ # that are run during a runbook workflow in Change Manager.
1367
+ #
1368
+ # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't
1369
+ # run until all required approvals for the change request have been
1370
+ # received.
1371
+ #
1372
+ # </note>
1373
+ # @return [Array<Types::Runbook>]
1374
+ #
1375
+ # @!attribute [rw] ops_item_id
1376
+ # The ID of an OpsItem that is created to represent a Change Manager
1377
+ # change request.
1378
+ # @return [String]
1379
+ #
1380
+ # @!attribute [rw] association_id
1381
+ # The ID of a State Manager association used in the Automation
1382
+ # operation.
1383
+ # @return [String]
1384
+ #
1385
+ # @!attribute [rw] change_request_name
1386
+ # The name of the Change Manager change request.
1387
+ # @return [String]
1388
+ #
1292
1389
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AutomationExecutionMetadata AWS API Documentation
1293
1390
  #
1294
1391
  class AutomationExecutionMetadata < Struct.new(
@@ -1313,7 +1410,13 @@ module Aws::SSM
1313
1410
  :max_concurrency,
1314
1411
  :max_errors,
1315
1412
  :target,
1316
- :automation_type)
1413
+ :automation_type,
1414
+ :automation_subtype,
1415
+ :scheduled_time,
1416
+ :runbooks,
1417
+ :ops_item_id,
1418
+ :association_id,
1419
+ :change_request_name)
1317
1420
  SENSITIVE = []
1318
1421
  include Aws::Structure
1319
1422
  end
@@ -2434,6 +2537,15 @@ module Aws::SSM
2434
2537
  # compliance_severity: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, UNSPECIFIED
2435
2538
  # sync_compliance: "AUTO", # accepts AUTO, MANUAL
2436
2539
  # apply_only_at_cron_interval: false,
2540
+ # target_locations: [
2541
+ # {
2542
+ # accounts: ["Account"],
2543
+ # regions: ["Region"],
2544
+ # target_location_max_concurrency: "MaxConcurrency",
2545
+ # target_location_max_errors: "MaxErrors",
2546
+ # execution_role_name: "ExecutionRoleName",
2547
+ # },
2548
+ # ],
2437
2549
  # },
2438
2550
  # ],
2439
2551
  # }
@@ -2484,6 +2596,15 @@ module Aws::SSM
2484
2596
  # compliance_severity: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, UNSPECIFIED
2485
2597
  # sync_compliance: "AUTO", # accepts AUTO, MANUAL
2486
2598
  # apply_only_at_cron_interval: false,
2599
+ # target_locations: [
2600
+ # {
2601
+ # accounts: ["Account"],
2602
+ # regions: ["Region"],
2603
+ # target_location_max_concurrency: "MaxConcurrency",
2604
+ # target_location_max_errors: "MaxErrors",
2605
+ # execution_role_name: "ExecutionRoleName",
2606
+ # },
2607
+ # ],
2487
2608
  # }
2488
2609
  #
2489
2610
  # @!attribute [rw] name
@@ -2603,6 +2724,11 @@ module Aws::SSM
2603
2724
  # supported for rate expressions.
2604
2725
  # @return [Boolean]
2605
2726
  #
2727
+ # @!attribute [rw] target_locations
2728
+ # Use this action to create an association in multiple Regions and
2729
+ # multiple accounts.
2730
+ # @return [Array<Types::TargetLocation>]
2731
+ #
2606
2732
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationBatchRequestEntry AWS API Documentation
2607
2733
  #
2608
2734
  class CreateAssociationBatchRequestEntry < Struct.new(
@@ -2619,7 +2745,8 @@ module Aws::SSM
2619
2745
  :max_concurrency,
2620
2746
  :compliance_severity,
2621
2747
  :sync_compliance,
2622
- :apply_only_at_cron_interval)
2748
+ :apply_only_at_cron_interval,
2749
+ :target_locations)
2623
2750
  SENSITIVE = []
2624
2751
  include Aws::Structure
2625
2752
  end
@@ -2672,6 +2799,15 @@ module Aws::SSM
2672
2799
  # compliance_severity: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, UNSPECIFIED
2673
2800
  # sync_compliance: "AUTO", # accepts AUTO, MANUAL
2674
2801
  # apply_only_at_cron_interval: false,
2802
+ # target_locations: [
2803
+ # {
2804
+ # accounts: ["Account"],
2805
+ # regions: ["Region"],
2806
+ # target_location_max_concurrency: "MaxConcurrency",
2807
+ # target_location_max_errors: "MaxErrors",
2808
+ # execution_role_name: "ExecutionRoleName",
2809
+ # },
2810
+ # ],
2675
2811
  # }
2676
2812
  #
2677
2813
  # @!attribute [rw] name
@@ -2812,6 +2948,12 @@ module Aws::SSM
2812
2948
  # supported for rate expressions.
2813
2949
  # @return [Boolean]
2814
2950
  #
2951
+ # @!attribute [rw] target_locations
2952
+ # A location is a combination of AWS Regions and AWS accounts where
2953
+ # you want to run the association. Use this action to create an
2954
+ # association in multiple Regions and multiple accounts.
2955
+ # @return [Array<Types::TargetLocation>]
2956
+ #
2815
2957
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationRequest AWS API Documentation
2816
2958
  #
2817
2959
  class CreateAssociationRequest < Struct.new(
@@ -2828,7 +2970,8 @@ module Aws::SSM
2828
2970
  :max_concurrency,
2829
2971
  :compliance_severity,
2830
2972
  :sync_compliance,
2831
- :apply_only_at_cron_interval)
2973
+ :apply_only_at_cron_interval,
2974
+ :target_locations)
2832
2975
  SENSITIVE = []
2833
2976
  include Aws::Structure
2834
2977
  end
@@ -2865,7 +3008,7 @@ module Aws::SSM
2865
3008
  # ],
2866
3009
  # name: "DocumentName", # required
2867
3010
  # version_name: "DocumentVersionName",
2868
- # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar
3011
+ # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar, Automation.ChangeTemplate
2869
3012
  # document_format: "YAML", # accepts YAML, JSON, TEXT
2870
3013
  # target_type: "TargetType",
2871
3014
  # tags: [
@@ -3060,8 +3203,8 @@ module Aws::SSM
3060
3203
  # @!attribute [rw] schedule_timezone
3061
3204
  # The time zone that the scheduled maintenance window executions are
3062
3205
  # based on, in Internet Assigned Numbers Authority (IANA) format. For
3063
- # example: "America/Los\_Angeles", "etc/UTC", or "Asia/Seoul".
3064
- # For more information, see the [Time Zone Database][1] on the IANA
3206
+ # example: "America/Los\_Angeles", "UTC", or "Asia/Seoul". For
3207
+ # more information, see the [Time Zone Database][1] on the IANA
3065
3208
  # website.
3066
3209
  #
3067
3210
  #
@@ -3076,7 +3219,7 @@ module Aws::SSM
3076
3219
  # For example, the following cron expression schedules a maintenance
3077
3220
  # window to run on the third Tuesday of every month at 11:30 PM.
3078
3221
  #
3079
- # `cron(0 30 23 ? * TUE#3 *)`
3222
+ # `cron(30 23 ? * TUE#3 *)`
3080
3223
  #
3081
3224
  # If the schedule offset is `2`, the maintenance window won't run
3082
3225
  # until two days later.
@@ -3165,6 +3308,7 @@ module Aws::SSM
3165
3308
  #
3166
3309
  # {
3167
3310
  # description: "OpsItemDescription", # required
3311
+ # ops_item_type: "OpsItemType",
3168
3312
  # operational_data: {
3169
3313
  # "OpsItemDataKey" => {
3170
3314
  # value: "OpsItemDataValueString",
@@ -3192,12 +3336,21 @@ module Aws::SSM
3192
3336
  # ],
3193
3337
  # category: "OpsItemCategory",
3194
3338
  # severity: "OpsItemSeverity",
3339
+ # actual_start_time: Time.now,
3340
+ # actual_end_time: Time.now,
3341
+ # planned_start_time: Time.now,
3342
+ # planned_end_time: Time.now,
3195
3343
  # }
3196
3344
  #
3197
3345
  # @!attribute [rw] description
3198
3346
  # Information about the OpsItem.
3199
3347
  # @return [String]
3200
3348
  #
3349
+ # @!attribute [rw] ops_item_type
3350
+ # The type of OpsItem to create. Currently, the only valid values are
3351
+ # `/aws/changerequest` and `/aws/issue`.
3352
+ # @return [String]
3353
+ #
3201
3354
  # @!attribute [rw] operational_data
3202
3355
  # Operational data is custom data that provides useful reference
3203
3356
  # details about the OpsItem. For example, you can specify log files,
@@ -3287,10 +3440,33 @@ module Aws::SSM
3287
3440
  # Specify a severity to assign to an OpsItem.
3288
3441
  # @return [String]
3289
3442
  #
3443
+ # @!attribute [rw] actual_start_time
3444
+ # The time a runbook workflow started. Currently reported only for the
3445
+ # OpsItem type `/aws/changerequest`.
3446
+ # @return [Time]
3447
+ #
3448
+ # @!attribute [rw] actual_end_time
3449
+ # The time a runbook workflow ended. Currently reported only for the
3450
+ # OpsItem type `/aws/changerequest`.
3451
+ # @return [Time]
3452
+ #
3453
+ # @!attribute [rw] planned_start_time
3454
+ # The time specified in a change request for a runbook workflow to
3455
+ # start. Currently supported only for the OpsItem type
3456
+ # `/aws/changerequest`.
3457
+ # @return [Time]
3458
+ #
3459
+ # @!attribute [rw] planned_end_time
3460
+ # The time specified in a change request for a runbook workflow to
3461
+ # end. Currently supported only for the OpsItem type
3462
+ # `/aws/changerequest`.
3463
+ # @return [Time]
3464
+ #
3290
3465
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateOpsItemRequest AWS API Documentation
3291
3466
  #
3292
3467
  class CreateOpsItemRequest < Struct.new(
3293
3468
  :description,
3469
+ :ops_item_type,
3294
3470
  :operational_data,
3295
3471
  :notifications,
3296
3472
  :priority,
@@ -3299,7 +3475,11 @@ module Aws::SSM
3299
3475
  :title,
3300
3476
  :tags,
3301
3477
  :category,
3302
- :severity)
3478
+ :severity,
3479
+ :actual_start_time,
3480
+ :actual_end_time,
3481
+ :planned_start_time,
3482
+ :planned_end_time)
3303
3483
  SENSITIVE = []
3304
3484
  include Aws::Structure
3305
3485
  end
@@ -3329,11 +3509,11 @@ module Aws::SSM
3329
3509
  # }
3330
3510
  #
3331
3511
  # @!attribute [rw] resource_id
3332
- # A resource ID for a new AppManager application.
3512
+ # A resource ID for a new Application Manager application.
3333
3513
  # @return [String]
3334
3514
  #
3335
3515
  # @!attribute [rw] metadata
3336
- # Metadata for a new AppManager application.
3516
+ # Metadata for a new Application Manager application.
3337
3517
  # @return [Hash<String,Types::MetadataValue>]
3338
3518
  #
3339
3519
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateOpsMetadataRequest AWS API Documentation
@@ -4453,7 +4633,7 @@ module Aws::SSM
4453
4633
  # {
4454
4634
  # filters: [
4455
4635
  # {
4456
- # key: "DocumentNamePrefix", # required, accepts DocumentNamePrefix, ExecutionStatus, ExecutionId, ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter, AutomationType, TagKey, TargetResourceGroup
4636
+ # key: "DocumentNamePrefix", # required, accepts DocumentNamePrefix, ExecutionStatus, ExecutionId, ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter, AutomationType, TagKey, TargetResourceGroup, AutomationSubtype, OpsItemId
4457
4637
  # values: ["AutomationExecutionFilterValue"], # required
4458
4638
  # },
4459
4639
  # ],
@@ -4639,6 +4819,8 @@ module Aws::SSM
4639
4819
  # {
4640
4820
  # name: "DocumentName", # required
4641
4821
  # permission_type: "Share", # required, accepts Share
4822
+ # max_results: 1,
4823
+ # next_token: "NextToken",
4642
4824
  # }
4643
4825
  #
4644
4826
  # @!attribute [rw] name
@@ -4650,11 +4832,24 @@ module Aws::SSM
4650
4832
  # *Share*.
4651
4833
  # @return [String]
4652
4834
  #
4835
+ # @!attribute [rw] max_results
4836
+ # The maximum number of items to return for this call. The call also
4837
+ # returns a token that you can specify in a subsequent call to get the
4838
+ # next set of results.
4839
+ # @return [Integer]
4840
+ #
4841
+ # @!attribute [rw] next_token
4842
+ # The token for the next set of items to return. (You received this
4843
+ # token from a previous call.)
4844
+ # @return [String]
4845
+ #
4653
4846
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocumentPermissionRequest AWS API Documentation
4654
4847
  #
4655
4848
  class DescribeDocumentPermissionRequest < Struct.new(
4656
4849
  :name,
4657
- :permission_type)
4850
+ :permission_type,
4851
+ :max_results,
4852
+ :next_token)
4658
4853
  SENSITIVE = []
4659
4854
  include Aws::Structure
4660
4855
  end
@@ -4669,11 +4864,17 @@ module Aws::SSM
4669
4864
  # version shared with each account.
4670
4865
  # @return [Array<Types::AccountSharingInfo>]
4671
4866
  #
4867
+ # @!attribute [rw] next_token
4868
+ # The token for the next set of items to return. Use this token to get
4869
+ # the next set of results.
4870
+ # @return [String]
4871
+ #
4672
4872
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocumentPermissionResponse AWS API Documentation
4673
4873
  #
4674
4874
  class DescribeDocumentPermissionResponse < Struct.new(
4675
4875
  :account_ids,
4676
- :account_sharing_info_list)
4876
+ :account_sharing_info_list,
4877
+ :next_token)
4677
4878
  SENSITIVE = []
4678
4879
  include Aws::Structure
4679
4880
  end
@@ -5764,7 +5965,7 @@ module Aws::SSM
5764
5965
  # {
5765
5966
  # ops_item_filters: [
5766
5967
  # {
5767
- # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity
5968
+ # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup
5768
5969
  # values: ["OpsItemFilterValue"], # required
5769
5970
  # operator: "Equal", # required, accepts Equal, Contains, GreaterThan, LessThan
5770
5971
  # },
@@ -6448,6 +6649,27 @@ module Aws::SSM
6448
6649
  # `ApplicationConfigurationSchema` document.
6449
6650
  # @return [Array<Types::DocumentRequires>]
6450
6651
  #
6652
+ # @!attribute [rw] author
6653
+ # The user in your organization who created the document.
6654
+ # @return [String]
6655
+ #
6656
+ # @!attribute [rw] review_information
6657
+ # Details about the review of a document.
6658
+ # @return [Array<Types::ReviewInformation>]
6659
+ #
6660
+ # @!attribute [rw] approved_version
6661
+ # The version of the document currently approved for use in the
6662
+ # organization.
6663
+ # @return [String]
6664
+ #
6665
+ # @!attribute [rw] pending_review_version
6666
+ # The version of the document that is currently under review.
6667
+ # @return [String]
6668
+ #
6669
+ # @!attribute [rw] review_status
6670
+ # The current status of the review.
6671
+ # @return [String]
6672
+ #
6451
6673
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentDescription AWS API Documentation
6452
6674
  #
6453
6675
  class DocumentDescription < Struct.new(
@@ -6472,7 +6694,12 @@ module Aws::SSM
6472
6694
  :target_type,
6473
6695
  :tags,
6474
6696
  :attachments_information,
6475
- :requires)
6697
+ :requires,
6698
+ :author,
6699
+ :review_information,
6700
+ :approved_version,
6701
+ :pending_review_version,
6702
+ :review_status)
6476
6703
  SENSITIVE = []
6477
6704
  include Aws::Structure
6478
6705
  end
@@ -6561,6 +6788,14 @@ module Aws::SSM
6561
6788
  # `ApplicationConfigurationSchema` document.
6562
6789
  # @return [Array<Types::DocumentRequires>]
6563
6790
  #
6791
+ # @!attribute [rw] review_status
6792
+ # The current status of a document review.
6793
+ # @return [String]
6794
+ #
6795
+ # @!attribute [rw] author
6796
+ # The user in your organization who created the document.
6797
+ # @return [String]
6798
+ #
6564
6799
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentIdentifier AWS API Documentation
6565
6800
  #
6566
6801
  class DocumentIdentifier < Struct.new(
@@ -6574,7 +6809,9 @@ module Aws::SSM
6574
6809
  :document_format,
6575
6810
  :target_type,
6576
6811
  :tags,
6577
- :requires)
6812
+ :requires,
6813
+ :review_status,
6814
+ :author)
6578
6815
  SENSITIVE = []
6579
6816
  include Aws::Structure
6580
6817
  end
@@ -6695,6 +6932,20 @@ module Aws::SSM
6695
6932
  include Aws::Structure
6696
6933
  end
6697
6934
 
6935
+ # Details about the response to a document review request.
6936
+ #
6937
+ # @!attribute [rw] reviewer_response
6938
+ # Details about a reviewer's response to a document review request.
6939
+ # @return [Array<Types::DocumentReviewerResponseSource>]
6940
+ #
6941
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentMetadataResponseInfo AWS API Documentation
6942
+ #
6943
+ class DocumentMetadataResponseInfo < Struct.new(
6944
+ :reviewer_response)
6945
+ SENSITIVE = []
6946
+ include Aws::Structure
6947
+ end
6948
+
6698
6949
  # Parameters specified in a System Manager document that run on the
6699
6950
  # server when the command is run.
6700
6951
  #
@@ -6772,6 +7023,114 @@ module Aws::SSM
6772
7023
  include Aws::Structure
6773
7024
  end
6774
7025
 
7026
+ # Information about comments added to a document review request.
7027
+ #
7028
+ # @note When making an API call, you may pass DocumentReviewCommentSource
7029
+ # data as a hash:
7030
+ #
7031
+ # {
7032
+ # type: "Comment", # accepts Comment
7033
+ # content: "DocumentReviewComment",
7034
+ # }
7035
+ #
7036
+ # @!attribute [rw] type
7037
+ # The type of information added to a review request. Currently, only
7038
+ # the value `Comment` is supported.
7039
+ # @return [String]
7040
+ #
7041
+ # @!attribute [rw] content
7042
+ # The content of a comment entered by a user who requests a review of
7043
+ # a new document version, or who reviews the new version.
7044
+ # @return [String]
7045
+ #
7046
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentReviewCommentSource AWS API Documentation
7047
+ #
7048
+ class DocumentReviewCommentSource < Struct.new(
7049
+ :type,
7050
+ :content)
7051
+ SENSITIVE = []
7052
+ include Aws::Structure
7053
+ end
7054
+
7055
+ # Information about a reviewer's response to a document review request.
7056
+ #
7057
+ # @!attribute [rw] create_time
7058
+ # The date and time that a reviewer entered a response to a document
7059
+ # review request.
7060
+ # @return [Time]
7061
+ #
7062
+ # @!attribute [rw] updated_time
7063
+ # The date and time that a reviewer last updated a response to a
7064
+ # document review request.
7065
+ # @return [Time]
7066
+ #
7067
+ # @!attribute [rw] review_status
7068
+ # The current review status of a new custom SSM document created by a
7069
+ # member of your organization, or of the latest version of an existing
7070
+ # SSM document.
7071
+ #
7072
+ # Only one version of a document can be in the APPROVED state at a
7073
+ # time. When a new version is approved, the status of the previous
7074
+ # version changes to REJECTED.
7075
+ #
7076
+ # Only one version of a document can be in review, or PENDING, at a
7077
+ # time.
7078
+ # @return [String]
7079
+ #
7080
+ # @!attribute [rw] comment
7081
+ # The comment entered by a reviewer as part of their document review
7082
+ # response.
7083
+ # @return [Array<Types::DocumentReviewCommentSource>]
7084
+ #
7085
+ # @!attribute [rw] reviewer
7086
+ # The user in your organization assigned to review a document request.
7087
+ # @return [String]
7088
+ #
7089
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentReviewerResponseSource AWS API Documentation
7090
+ #
7091
+ class DocumentReviewerResponseSource < Struct.new(
7092
+ :create_time,
7093
+ :updated_time,
7094
+ :review_status,
7095
+ :comment,
7096
+ :reviewer)
7097
+ SENSITIVE = []
7098
+ include Aws::Structure
7099
+ end
7100
+
7101
+ # Information about a document approval review.
7102
+ #
7103
+ # @note When making an API call, you may pass DocumentReviews
7104
+ # data as a hash:
7105
+ #
7106
+ # {
7107
+ # action: "SendForReview", # required, accepts SendForReview, UpdateReview, Approve, Reject
7108
+ # comment: [
7109
+ # {
7110
+ # type: "Comment", # accepts Comment
7111
+ # content: "DocumentReviewComment",
7112
+ # },
7113
+ # ],
7114
+ # }
7115
+ #
7116
+ # @!attribute [rw] action
7117
+ # The action to take on a document approval review request.
7118
+ # @return [String]
7119
+ #
7120
+ # @!attribute [rw] comment
7121
+ # A comment entered by a user in your organization about the document
7122
+ # review request.
7123
+ # @return [Array<Types::DocumentReviewCommentSource>]
7124
+ #
7125
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentReviews AWS API Documentation
7126
+ #
7127
+ class DocumentReviews < Struct.new(
7128
+ :action,
7129
+ :comment)
7130
+ SENSITIVE = []
7131
+ include Aws::Structure
7132
+ end
7133
+
6775
7134
  # Version information about the document.
6776
7135
  #
6777
7136
  # @!attribute [rw] name
@@ -6812,6 +7171,11 @@ module Aws::SSM
6812
7171
  # exist. Verify that the URL of the S3 bucket is correct."
6813
7172
  # @return [String]
6814
7173
  #
7174
+ # @!attribute [rw] review_status
7175
+ # The current status of the approval review for the latest version of
7176
+ # the document.
7177
+ # @return [String]
7178
+ #
6815
7179
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DocumentVersionInfo AWS API Documentation
6816
7180
  #
6817
7181
  class DocumentVersionInfo < Struct.new(
@@ -6822,7 +7186,8 @@ module Aws::SSM
6822
7186
  :is_default_version,
6823
7187
  :document_format,
6824
7188
  :status,
6825
- :status_information)
7189
+ :status_information,
7190
+ :review_status)
6826
7191
  SENSITIVE = []
6827
7192
  include Aws::Structure
6828
7193
  end
@@ -7527,6 +7892,19 @@ module Aws::SSM
7527
7892
  # locations, sizes, and so on.
7528
7893
  # @return [Array<Types::AttachmentContent>]
7529
7894
  #
7895
+ # @!attribute [rw] review_status
7896
+ # The current review status of a new custom Systems Manager document
7897
+ # (SSM document) created by a member of your organization, or of the
7898
+ # latest version of an existing SSM document.
7899
+ #
7900
+ # Only one version of an SSM document can be in the APPROVED state at
7901
+ # a time. When a new version is approved, the status of the previous
7902
+ # version changes to REJECTED.
7903
+ #
7904
+ # Only one version of an SSM document can be in review, or PENDING, at
7905
+ # a time.
7906
+ # @return [String]
7907
+ #
7530
7908
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetDocumentResult AWS API Documentation
7531
7909
  #
7532
7910
  class GetDocumentResult < Struct.new(
@@ -7539,7 +7917,8 @@ module Aws::SSM
7539
7917
  :document_type,
7540
7918
  :document_format,
7541
7919
  :requires,
7542
- :attachments_content)
7920
+ :attachments_content,
7921
+ :review_status)
7543
7922
  SENSITIVE = []
7544
7923
  include Aws::Structure
7545
7924
  end
@@ -8039,8 +8418,8 @@ module Aws::SSM
8039
8418
  # @!attribute [rw] schedule_timezone
8040
8419
  # The time zone that the scheduled maintenance window executions are
8041
8420
  # based on, in Internet Assigned Numbers Authority (IANA) format. For
8042
- # example: "America/Los\_Angeles", "etc/UTC", or "Asia/Seoul".
8043
- # For more information, see the [Time Zone Database][1] on the IANA
8421
+ # example: "America/Los\_Angeles", "UTC", or "Asia/Seoul". For
8422
+ # more information, see the [Time Zone Database][1] on the IANA
8044
8423
  # website.
8045
8424
  #
8046
8425
  #
@@ -8186,11 +8565,27 @@ module Aws::SSM
8186
8565
  #
8187
8566
  # @!attribute [rw] max_concurrency
8188
8567
  # The maximum number of targets allowed to run this task in parallel.
8568
+ #
8569
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8570
+ # supply a value for this option. Instead, the system inserts a
8571
+ # placeholder value of `1`, which may be reported in the response to
8572
+ # this command. This value does not affect the running of your task
8573
+ # and can be ignored.
8574
+ #
8575
+ # </note>
8189
8576
  # @return [String]
8190
8577
  #
8191
8578
  # @!attribute [rw] max_errors
8192
8579
  # The maximum number of errors allowed before the task stops being
8193
8580
  # scheduled.
8581
+ #
8582
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8583
+ # supply a value for this option. Instead, the system inserts a
8584
+ # placeholder value of `1`, which may be reported in the response to
8585
+ # this command. This value does not affect the running of your task
8586
+ # and can be ignored.
8587
+ #
8588
+ # </note>
8194
8589
  # @return [String]
8195
8590
  #
8196
8591
  # @!attribute [rw] logging_info
@@ -8301,11 +8696,11 @@ module Aws::SSM
8301
8696
  end
8302
8697
 
8303
8698
  # @!attribute [rw] resource_id
8304
- # The resource ID of the AppManager application.
8699
+ # The resource ID of the Application Manager application.
8305
8700
  # @return [String]
8306
8701
  #
8307
8702
  # @!attribute [rw] metadata
8308
- # OpsMetadata for an AppManager application.
8703
+ # OpsMetadata for an Application Manager application.
8309
8704
  # @return [Hash<String,Types::MetadataValue>]
8310
8705
  #
8311
8706
  # @!attribute [rw] next_token
@@ -8540,9 +8935,11 @@ module Aws::SSM
8540
8935
  #
8541
8936
  # @!attribute [rw] path
8542
8937
  # The hierarchy for the parameter. Hierarchies start with a forward
8543
- # slash (/) and end with the parameter name. A parameter name
8544
- # hierarchy can have a maximum of 15 levels. Here is an example of a
8545
- # hierarchy: `/Finance/Prod/IAD/WinServ2016/license33`
8938
+ # slash (/). The hierachy is the parameter name except the last part
8939
+ # of the parameter. For the API call to succeeed, the last part of the
8940
+ # parameter name cannot be in the path. A parameter name hierarchy can
8941
+ # have a maximum of 15 levels. Here is an example of a hierarchy:
8942
+ # `/Finance/Prod/IAD/WinServ2016/license33 `
8546
8943
  # @return [String]
8547
8944
  #
8548
8945
  # @!attribute [rw] recursive
@@ -9107,7 +9504,8 @@ module Aws::SSM
9107
9504
  # @return [String]
9108
9505
  #
9109
9506
  # @!attribute [rw] last_ping_date_time
9110
- # The date and time when agent last pinged Systems Manager service.
9507
+ # The date and time when the agent last pinged the Systems Manager
9508
+ # service.
9111
9509
  # @return [Time]
9112
9510
  #
9113
9511
  # @!attribute [rw] agent_version
@@ -11073,56 +11471,138 @@ module Aws::SSM
11073
11471
  include Aws::Structure
11074
11472
  end
11075
11473
 
11076
- # @note When making an API call, you may pass ListDocumentVersionsRequest
11474
+ # @note When making an API call, you may pass ListDocumentMetadataHistoryRequest
11077
11475
  # data as a hash:
11078
11476
  #
11079
11477
  # {
11080
- # name: "DocumentARN", # required
11081
- # max_results: 1,
11478
+ # name: "DocumentName", # required
11479
+ # document_version: "DocumentVersion",
11480
+ # metadata: "DocumentReviews", # required, accepts DocumentReviews
11082
11481
  # next_token: "NextToken",
11482
+ # max_results: 1,
11083
11483
  # }
11084
11484
  #
11085
11485
  # @!attribute [rw] name
11086
- # The name of the document. You can specify an Amazon Resource Name
11087
- # (ARN).
11486
+ # The name of the document.
11088
11487
  # @return [String]
11089
11488
  #
11090
- # @!attribute [rw] max_results
11091
- # The maximum number of items to return for this call. The call also
11092
- # returns a token that you can specify in a subsequent call to get the
11093
- # next set of results.
11094
- # @return [Integer]
11489
+ # @!attribute [rw] document_version
11490
+ # The version of the document.
11491
+ # @return [String]
11492
+ #
11493
+ # @!attribute [rw] metadata
11494
+ # The type of data for which details are being requested. Currently,
11495
+ # the only supported value is `DocumentReviews`.
11496
+ # @return [String]
11095
11497
  #
11096
11498
  # @!attribute [rw] next_token
11097
11499
  # The token for the next set of items to return. (You received this
11098
11500
  # token from a previous call.)
11099
11501
  # @return [String]
11100
11502
  #
11101
- # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentVersionsRequest AWS API Documentation
11503
+ # @!attribute [rw] max_results
11504
+ # The maximum number of items to return for this call. The call also
11505
+ # returns a token that you can specify in a subsequent call to get the
11506
+ # next set of results.
11507
+ # @return [Integer]
11102
11508
  #
11103
- class ListDocumentVersionsRequest < Struct.new(
11509
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentMetadataHistoryRequest AWS API Documentation
11510
+ #
11511
+ class ListDocumentMetadataHistoryRequest < Struct.new(
11104
11512
  :name,
11105
- :max_results,
11106
- :next_token)
11513
+ :document_version,
11514
+ :metadata,
11515
+ :next_token,
11516
+ :max_results)
11107
11517
  SENSITIVE = []
11108
11518
  include Aws::Structure
11109
11519
  end
11110
11520
 
11111
- # @!attribute [rw] document_versions
11112
- # The document versions.
11113
- # @return [Array<Types::DocumentVersionInfo>]
11521
+ # @!attribute [rw] name
11522
+ # The name of the document.
11523
+ # @return [String]
11114
11524
  #
11115
- # @!attribute [rw] next_token
11116
- # The token to use when requesting the next set of items. If there are
11117
- # no additional items to return, the string is empty.
11525
+ # @!attribute [rw] document_version
11526
+ # The version of the document.
11118
11527
  # @return [String]
11119
11528
  #
11120
- # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentVersionsResult AWS API Documentation
11529
+ # @!attribute [rw] author
11530
+ # The user ID of the person in the organization who requested the
11531
+ # document review.
11532
+ # @return [String]
11121
11533
  #
11122
- class ListDocumentVersionsResult < Struct.new(
11123
- :document_versions,
11124
- :next_token)
11125
- SENSITIVE = []
11534
+ # @!attribute [rw] metadata
11535
+ # Information about the response to the document approval request.
11536
+ # @return [Types::DocumentMetadataResponseInfo]
11537
+ #
11538
+ # @!attribute [rw] next_token
11539
+ # The maximum number of items to return for this call. The call also
11540
+ # returns a token that you can specify in a subsequent call to get the
11541
+ # next set of results.
11542
+ # @return [String]
11543
+ #
11544
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentMetadataHistoryResponse AWS API Documentation
11545
+ #
11546
+ class ListDocumentMetadataHistoryResponse < Struct.new(
11547
+ :name,
11548
+ :document_version,
11549
+ :author,
11550
+ :metadata,
11551
+ :next_token)
11552
+ SENSITIVE = []
11553
+ include Aws::Structure
11554
+ end
11555
+
11556
+ # @note When making an API call, you may pass ListDocumentVersionsRequest
11557
+ # data as a hash:
11558
+ #
11559
+ # {
11560
+ # name: "DocumentARN", # required
11561
+ # max_results: 1,
11562
+ # next_token: "NextToken",
11563
+ # }
11564
+ #
11565
+ # @!attribute [rw] name
11566
+ # The name of the document. You can specify an Amazon Resource Name
11567
+ # (ARN).
11568
+ # @return [String]
11569
+ #
11570
+ # @!attribute [rw] max_results
11571
+ # The maximum number of items to return for this call. The call also
11572
+ # returns a token that you can specify in a subsequent call to get the
11573
+ # next set of results.
11574
+ # @return [Integer]
11575
+ #
11576
+ # @!attribute [rw] next_token
11577
+ # The token for the next set of items to return. (You received this
11578
+ # token from a previous call.)
11579
+ # @return [String]
11580
+ #
11581
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentVersionsRequest AWS API Documentation
11582
+ #
11583
+ class ListDocumentVersionsRequest < Struct.new(
11584
+ :name,
11585
+ :max_results,
11586
+ :next_token)
11587
+ SENSITIVE = []
11588
+ include Aws::Structure
11589
+ end
11590
+
11591
+ # @!attribute [rw] document_versions
11592
+ # The document versions.
11593
+ # @return [Array<Types::DocumentVersionInfo>]
11594
+ #
11595
+ # @!attribute [rw] next_token
11596
+ # The token to use when requesting the next set of items. If there are
11597
+ # no additional items to return, the string is empty.
11598
+ # @return [String]
11599
+ #
11600
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListDocumentVersionsResult AWS API Documentation
11601
+ #
11602
+ class ListDocumentVersionsResult < Struct.new(
11603
+ :document_versions,
11604
+ :next_token)
11605
+ SENSITIVE = []
11126
11606
  include Aws::Structure
11127
11607
  end
11128
11608
 
@@ -11151,13 +11631,19 @@ module Aws::SSM
11151
11631
  # @return [Array<Types::DocumentFilter>]
11152
11632
  #
11153
11633
  # @!attribute [rw] filters
11154
- # One or more DocumentKeyValuesFilter objects. Use a filter to return
11155
- # a more specific list of results. For keys, you can specify one or
11156
- # more key-value pair tags that have been applied to a document. Other
11157
- # valid keys include `Owner`, `Name`, `PlatformTypes`, `DocumentType`,
11158
- # and `TargetType`. For example, to return documents you own use
11159
- # `Key=Owner,Values=Self`. To specify a custom key-value pair, use the
11160
- # format `Key=tag:tagName,Values=valueName`.
11634
+ # One or more `DocumentKeyValuesFilter` objects. Use a filter to
11635
+ # return a more specific list of results. For keys, you can specify
11636
+ # one or more key-value pair tags that have been applied to a
11637
+ # document. Other valid keys include `Owner`, `Name`, `PlatformTypes`,
11638
+ # `DocumentType`, and `TargetType`. For example, to return documents
11639
+ # you own use `Key=Owner,Values=Self`. To specify a custom key-value
11640
+ # pair, use the format `Key=tag:tagName,Values=valueName`.
11641
+ #
11642
+ # <note markdown="1"> This API action only supports filtering documents by using a single
11643
+ # tag key and one or more tag values. For example:
11644
+ # `Key=tag:tagName,Values=valueName1,valueName2`
11645
+ #
11646
+ # </note>
11161
11647
  # @return [Array<Types::DocumentKeyValuesFilter>]
11162
11648
  #
11163
11649
  # @!attribute [rw] max_results
@@ -11293,6 +11779,65 @@ module Aws::SSM
11293
11779
  include Aws::Structure
11294
11780
  end
11295
11781
 
11782
+ # @note When making an API call, you may pass ListOpsItemEventsRequest
11783
+ # data as a hash:
11784
+ #
11785
+ # {
11786
+ # filters: [
11787
+ # {
11788
+ # key: "OpsItemId", # required, accepts OpsItemId
11789
+ # values: ["OpsItemEventFilterValue"], # required
11790
+ # operator: "Equal", # required, accepts Equal
11791
+ # },
11792
+ # ],
11793
+ # max_results: 1,
11794
+ # next_token: "String",
11795
+ # }
11796
+ #
11797
+ # @!attribute [rw] filters
11798
+ # One or more OpsItem filters. Use a filter to return a more specific
11799
+ # list of results.
11800
+ # @return [Array<Types::OpsItemEventFilter>]
11801
+ #
11802
+ # @!attribute [rw] max_results
11803
+ # The maximum number of items to return for this call. The call also
11804
+ # returns a token that you can specify in a subsequent call to get the
11805
+ # next set of results.
11806
+ # @return [Integer]
11807
+ #
11808
+ # @!attribute [rw] next_token
11809
+ # A token to start the list. Use this token to get the next set of
11810
+ # results.
11811
+ # @return [String]
11812
+ #
11813
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListOpsItemEventsRequest AWS API Documentation
11814
+ #
11815
+ class ListOpsItemEventsRequest < Struct.new(
11816
+ :filters,
11817
+ :max_results,
11818
+ :next_token)
11819
+ SENSITIVE = []
11820
+ include Aws::Structure
11821
+ end
11822
+
11823
+ # @!attribute [rw] next_token
11824
+ # The token for the next set of items to return. Use this token to get
11825
+ # the next set of results.
11826
+ # @return [String]
11827
+ #
11828
+ # @!attribute [rw] summaries
11829
+ # A list of event information for the specified OpsItems.
11830
+ # @return [Array<Types::OpsItemEventSummary>]
11831
+ #
11832
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListOpsItemEventsResponse AWS API Documentation
11833
+ #
11834
+ class ListOpsItemEventsResponse < Struct.new(
11835
+ :next_token,
11836
+ :summaries)
11837
+ SENSITIVE = []
11838
+ include Aws::Structure
11839
+ end
11840
+
11296
11841
  # @note When making an API call, you may pass ListOpsMetadataRequest
11297
11842
  # data as a hash:
11298
11843
  #
@@ -12394,7 +12939,7 @@ module Aws::SSM
12394
12939
  include Aws::Structure
12395
12940
  end
12396
12941
 
12397
- # Metadata to assign to an AppManager application.
12942
+ # Metadata to assign to an Application Manager application.
12398
12943
  #
12399
12944
  # @note When making an API call, you may pass MetadataValue
12400
12945
  # data as a hash:
@@ -12404,7 +12949,7 @@ module Aws::SSM
12404
12949
  # }
12405
12950
  #
12406
12951
  # @!attribute [rw] value
12407
- # Metadata value to assign to an AppManager application.
12952
+ # Metadata value to assign to an Application Manager application.
12408
12953
  # @return [String]
12409
12954
  #
12410
12955
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/MetadataValue AWS API Documentation
@@ -12701,6 +13246,11 @@ module Aws::SSM
12701
13246
  # The ARN of the AWS account that created the OpsItem.
12702
13247
  # @return [String]
12703
13248
  #
13249
+ # @!attribute [rw] ops_item_type
13250
+ # The type of OpsItem. Currently, the only valid values are
13251
+ # `/aws/changerequest` and `/aws/issue`.
13252
+ # @return [String]
13253
+ #
12704
13254
  # @!attribute [rw] created_time
12705
13255
  # The date and time the OpsItem was created.
12706
13256
  # @return [Time]
@@ -12802,10 +13352,33 @@ module Aws::SSM
12802
13352
  # The severity of the OpsItem. Severity options range from 1 to 4.
12803
13353
  # @return [String]
12804
13354
  #
13355
+ # @!attribute [rw] actual_start_time
13356
+ # The time a runbook workflow started. Currently reported only for the
13357
+ # OpsItem type `/aws/changerequest`.
13358
+ # @return [Time]
13359
+ #
13360
+ # @!attribute [rw] actual_end_time
13361
+ # The time a runbook workflow ended. Currently reported only for the
13362
+ # OpsItem type `/aws/changerequest`.
13363
+ # @return [Time]
13364
+ #
13365
+ # @!attribute [rw] planned_start_time
13366
+ # The time specified in a change request for a runbook workflow to
13367
+ # start. Currently supported only for the OpsItem type
13368
+ # `/aws/changerequest`.
13369
+ # @return [Time]
13370
+ #
13371
+ # @!attribute [rw] planned_end_time
13372
+ # The time specified in a change request for a runbook workflow to
13373
+ # end. Currently supported only for the OpsItem type
13374
+ # `/aws/changerequest`.
13375
+ # @return [Time]
13376
+ #
12805
13377
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/OpsItem AWS API Documentation
12806
13378
  #
12807
13379
  class OpsItem < Struct.new(
12808
13380
  :created_by,
13381
+ :ops_item_type,
12809
13382
  :created_time,
12810
13383
  :description,
12811
13384
  :last_modified_by,
@@ -12820,7 +13393,11 @@ module Aws::SSM
12820
13393
  :source,
12821
13394
  :operational_data,
12822
13395
  :category,
12823
- :severity)
13396
+ :severity,
13397
+ :actual_start_time,
13398
+ :actual_end_time,
13399
+ :planned_start_time,
13400
+ :planned_end_time)
12824
13401
  SENSITIVE = []
12825
13402
  include Aws::Structure
12826
13403
  end
@@ -12871,13 +13448,95 @@ module Aws::SSM
12871
13448
  include Aws::Structure
12872
13449
  end
12873
13450
 
13451
+ # Describes a filter for a specific list of OpsItem events. You can
13452
+ # filter event information by using tags. You specify tags by using a
13453
+ # key-value pair mapping.
13454
+ #
13455
+ # @note When making an API call, you may pass OpsItemEventFilter
13456
+ # data as a hash:
13457
+ #
13458
+ # {
13459
+ # key: "OpsItemId", # required, accepts OpsItemId
13460
+ # values: ["OpsItemEventFilterValue"], # required
13461
+ # operator: "Equal", # required, accepts Equal
13462
+ # }
13463
+ #
13464
+ # @!attribute [rw] key
13465
+ # The name of the filter key. Currently, the only supported value is
13466
+ # `OpsItemId`.
13467
+ # @return [String]
13468
+ #
13469
+ # @!attribute [rw] values
13470
+ # The values for the filter, consisting of one or more OpsItem IDs.
13471
+ # @return [Array<String>]
13472
+ #
13473
+ # @!attribute [rw] operator
13474
+ # The operator used by the filter call. Currently, the only supported
13475
+ # value is `Equal`.
13476
+ # @return [String]
13477
+ #
13478
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/OpsItemEventFilter AWS API Documentation
13479
+ #
13480
+ class OpsItemEventFilter < Struct.new(
13481
+ :key,
13482
+ :values,
13483
+ :operator)
13484
+ SENSITIVE = []
13485
+ include Aws::Structure
13486
+ end
13487
+
13488
+ # Summary information about an OpsItem event.
13489
+ #
13490
+ # @!attribute [rw] ops_item_id
13491
+ # The ID of the OpsItem.
13492
+ # @return [String]
13493
+ #
13494
+ # @!attribute [rw] event_id
13495
+ # The ID of the OpsItem event.
13496
+ # @return [String]
13497
+ #
13498
+ # @!attribute [rw] source
13499
+ # The source of the OpsItem event.
13500
+ # @return [String]
13501
+ #
13502
+ # @!attribute [rw] detail_type
13503
+ # The type of information provided as a detail.
13504
+ # @return [String]
13505
+ #
13506
+ # @!attribute [rw] detail
13507
+ # Specific information about the OpsItem event.
13508
+ # @return [String]
13509
+ #
13510
+ # @!attribute [rw] created_by
13511
+ # Information about the user or resource that created the OpsItem
13512
+ # event.
13513
+ # @return [Types::OpsItemIdentity]
13514
+ #
13515
+ # @!attribute [rw] created_time
13516
+ # The date and time the OpsItem event was created.
13517
+ # @return [Time]
13518
+ #
13519
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/OpsItemEventSummary AWS API Documentation
13520
+ #
13521
+ class OpsItemEventSummary < Struct.new(
13522
+ :ops_item_id,
13523
+ :event_id,
13524
+ :source,
13525
+ :detail_type,
13526
+ :detail,
13527
+ :created_by,
13528
+ :created_time)
13529
+ SENSITIVE = []
13530
+ include Aws::Structure
13531
+ end
13532
+
12874
13533
  # Describes an OpsItem filter.
12875
13534
  #
12876
13535
  # @note When making an API call, you may pass OpsItemFilter
12877
13536
  # data as a hash:
12878
13537
  #
12879
13538
  # {
12880
- # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity
13539
+ # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup
12881
13540
  # values: ["OpsItemFilterValue"], # required
12882
13541
  # operator: "Equal", # required, accepts Equal, Contains, GreaterThan, LessThan
12883
13542
  # }
@@ -12904,6 +13563,21 @@ module Aws::SSM
12904
13563
  include Aws::Structure
12905
13564
  end
12906
13565
 
13566
+ # Information about the user or resource that created an OpsItem event.
13567
+ #
13568
+ # @!attribute [rw] arn
13569
+ # The Amazon Resource Name (ARN) of the IAM entity that created the
13570
+ # OpsItem event.
13571
+ # @return [String]
13572
+ #
13573
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/OpsItemIdentity AWS API Documentation
13574
+ #
13575
+ class OpsItemIdentity < Struct.new(
13576
+ :arn)
13577
+ SENSITIVE = []
13578
+ include Aws::Structure
13579
+ end
13580
+
12907
13581
  # A specified parameter argument isn't valid. Verify the available
12908
13582
  # arguments and try again.
12909
13583
  #
@@ -13044,6 +13718,33 @@ module Aws::SSM
13044
13718
  # A list of OpsItems by severity.
13045
13719
  # @return [String]
13046
13720
  #
13721
+ # @!attribute [rw] ops_item_type
13722
+ # The type of OpsItem. Currently, the only valid values are
13723
+ # `/aws/changerequest` and `/aws/issue`.
13724
+ # @return [String]
13725
+ #
13726
+ # @!attribute [rw] actual_start_time
13727
+ # The time a runbook workflow started. Currently reported only for the
13728
+ # OpsItem type `/aws/changerequest`.
13729
+ # @return [Time]
13730
+ #
13731
+ # @!attribute [rw] actual_end_time
13732
+ # The time a runbook workflow ended. Currently reported only for the
13733
+ # OpsItem type `/aws/changerequest`.
13734
+ # @return [Time]
13735
+ #
13736
+ # @!attribute [rw] planned_start_time
13737
+ # The time specified in a change request for a runbook workflow to
13738
+ # start. Currently supported only for the OpsItem type
13739
+ # `/aws/changerequest`.
13740
+ # @return [Time]
13741
+ #
13742
+ # @!attribute [rw] planned_end_time
13743
+ # The time specified in a change request for a runbook workflow to
13744
+ # end. Currently supported only for the OpsItem type
13745
+ # `/aws/changerequest`.
13746
+ # @return [Time]
13747
+ #
13047
13748
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/OpsItemSummary AWS API Documentation
13048
13749
  #
13049
13750
  class OpsItemSummary < Struct.new(
@@ -13058,15 +13759,20 @@ module Aws::SSM
13058
13759
  :title,
13059
13760
  :operational_data,
13060
13761
  :category,
13061
- :severity)
13762
+ :severity,
13763
+ :ops_item_type,
13764
+ :actual_start_time,
13765
+ :actual_end_time,
13766
+ :planned_start_time,
13767
+ :planned_end_time)
13062
13768
  SENSITIVE = []
13063
13769
  include Aws::Structure
13064
13770
  end
13065
13771
 
13066
- # Operational metadata for an application in AppManager.
13772
+ # Operational metadata for an application in Application Manager.
13067
13773
  #
13068
13774
  # @!attribute [rw] resource_id
13069
- # The ID of the AppManager application.
13775
+ # The ID of the Application Manager application.
13070
13776
  # @return [String]
13071
13777
  #
13072
13778
  # @!attribute [rw] ops_metadata_arn
@@ -13151,7 +13857,7 @@ module Aws::SSM
13151
13857
  end
13152
13858
 
13153
13859
  # The OpsMetadata object exceeds the maximum number of OpsMetadata keys
13154
- # that you can assign to an application in AppManager.
13860
+ # that you can assign to an application in Application Manager.
13155
13861
  #
13156
13862
  # @!attribute [rw] message
13157
13863
  # @return [String]
@@ -13165,8 +13871,8 @@ module Aws::SSM
13165
13871
  end
13166
13872
 
13167
13873
  # Your account reached the maximum number of OpsMetadata objects allowed
13168
- # by AppManager. The maximum is 200 OpsMetadata objects. Delete one or
13169
- # more OpsMetadata object and try again.
13874
+ # by Application Manager. The maximum is 200 OpsMetadata objects. Delete
13875
+ # one or more OpsMetadata object and try again.
13170
13876
  #
13171
13877
  # @!attribute [rw] message
13172
13878
  # @return [String]
@@ -14197,11 +14903,20 @@ module Aws::SSM
14197
14903
  #
14198
14904
  # `[main]`
14199
14905
  #
14200
- # `cachedir=/var/cache/yum/$basesearch$releasever`
14906
+ # `name=MyCustomRepository`
14907
+ #
14908
+ # `baseurl=https://my-custom-repository`
14909
+ #
14910
+ # `enabled=1`
14911
+ #
14912
+ # <note markdown="1"> For information about other options available for your yum
14913
+ # repository configuration, see [dnf.conf(5)][1].
14914
+ #
14915
+ # </note>
14201
14916
  #
14202
- # `keepcache=0`
14203
14917
  #
14204
- # `debuglevel=2`
14918
+ #
14919
+ # [1]: https://man7.org/linux/man-pages/man5/dnf.conf.5.html
14205
14920
  # @return [String]
14206
14921
  #
14207
14922
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchSource AWS API Documentation
@@ -14965,7 +15680,7 @@ module Aws::SSM
14965
15680
  #
14966
15681
  # {
14967
15682
  # window_id: "MaintenanceWindowId", # required
14968
- # targets: [ # required
15683
+ # targets: [
14969
15684
  # {
14970
15685
  # key: "TargetKey",
14971
15686
  # values: ["TargetValue"],
@@ -15019,8 +15734,8 @@ module Aws::SSM
15019
15734
  # },
15020
15735
  # },
15021
15736
  # priority: 1,
15022
- # max_concurrency: "MaxConcurrency", # required
15023
- # max_errors: "MaxErrors", # required
15737
+ # max_concurrency: "MaxConcurrency",
15738
+ # max_errors: "MaxErrors",
15024
15739
  # logging_info: {
15025
15740
  # s3_bucket_name: "S3BucketName", # required
15026
15741
  # s3_key_prefix: "S3KeyPrefix",
@@ -15038,13 +15753,26 @@ module Aws::SSM
15038
15753
  # @!attribute [rw] targets
15039
15754
  # The targets (either instances or maintenance window targets).
15040
15755
  #
15756
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
15757
+ # Command-type tasks. Depending on the task, targets are optional for
15758
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
15759
+ # Step Functions). For more information about running tasks that do
15760
+ # not specify targets, see [Registering maintenance window tasks
15761
+ # without targets][1] in the *AWS Systems Manager User Guide*.
15762
+ #
15763
+ # </note>
15764
+ #
15041
15765
  # Specify instances using the following format:
15042
15766
  #
15043
15767
  # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
15044
15768
  #
15045
15769
  # Specify maintenance window targets using the following format:
15046
15770
  #
15047
- # `Key=WindowTargetIds;,Values=<window-target-id-1>,<window-target-id-2>`
15771
+ # `Key=WindowTargetIds,Values=<window-target-id-1>,<window-target-id-2>`
15772
+ #
15773
+ #
15774
+ #
15775
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
15048
15776
  # @return [Array<Types::Target>]
15049
15777
  #
15050
15778
  # @!attribute [rw] task_arn
@@ -15104,11 +15832,25 @@ module Aws::SSM
15104
15832
  #
15105
15833
  # @!attribute [rw] max_concurrency
15106
15834
  # The maximum number of targets this task can be run for in parallel.
15835
+ #
15836
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
15837
+ # supply a value for this option. Instead, the system inserts a
15838
+ # placeholder value of `1`. This value does not affect the running of
15839
+ # your task.
15840
+ #
15841
+ # </note>
15107
15842
  # @return [String]
15108
15843
  #
15109
15844
  # @!attribute [rw] max_errors
15110
15845
  # The maximum number of errors allowed before this task stops being
15111
15846
  # scheduled.
15847
+ #
15848
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
15849
+ # supply a value for this option. Instead, the system inserts a
15850
+ # placeholder value of `1`. This value does not affect the running of
15851
+ # your task.
15852
+ #
15853
+ # </note>
15112
15854
  # @return [String]
15113
15855
  #
15114
15856
  # @!attribute [rw] logging_info
@@ -15874,6 +16616,126 @@ module Aws::SSM
15874
16616
  include Aws::Structure
15875
16617
  end
15876
16618
 
16619
+ # Information about the result of a document review request.
16620
+ #
16621
+ # @!attribute [rw] reviewed_time
16622
+ # The time that the reviewer took action on the document review
16623
+ # request.
16624
+ # @return [Time]
16625
+ #
16626
+ # @!attribute [rw] status
16627
+ # The current status of the document review request.
16628
+ # @return [String]
16629
+ #
16630
+ # @!attribute [rw] reviewer
16631
+ # The reviewer assigned to take action on the document review request.
16632
+ # @return [String]
16633
+ #
16634
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ReviewInformation AWS API Documentation
16635
+ #
16636
+ class ReviewInformation < Struct.new(
16637
+ :reviewed_time,
16638
+ :status,
16639
+ :reviewer)
16640
+ SENSITIVE = []
16641
+ include Aws::Structure
16642
+ end
16643
+
16644
+ # Information about an Automation runbook (Automation document) used in
16645
+ # a runbook workflow in Change Manager.
16646
+ #
16647
+ # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't run
16648
+ # until all required approvals for the change request have been
16649
+ # received.
16650
+ #
16651
+ # </note>
16652
+ #
16653
+ # @note When making an API call, you may pass Runbook
16654
+ # data as a hash:
16655
+ #
16656
+ # {
16657
+ # document_name: "DocumentARN", # required
16658
+ # document_version: "DocumentVersion",
16659
+ # parameters: {
16660
+ # "AutomationParameterKey" => ["AutomationParameterValue"],
16661
+ # },
16662
+ # target_parameter_name: "AutomationParameterKey",
16663
+ # targets: [
16664
+ # {
16665
+ # key: "TargetKey",
16666
+ # values: ["TargetValue"],
16667
+ # },
16668
+ # ],
16669
+ # max_concurrency: "MaxConcurrency",
16670
+ # max_errors: "MaxErrors",
16671
+ # target_locations: [
16672
+ # {
16673
+ # accounts: ["Account"],
16674
+ # regions: ["Region"],
16675
+ # target_location_max_concurrency: "MaxConcurrency",
16676
+ # target_location_max_errors: "MaxErrors",
16677
+ # execution_role_name: "ExecutionRoleName",
16678
+ # },
16679
+ # ],
16680
+ # }
16681
+ #
16682
+ # @!attribute [rw] document_name
16683
+ # The name of the Automation runbook (Automation document) used in a
16684
+ # runbook workflow.
16685
+ # @return [String]
16686
+ #
16687
+ # @!attribute [rw] document_version
16688
+ # The version of the Automation runbook (Automation document) used in
16689
+ # a runbook workflow.
16690
+ # @return [String]
16691
+ #
16692
+ # @!attribute [rw] parameters
16693
+ # The key-value map of execution parameters, which were supplied when
16694
+ # calling `StartChangeRequestExecution`.
16695
+ # @return [Hash<String,Array<String>>]
16696
+ #
16697
+ # @!attribute [rw] target_parameter_name
16698
+ # The name of the parameter used as the target resource for the
16699
+ # rate-controlled runbook workflow. Required if you specify `Targets`.
16700
+ # @return [String]
16701
+ #
16702
+ # @!attribute [rw] targets
16703
+ # A key-value mapping to target resources that the Runbook operation
16704
+ # performs tasks on. Required if you specify `TargetParameterName`.
16705
+ # @return [Array<Types::Target>]
16706
+ #
16707
+ # @!attribute [rw] max_concurrency
16708
+ # The `MaxConcurrency` value specified by the user when the operation
16709
+ # started, indicating the maximum number of resources that the runbook
16710
+ # operation can run on at the same time.
16711
+ # @return [String]
16712
+ #
16713
+ # @!attribute [rw] max_errors
16714
+ # The `MaxErrors` value specified by the user when the execution
16715
+ # started, indicating the maximum number of errors that can occur
16716
+ # during the operation before the updates are stopped or rolled back.
16717
+ # @return [String]
16718
+ #
16719
+ # @!attribute [rw] target_locations
16720
+ # Information about the AWS Regions and accounts targeted by the
16721
+ # current Runbook operation.
16722
+ # @return [Array<Types::TargetLocation>]
16723
+ #
16724
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Runbook AWS API Documentation
16725
+ #
16726
+ class Runbook < Struct.new(
16727
+ :document_name,
16728
+ :document_version,
16729
+ :parameters,
16730
+ :target_parameter_name,
16731
+ :targets,
16732
+ :max_concurrency,
16733
+ :max_errors,
16734
+ :target_locations)
16735
+ SENSITIVE = []
16736
+ include Aws::Structure
16737
+ end
16738
+
15877
16739
  # An S3 bucket where you want to store the results of this request.
15878
16740
  #
15879
16741
  # @note When making an API call, you may pass S3OutputLocation
@@ -16081,8 +16943,15 @@ module Aws::SSM
16081
16943
  # @return [Array<Types::Target>]
16082
16944
  #
16083
16945
  # @!attribute [rw] document_name
16084
- # Required. The name of the Systems Manager document to run. This can
16085
- # be a public document or a custom document.
16946
+ # The name of the Systems Manager document to run. This can be a
16947
+ # public document or a custom document. To run a shared document
16948
+ # belonging to another account, specify the document ARN. For more
16949
+ # information about how to use shared documents, see [Using shared SSM
16950
+ # documents][1] in the *AWS Systems Manager User Guide*.
16951
+ #
16952
+ #
16953
+ #
16954
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
16086
16955
  # @return [String]
16087
16956
  #
16088
16957
  # @!attribute [rw] document_version
@@ -16560,7 +17429,15 @@ module Aws::SSM
16560
17429
  # }
16561
17430
  #
16562
17431
  # @!attribute [rw] document_name
16563
- # The name of the Automation document to use for this execution.
17432
+ # The name of the Systems Manager document to run. This can be a
17433
+ # public document or a custom document. To run a shared document
17434
+ # belonging to another account, specify the document ARN. For more
17435
+ # information about how to use shared documents, see [Using shared SSM
17436
+ # documents][1] in the *AWS Systems Manager User Guide*.
17437
+ #
17438
+ #
17439
+ #
17440
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
16564
17441
  # @return [String]
16565
17442
  #
16566
17443
  # @!attribute [rw] document_version
@@ -16683,6 +17560,141 @@ module Aws::SSM
16683
17560
  include Aws::Structure
16684
17561
  end
16685
17562
 
17563
+ # @note When making an API call, you may pass StartChangeRequestExecutionRequest
17564
+ # data as a hash:
17565
+ #
17566
+ # {
17567
+ # scheduled_time: Time.now,
17568
+ # document_name: "DocumentARN", # required
17569
+ # document_version: "DocumentVersion",
17570
+ # parameters: {
17571
+ # "AutomationParameterKey" => ["AutomationParameterValue"],
17572
+ # },
17573
+ # change_request_name: "ChangeRequestName",
17574
+ # client_token: "IdempotencyToken",
17575
+ # runbooks: [ # required
17576
+ # {
17577
+ # document_name: "DocumentARN", # required
17578
+ # document_version: "DocumentVersion",
17579
+ # parameters: {
17580
+ # "AutomationParameterKey" => ["AutomationParameterValue"],
17581
+ # },
17582
+ # target_parameter_name: "AutomationParameterKey",
17583
+ # targets: [
17584
+ # {
17585
+ # key: "TargetKey",
17586
+ # values: ["TargetValue"],
17587
+ # },
17588
+ # ],
17589
+ # max_concurrency: "MaxConcurrency",
17590
+ # max_errors: "MaxErrors",
17591
+ # target_locations: [
17592
+ # {
17593
+ # accounts: ["Account"],
17594
+ # regions: ["Region"],
17595
+ # target_location_max_concurrency: "MaxConcurrency",
17596
+ # target_location_max_errors: "MaxErrors",
17597
+ # execution_role_name: "ExecutionRoleName",
17598
+ # },
17599
+ # ],
17600
+ # },
17601
+ # ],
17602
+ # tags: [
17603
+ # {
17604
+ # key: "TagKey", # required
17605
+ # value: "TagValue", # required
17606
+ # },
17607
+ # ],
17608
+ # }
17609
+ #
17610
+ # @!attribute [rw] scheduled_time
17611
+ # The date and time specified in the change request to run the
17612
+ # Automation runbooks.
17613
+ #
17614
+ # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't
17615
+ # run until all required approvals for the change request have been
17616
+ # received.
17617
+ #
17618
+ # </note>
17619
+ # @return [Time]
17620
+ #
17621
+ # @!attribute [rw] document_name
17622
+ # The name of the change template document to run during the runbook
17623
+ # workflow.
17624
+ # @return [String]
17625
+ #
17626
+ # @!attribute [rw] document_version
17627
+ # The version of the change template document to run during the
17628
+ # runbook workflow.
17629
+ # @return [String]
17630
+ #
17631
+ # @!attribute [rw] parameters
17632
+ # A key-value map of parameters that match the declared parameters in
17633
+ # the change template document.
17634
+ # @return [Hash<String,Array<String>>]
17635
+ #
17636
+ # @!attribute [rw] change_request_name
17637
+ # The name of the change request associated with the runbook workflow
17638
+ # to be run.
17639
+ # @return [String]
17640
+ #
17641
+ # @!attribute [rw] client_token
17642
+ # The user-provided idempotency token. The token must be unique, is
17643
+ # case insensitive, enforces the UUID format, and can't be reused.
17644
+ # @return [String]
17645
+ #
17646
+ # @!attribute [rw] runbooks
17647
+ # Information about the Automation runbooks (Automation documents)
17648
+ # that are run during the runbook workflow.
17649
+ #
17650
+ # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't
17651
+ # run until all required approvals for the change request have been
17652
+ # received.
17653
+ #
17654
+ # </note>
17655
+ # @return [Array<Types::Runbook>]
17656
+ #
17657
+ # @!attribute [rw] tags
17658
+ # Optional metadata that you assign to a resource. You can specify a
17659
+ # maximum of five tags for a change request. Tags enable you to
17660
+ # categorize a resource in different ways, such as by purpose, owner,
17661
+ # or environment. For example, you might want to tag a change request
17662
+ # to identify an environment or target AWS Region. In this case, you
17663
+ # could specify the following key-value pairs:
17664
+ #
17665
+ # * `Key=Environment,Value=Production`
17666
+ #
17667
+ # * `Key=Region,Value=us-east-2`
17668
+ # @return [Array<Types::Tag>]
17669
+ #
17670
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartChangeRequestExecutionRequest AWS API Documentation
17671
+ #
17672
+ class StartChangeRequestExecutionRequest < Struct.new(
17673
+ :scheduled_time,
17674
+ :document_name,
17675
+ :document_version,
17676
+ :parameters,
17677
+ :change_request_name,
17678
+ :client_token,
17679
+ :runbooks,
17680
+ :tags)
17681
+ SENSITIVE = []
17682
+ include Aws::Structure
17683
+ end
17684
+
17685
+ # @!attribute [rw] automation_execution_id
17686
+ # The unique ID of a runbook workflow operation. (A runbook workflow
17687
+ # is a type of Automation operation.)
17688
+ # @return [String]
17689
+ #
17690
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartChangeRequestExecutionResult AWS API Documentation
17691
+ #
17692
+ class StartChangeRequestExecutionResult < Struct.new(
17693
+ :automation_execution_id)
17694
+ SENSITIVE = []
17695
+ include Aws::Structure
17696
+ end
17697
+
16686
17698
  # @note When making an API call, you may pass StartSessionRequest
16687
17699
  # data as a hash:
16688
17700
  #
@@ -17005,6 +18017,15 @@ module Aws::SSM
17005
18017
  # An array of search criteria that targets instances using a Key,Value
17006
18018
  # combination that you specify.
17007
18019
  #
18020
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
18021
+ # Command-type tasks. Depending on the task, targets are optional for
18022
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
18023
+ # Step Functions). For more information about running tasks that do not
18024
+ # specify targets, see [Registering maintenance window tasks without
18025
+ # targets][1] in the *AWS Systems Manager User Guide*.
18026
+ #
18027
+ # </note>
18028
+ #
17008
18029
  # Supported formats include the following.
17009
18030
  #
17010
18031
  # * `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3 `
@@ -17055,12 +18076,13 @@ module Aws::SSM
17055
18076
  # AWS Region where the association was created.
17056
18077
  #
17057
18078
  # For more information about how to send commands that target instances
17058
- # using `Key,Value` parameters, see [Targeting multiple instances][1] in
18079
+ # using `Key,Value` parameters, see [Targeting multiple instances][2] in
17059
18080
  # the *AWS Systems Manager User Guide*.
17060
18081
  #
17061
18082
  #
17062
18083
  #
17063
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
18084
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
18085
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
17064
18086
  #
17065
18087
  # @note When making an API call, you may pass Target
17066
18088
  # data as a hash:
@@ -17130,7 +18152,7 @@ module Aws::SSM
17130
18152
  #
17131
18153
  # @!attribute [rw] target_location_max_concurrency
17132
18154
  # The maximum number of AWS accounts and AWS regions allowed to run
17133
- # the Automation concurrently
18155
+ # the Automation concurrently.
17134
18156
  # @return [String]
17135
18157
  #
17136
18158
  # @!attribute [rw] target_location_max_errors
@@ -17141,7 +18163,8 @@ module Aws::SSM
17141
18163
  #
17142
18164
  # @!attribute [rw] execution_role_name
17143
18165
  # The Automation execution role used by the currently running
17144
- # Automation.
18166
+ # Automation. If not specified, the default value is
18167
+ # `AWS-SystemsManager-AutomationExecutionRole`.
17145
18168
  # @return [String]
17146
18169
  #
17147
18170
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetLocation AWS API Documentation
@@ -17386,6 +18409,15 @@ module Aws::SSM
17386
18409
  # compliance_severity: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, UNSPECIFIED
17387
18410
  # sync_compliance: "AUTO", # accepts AUTO, MANUAL
17388
18411
  # apply_only_at_cron_interval: false,
18412
+ # target_locations: [
18413
+ # {
18414
+ # accounts: ["Account"],
18415
+ # regions: ["Region"],
18416
+ # target_location_max_concurrency: "MaxConcurrency",
18417
+ # target_location_max_errors: "MaxErrors",
18418
+ # execution_role_name: "ExecutionRoleName",
18419
+ # },
18420
+ # ],
17389
18421
  # }
17390
18422
  #
17391
18423
  # @!attribute [rw] association_id
@@ -17521,6 +18553,12 @@ module Aws::SSM
17521
18553
  # the interval specified.
17522
18554
  # @return [Boolean]
17523
18555
  #
18556
+ # @!attribute [rw] target_locations
18557
+ # A location is a combination of AWS Regions and AWS accounts where
18558
+ # you want to run the association. Use this action to update an
18559
+ # association in multiple Regions and multiple accounts.
18560
+ # @return [Array<Types::TargetLocation>]
18561
+ #
17524
18562
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationRequest AWS API Documentation
17525
18563
  #
17526
18564
  class UpdateAssociationRequest < Struct.new(
@@ -17538,7 +18576,8 @@ module Aws::SSM
17538
18576
  :max_concurrency,
17539
18577
  :compliance_severity,
17540
18578
  :sync_compliance,
17541
- :apply_only_at_cron_interval)
18579
+ :apply_only_at_cron_interval,
18580
+ :target_locations)
17542
18581
  SENSITIVE = []
17543
18582
  include Aws::Structure
17544
18583
  end
@@ -17643,6 +18682,49 @@ module Aws::SSM
17643
18682
  include Aws::Structure
17644
18683
  end
17645
18684
 
18685
+ # @note When making an API call, you may pass UpdateDocumentMetadataRequest
18686
+ # data as a hash:
18687
+ #
18688
+ # {
18689
+ # name: "DocumentName", # required
18690
+ # document_version: "DocumentVersion",
18691
+ # document_reviews: { # required
18692
+ # action: "SendForReview", # required, accepts SendForReview, UpdateReview, Approve, Reject
18693
+ # comment: [
18694
+ # {
18695
+ # type: "Comment", # accepts Comment
18696
+ # content: "DocumentReviewComment",
18697
+ # },
18698
+ # ],
18699
+ # },
18700
+ # }
18701
+ #
18702
+ # @!attribute [rw] name
18703
+ # The name of the document for which a version is to be updated.
18704
+ # @return [String]
18705
+ #
18706
+ # @!attribute [rw] document_version
18707
+ # The version of a document to update.
18708
+ # @return [String]
18709
+ #
18710
+ # @!attribute [rw] document_reviews
18711
+ # The document review details to update.
18712
+ # @return [Types::DocumentReviews]
18713
+ #
18714
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateDocumentMetadataRequest AWS API Documentation
18715
+ #
18716
+ class UpdateDocumentMetadataRequest < Struct.new(
18717
+ :name,
18718
+ :document_version,
18719
+ :document_reviews)
18720
+ SENSITIVE = []
18721
+ include Aws::Structure
18722
+ end
18723
+
18724
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateDocumentMetadataResponse AWS API Documentation
18725
+ #
18726
+ class UpdateDocumentMetadataResponse < Aws::EmptyStructure; end
18727
+
17646
18728
  # @note When making an API call, you may pass UpdateDocumentRequest
17647
18729
  # data as a hash:
17648
18730
  #
@@ -17759,8 +18841,8 @@ module Aws::SSM
17759
18841
  # @!attribute [rw] start_date
17760
18842
  # The time zone that the scheduled maintenance window executions are
17761
18843
  # based on, in Internet Assigned Numbers Authority (IANA) format. For
17762
- # example: "America/Los\_Angeles", "etc/UTC", or "Asia/Seoul".
17763
- # For more information, see the [Time Zone Database][1] on the IANA
18844
+ # example: "America/Los\_Angeles", "UTC", or "Asia/Seoul". For
18845
+ # more information, see the [Time Zone Database][1] on the IANA
17764
18846
  # website.
17765
18847
  #
17766
18848
  #
@@ -17783,8 +18865,8 @@ module Aws::SSM
17783
18865
  # @!attribute [rw] schedule_timezone
17784
18866
  # The time zone that the scheduled maintenance window executions are
17785
18867
  # based on, in Internet Assigned Numbers Authority (IANA) format. For
17786
- # example: "America/Los\_Angeles", "etc/UTC", or "Asia/Seoul".
17787
- # For more information, see the [Time Zone Database][1] on the IANA
18868
+ # example: "America/Los\_Angeles", "UTC", or "Asia/Seoul". For
18869
+ # more information, see the [Time Zone Database][1] on the IANA
17788
18870
  # website.
17789
18871
  #
17790
18872
  #
@@ -17799,7 +18881,7 @@ module Aws::SSM
17799
18881
  # For example, the following cron expression schedules a maintenance
17800
18882
  # window to run the third Tuesday of every month at 11:30 PM.
17801
18883
  #
17802
- # `cron(0 30 23 ? * TUE#3 *)`
18884
+ # `cron(30 23 ? * TUE#3 *)`
17803
18885
  #
17804
18886
  # If the schedule offset is `2`, the maintenance window won't run
17805
18887
  # until two days later.
@@ -17881,8 +18963,8 @@ module Aws::SSM
17881
18963
  # @!attribute [rw] schedule_timezone
17882
18964
  # The time zone that the scheduled maintenance window executions are
17883
18965
  # based on, in Internet Assigned Numbers Authority (IANA) format. For
17884
- # example: "America/Los\_Angeles", "etc/UTC", or "Asia/Seoul".
17885
- # For more information, see the [Time Zone Database][1] on the IANA
18966
+ # example: "America/Los\_Angeles", "UTC", or "Asia/Seoul". For
18967
+ # more information, see the [Time Zone Database][1] on the IANA
17886
18968
  # website.
17887
18969
  #
17888
18970
  #
@@ -18117,6 +19199,19 @@ module Aws::SSM
18117
19199
  # The targets (either instances or tags) to modify. Instances are
18118
19200
  # specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
18119
19201
  # Tags are specified using Key=tag\_name,Values=tag\_value.
19202
+ #
19203
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
19204
+ # Command-type tasks. Depending on the task, targets are optional for
19205
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
19206
+ # Step Functions). For more information about running tasks that do
19207
+ # not specify targets, see [Registering maintenance window tasks
19208
+ # without targets][1] in the *AWS Systems Manager User Guide*.
19209
+ #
19210
+ # </note>
19211
+ #
19212
+ #
19213
+ #
19214
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
18120
19215
  # @return [Array<Types::Target>]
18121
19216
  #
18122
19217
  # @!attribute [rw] task_arn
@@ -18191,12 +19286,28 @@ module Aws::SSM
18191
19286
  # The new `MaxConcurrency` value you want to specify. `MaxConcurrency`
18192
19287
  # is the number of targets that are allowed to run this task in
18193
19288
  # parallel.
19289
+ #
19290
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
19291
+ # supply a value for this option. Instead, the system inserts a
19292
+ # placeholder value of `1`, which may be reported in the response to
19293
+ # this command. This value does not affect the running of your task
19294
+ # and can be ignored.
19295
+ #
19296
+ # </note>
18194
19297
  # @return [String]
18195
19298
  #
18196
19299
  # @!attribute [rw] max_errors
18197
19300
  # The new `MaxErrors` value to specify. `MaxErrors` is the maximum
18198
19301
  # number of errors that are allowed before the task stops being
18199
19302
  # scheduled.
19303
+ #
19304
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
19305
+ # supply a value for this option. Instead, the system inserts a
19306
+ # placeholder value of `1`, which may be reported in the response to
19307
+ # this command. This value does not affect the running of your task
19308
+ # and can be ignored.
19309
+ #
19310
+ # </note>
18200
19311
  # @return [String]
18201
19312
  #
18202
19313
  # @!attribute [rw] logging_info
@@ -18390,11 +19501,15 @@ module Aws::SSM
18390
19501
  # ops_item_id: "String", # required
18391
19502
  # },
18392
19503
  # ],
18393
- # status: "Open", # accepts Open, InProgress, Resolved
19504
+ # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Rejected
18394
19505
  # ops_item_id: "OpsItemId", # required
18395
19506
  # title: "OpsItemTitle",
18396
19507
  # category: "OpsItemCategory",
18397
19508
  # severity: "OpsItemSeverity",
19509
+ # actual_start_time: Time.now,
19510
+ # actual_end_time: Time.now,
19511
+ # planned_start_time: Time.now,
19512
+ # planned_end_time: Time.now,
18398
19513
  # }
18399
19514
  #
18400
19515
  # @!attribute [rw] description
@@ -18484,6 +19599,28 @@ module Aws::SSM
18484
19599
  # Specify a new severity for an OpsItem.
18485
19600
  # @return [String]
18486
19601
  #
19602
+ # @!attribute [rw] actual_start_time
19603
+ # The time a runbook workflow started. Currently reported only for the
19604
+ # OpsItem type `/aws/changerequest`.
19605
+ # @return [Time]
19606
+ #
19607
+ # @!attribute [rw] actual_end_time
19608
+ # The time a runbook workflow ended. Currently reported only for the
19609
+ # OpsItem type `/aws/changerequest`.
19610
+ # @return [Time]
19611
+ #
19612
+ # @!attribute [rw] planned_start_time
19613
+ # The time specified in a change request for a runbook workflow to
19614
+ # start. Currently supported only for the OpsItem type
19615
+ # `/aws/changerequest`.
19616
+ # @return [Time]
19617
+ #
19618
+ # @!attribute [rw] planned_end_time
19619
+ # The time specified in a change request for a runbook workflow to
19620
+ # end. Currently supported only for the OpsItem type
19621
+ # `/aws/changerequest`.
19622
+ # @return [Time]
19623
+ #
18487
19624
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateOpsItemRequest AWS API Documentation
18488
19625
  #
18489
19626
  class UpdateOpsItemRequest < Struct.new(
@@ -18497,7 +19634,11 @@ module Aws::SSM
18497
19634
  :ops_item_id,
18498
19635
  :title,
18499
19636
  :category,
18500
- :severity)
19637
+ :severity,
19638
+ :actual_start_time,
19639
+ :actual_end_time,
19640
+ :planned_start_time,
19641
+ :planned_end_time)
18501
19642
  SENSITIVE = []
18502
19643
  include Aws::Structure
18503
19644
  end