aws-sdk-ssm 1.100.0 → 1.105.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 93e73b8a694febf8c6e952fc85b110882e60c2bc1fe071539af701ebe15facf2
4
- data.tar.gz: ad7a20e4c9faabd84ed9f2784d4bef9429003c26898ed6420640e9f291b47baa
3
+ metadata.gz: a987f1a0207b8dadd73dc227b9f9669146b4c04f0d7a7f885082885c43c074ef
4
+ data.tar.gz: 616e0ed5ed9127ec7767ed639ab6ab37c7aea8268f53fb4a3428907baedd0793
5
5
  SHA512:
6
- metadata.gz: 7ff60f4c22619b371c04c924f3ce45498eacb765f5d29b65de780eb09d6325d45aacf7f64a776e87f67a4a2f7f1d52ecf99e985e021f4fc47bdd844ab0a2c768
7
- data.tar.gz: 7dd2d933e43aab62907b24bf8679ae96a26db4f860727f561976211687c7310d1e692c672138ccb3fb1e5db6698cedd5e2dfeb926b35cdfcaaf694e44f44da3f
6
+ metadata.gz: 6d847063652f6e9b58ae71e1cbbe65d4d7d49595636a92860f3ec15b81fe06fcab98bfdf26da409681567f1852d1c63cec2f6a13da2598be6ffef1ffde16dc17
7
+ data.tar.gz: 1846b6694947e6026cc14dc6fc36123c3617152be47ee02ae5f22ed3369b2f1cbb9a8cfad2c5dc46037175bcc2241976886abd9f2b8c5da437fd22c5777f22fe
data/lib/aws-sdk-ssm.rb CHANGED
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ssm/customizations'
49
49
  # @!group service
50
50
  module Aws::SSM
51
51
 
52
- GEM_VERSION = '1.100.0'
52
+ GEM_VERSION = '1.105.0'
53
53
 
54
54
  end
@@ -1563,8 +1563,8 @@ module Aws::SSM
1563
1563
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
1564
1564
  #
1565
1565
  # @option params [String] :approved_patches_compliance_level
1566
- # Defines the compliance level for approved patches. This means that if
1567
- # an approved patch is reported as missing, this is the severity of the
1566
+ # Defines the compliance level for approved patches. When an approved
1567
+ # patch is reported as missing, this value describes the severity of the
1568
1568
  # compliance violation. The default value is UNSPECIFIED.
1569
1569
  #
1570
1570
  # @option params [Boolean] :approved_patches_enable_non_security
@@ -2941,16 +2941,28 @@ module Aws::SSM
2941
2941
  # The permission type for the document. The permission type can be
2942
2942
  # *Share*.
2943
2943
  #
2944
+ # @option params [Integer] :max_results
2945
+ # The maximum number of items to return for this call. The call also
2946
+ # returns a token that you can specify in a subsequent call to get the
2947
+ # next set of results.
2948
+ #
2949
+ # @option params [String] :next_token
2950
+ # The token for the next set of items to return. (You received this
2951
+ # token from a previous call.)
2952
+ #
2944
2953
  # @return [Types::DescribeDocumentPermissionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2945
2954
  #
2946
2955
  # * {Types::DescribeDocumentPermissionResponse#account_ids #account_ids} => Array<String>
2947
2956
  # * {Types::DescribeDocumentPermissionResponse#account_sharing_info_list #account_sharing_info_list} => Array<Types::AccountSharingInfo>
2957
+ # * {Types::DescribeDocumentPermissionResponse#next_token #next_token} => String
2948
2958
  #
2949
2959
  # @example Request syntax with placeholder values
2950
2960
  #
2951
2961
  # resp = client.describe_document_permission({
2952
2962
  # name: "DocumentName", # required
2953
2963
  # permission_type: "Share", # required, accepts Share
2964
+ # max_results: 1,
2965
+ # next_token: "NextToken",
2954
2966
  # })
2955
2967
  #
2956
2968
  # @example Response structure
@@ -2960,6 +2972,7 @@ module Aws::SSM
2960
2972
  # resp.account_sharing_info_list #=> Array
2961
2973
  # resp.account_sharing_info_list[0].account_id #=> String
2962
2974
  # resp.account_sharing_info_list[0].shared_document_version #=> String
2975
+ # resp.next_token #=> String
2963
2976
  #
2964
2977
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocumentPermission AWS API Documentation
2965
2978
  #
@@ -3845,6 +3858,14 @@ module Aws::SSM
3845
3858
 
3846
3859
  # Lists the tasks in a maintenance window.
3847
3860
  #
3861
+ # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
3862
+ # supply values for `--max-errors` and `--max-concurrency`. Instead, the
3863
+ # system inserts a placeholder value of `1`, which may be reported in
3864
+ # the response to this command. These values do not affect the running
3865
+ # of your task and can be ignored.
3866
+ #
3867
+ # </note>
3868
+ #
3848
3869
  # @option params [required, String] :window_id
3849
3870
  # The ID of the maintenance window whose tasks should be retrieved.
3850
3871
  #
@@ -4961,6 +4982,9 @@ module Aws::SSM
4961
4982
  # @option params [required, String] :snapshot_id
4962
4983
  # The user-defined snapshot ID.
4963
4984
  #
4985
+ # @option params [Types::BaselineOverride] :baseline_override
4986
+ # Defines the basic information about a patch baseline override.
4987
+ #
4964
4988
  # @return [Types::GetDeployablePatchSnapshotForInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4965
4989
  #
4966
4990
  # * {Types::GetDeployablePatchSnapshotForInstanceResult#instance_id #instance_id} => String
@@ -4973,6 +4997,47 @@ module Aws::SSM
4973
4997
  # resp = client.get_deployable_patch_snapshot_for_instance({
4974
4998
  # instance_id: "InstanceId", # required
4975
4999
  # snapshot_id: "SnapshotId", # required
5000
+ # baseline_override: {
5001
+ # operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
5002
+ # global_filters: {
5003
+ # patch_filters: [ # required
5004
+ # {
5005
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
5006
+ # values: ["PatchFilterValue"], # required
5007
+ # },
5008
+ # ],
5009
+ # },
5010
+ # approval_rules: {
5011
+ # patch_rules: [ # required
5012
+ # {
5013
+ # patch_filter_group: { # required
5014
+ # patch_filters: [ # required
5015
+ # {
5016
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
5017
+ # values: ["PatchFilterValue"], # required
5018
+ # },
5019
+ # ],
5020
+ # },
5021
+ # compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
5022
+ # approve_after_days: 1,
5023
+ # approve_until_date: "PatchStringDateTime",
5024
+ # enable_non_security: false,
5025
+ # },
5026
+ # ],
5027
+ # },
5028
+ # approved_patches: ["PatchId"],
5029
+ # approved_patches_compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
5030
+ # rejected_patches: ["PatchId"],
5031
+ # rejected_patches_action: "ALLOW_AS_DEPENDENCY", # accepts ALLOW_AS_DEPENDENCY, BLOCK
5032
+ # approved_patches_enable_non_security: false,
5033
+ # sources: [
5034
+ # {
5035
+ # name: "PatchSourceName", # required
5036
+ # products: ["PatchSourceProduct"], # required
5037
+ # configuration: "PatchSourceConfiguration", # required
5038
+ # },
5039
+ # ],
5040
+ # },
4976
5041
  # })
4977
5042
  #
4978
5043
  # @example Response structure
@@ -5435,6 +5500,14 @@ module Aws::SSM
5435
5500
 
5436
5501
  # Lists the tasks in a maintenance window.
5437
5502
  #
5503
+ # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
5504
+ # supply values for `--max-errors` and `--max-concurrency`. Instead, the
5505
+ # system inserts a placeholder value of `1`, which may be reported in
5506
+ # the response to this command. These values do not affect the running
5507
+ # of your task and can be ignored.
5508
+ #
5509
+ # </note>
5510
+ #
5438
5511
  # @option params [required, String] :window_id
5439
5512
  # The maintenance window ID that includes the task to retrieve.
5440
5513
  #
@@ -5895,9 +5968,11 @@ module Aws::SSM
5895
5968
  #
5896
5969
  # @option params [required, String] :path
5897
5970
  # The hierarchy for the parameter. Hierarchies start with a forward
5898
- # slash (/) and end with the parameter name. A parameter name hierarchy
5899
- # can have a maximum of 15 levels. Here is an example of a hierarchy:
5900
- # `/Finance/Prod/IAD/WinServ2016/license33`
5971
+ # slash (/). The hierachy is the parameter name except the last part of
5972
+ # the parameter. For the API call to succeeed, the last part of the
5973
+ # parameter name cannot be in the path. A parameter name hierarchy can
5974
+ # have a maximum of 15 levels. Here is an example of a hierarchy:
5975
+ # `/Finance/Prod/IAD/WinServ2016/license33 `
5901
5976
  #
5902
5977
  # @option params [Boolean] :recursive
5903
5978
  # Retrieve all parameters within a hierarchy.
@@ -6111,6 +6186,8 @@ module Aws::SSM
6111
6186
  #
6112
6187
  # @option params [required, String] :setting_id
6113
6188
  # The ID of the service setting to get. The setting ID can be
6189
+ # `/ssm/automation/customer-script-log-destination`,
6190
+ # `/ssm/automation/customer-script-log-group-name`,
6114
6191
  # `/ssm/parameter-store/default-parameter-tier`,
6115
6192
  # `/ssm/parameter-store/high-throughput-enabled`, or
6116
6193
  # `/ssm/managed-instance/activation-tier`.
@@ -6826,14 +6903,20 @@ module Aws::SSM
6826
6903
  # This data type is deprecated. Instead, use `Filters`.
6827
6904
  #
6828
6905
  # @option params [Array<Types::DocumentKeyValuesFilter>] :filters
6829
- # One or more DocumentKeyValuesFilter objects. Use a filter to return a
6830
- # more specific list of results. For keys, you can specify one or more
6906
+ # One or more `DocumentKeyValuesFilter` objects. Use a filter to return
6907
+ # a more specific list of results. For keys, you can specify one or more
6831
6908
  # key-value pair tags that have been applied to a document. Other valid
6832
6909
  # keys include `Owner`, `Name`, `PlatformTypes`, `DocumentType`, and
6833
6910
  # `TargetType`. For example, to return documents you own use
6834
6911
  # `Key=Owner,Values=Self`. To specify a custom key-value pair, use the
6835
6912
  # format `Key=tag:tagName,Values=valueName`.
6836
6913
  #
6914
+ # <note markdown="1"> This API action only supports filtering documents by using a single
6915
+ # tag key and one or more tag values. For example:
6916
+ # `Key=tag:tagName,Values=valueName1,valueName2`
6917
+ #
6918
+ # </note>
6919
+ #
6837
6920
  # @option params [Integer] :max_results
6838
6921
  # The maximum number of items to return for this call. The call also
6839
6922
  # returns a token that you can specify in a subsequent call to get the
@@ -7511,7 +7594,11 @@ module Aws::SSM
7511
7594
  # (case-insensitive).
7512
7595
  #
7513
7596
  # * Parameter names can include only the following symbols and letters:
7514
- # `a-zA-Z0-9_.-/`
7597
+ # `a-zA-Z0-9_.-`
7598
+ #
7599
+ # In addition, the slash character ( / ) is used to delineate
7600
+ # hierarchies in parameter names. For example:
7601
+ # `/Dev/Production/East/Project-ABC/MyParameter`
7515
7602
  #
7516
7603
  # * A parameter name can't include spaces.
7517
7604
  #
@@ -7519,8 +7606,8 @@ module Aws::SSM
7519
7606
  # levels.
7520
7607
  #
7521
7608
  # For additional information about valid values for parameter names, see
7522
- # [About requirements and constraints for parameter names][1] in the
7523
- # *AWS Systems Manager User Guide*.
7609
+ # [Creating Systems Manager parameters][1] in the *AWS Systems Manager
7610
+ # User Guide*.
7524
7611
  #
7525
7612
  # <note markdown="1"> The maximum length constraint listed below includes capacity for
7526
7613
  # additional system attributes that are not part of the name. The
@@ -7534,7 +7621,7 @@ module Aws::SSM
7534
7621
  #
7535
7622
  #
7536
7623
  #
7537
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-parameter-name-constraints.html
7624
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html
7538
7625
  #
7539
7626
  # @option params [String] :description
7540
7627
  # Information about the parameter that you want to add to the system.
@@ -7862,6 +7949,14 @@ module Aws::SSM
7862
7949
  # The targets to register with the maintenance window. In other words,
7863
7950
  # the instances to run commands on when the maintenance window runs.
7864
7951
  #
7952
+ # <note markdown="1"> If a single maintenance window task is registered with multiple
7953
+ # targets, its task invocations occur sequentially and not in parallel.
7954
+ # If your task must run on multiple targets at the same time, register a
7955
+ # task for each target individually and assign each task the same
7956
+ # priority level.
7957
+ #
7958
+ # </note>
7959
+ #
7865
7960
  # You can specify targets using instance IDs, resource group names, or
7866
7961
  # tags that have been applied to instances.
7867
7962
  #
@@ -7958,9 +8053,18 @@ module Aws::SSM
7958
8053
  # @option params [required, String] :window_id
7959
8054
  # The ID of the maintenance window the task should be added to.
7960
8055
  #
7961
- # @option params [required, Array<Types::Target>] :targets
8056
+ # @option params [Array<Types::Target>] :targets
7962
8057
  # The targets (either instances or maintenance window targets).
7963
8058
  #
8059
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
8060
+ # Command-type tasks. Depending on the task, targets are optional for
8061
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
8062
+ # Step Functions). For more information about running tasks that do not
8063
+ # specify targets, see [Registering maintenance window tasks without
8064
+ # targets][1] in the *AWS Systems Manager User Guide*.
8065
+ #
8066
+ # </note>
8067
+ #
7964
8068
  # Specify instances using the following format:
7965
8069
  #
7966
8070
  # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
@@ -7969,6 +8073,10 @@ module Aws::SSM
7969
8073
  #
7970
8074
  # `Key=WindowTargetIds,Values=<window-target-id-1>,<window-target-id-2>`
7971
8075
  #
8076
+ #
8077
+ #
8078
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
8079
+ #
7972
8080
  # @option params [required, String] :task_arn
7973
8081
  # The ARN of the task to run.
7974
8082
  #
@@ -8017,13 +8125,27 @@ module Aws::SSM
8017
8125
  # scheduled in priority order with tasks that have the same priority
8018
8126
  # scheduled in parallel.
8019
8127
  #
8020
- # @option params [required, String] :max_concurrency
8128
+ # @option params [String] :max_concurrency
8021
8129
  # The maximum number of targets this task can be run for in parallel.
8022
8130
  #
8023
- # @option params [required, String] :max_errors
8131
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8132
+ # supply a value for this option. Instead, the system inserts a
8133
+ # placeholder value of `1`. This value does not affect the running of
8134
+ # your task.
8135
+ #
8136
+ # </note>
8137
+ #
8138
+ # @option params [String] :max_errors
8024
8139
  # The maximum number of errors allowed before this task stops being
8025
8140
  # scheduled.
8026
8141
  #
8142
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8143
+ # supply a value for this option. Instead, the system inserts a
8144
+ # placeholder value of `1`. This value does not affect the running of
8145
+ # your task.
8146
+ #
8147
+ # </note>
8148
+ #
8027
8149
  # @option params [Types::LoggingInfo] :logging_info
8028
8150
  # A structure containing information about an S3 bucket to write
8029
8151
  # instance-level logs to.
@@ -8057,7 +8179,7 @@ module Aws::SSM
8057
8179
  #
8058
8180
  # resp = client.register_task_with_maintenance_window({
8059
8181
  # window_id: "MaintenanceWindowId", # required
8060
- # targets: [ # required
8182
+ # targets: [
8061
8183
  # {
8062
8184
  # key: "TargetKey",
8063
8185
  # values: ["TargetValue"],
@@ -8111,8 +8233,8 @@ module Aws::SSM
8111
8233
  # },
8112
8234
  # },
8113
8235
  # priority: 1,
8114
- # max_concurrency: "MaxConcurrency", # required
8115
- # max_errors: "MaxErrors", # required
8236
+ # max_concurrency: "MaxConcurrency",
8237
+ # max_errors: "MaxErrors",
8116
8238
  # logging_info: {
8117
8239
  # s3_bucket_name: "S3BucketName", # required
8118
8240
  # s3_key_prefix: "S3KeyPrefix",
@@ -8207,7 +8329,9 @@ module Aws::SSM
8207
8329
  #
8208
8330
  # @option params [required, String] :setting_id
8209
8331
  # The Amazon Resource Name (ARN) of the service setting to reset. The
8210
- # setting ID can be `/ssm/parameter-store/default-parameter-tier`,
8332
+ # setting ID can be `/ssm/automation/customer-script-log-destination`,
8333
+ # `/ssm/automation/customer-script-log-group-name`,
8334
+ # `/ssm/parameter-store/default-parameter-tier`,
8211
8335
  # `/ssm/parameter-store/high-throughput-enabled`, or
8212
8336
  # `/ssm/managed-instance/activation-tier`. For example,
8213
8337
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
@@ -8370,8 +8494,15 @@ module Aws::SSM
8370
8494
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html
8371
8495
  #
8372
8496
  # @option params [required, String] :document_name
8373
- # Required. The name of the Systems Manager document to run. This can be
8374
- # a public document or a custom document.
8497
+ # The name of the Systems Manager document to run. This can be a public
8498
+ # document or a custom document. To run a shared document belonging to
8499
+ # another account, specify the document ARN. For more information about
8500
+ # how to use shared documents, see [Using shared SSM documents][1] in
8501
+ # the *AWS Systems Manager User Guide*.
8502
+ #
8503
+ #
8504
+ #
8505
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
8375
8506
  #
8376
8507
  # @option params [String] :document_version
8377
8508
  # The SSM document version to use in the request. You can specify
@@ -8574,7 +8705,15 @@ module Aws::SSM
8574
8705
  # Initiates execution of an Automation document.
8575
8706
  #
8576
8707
  # @option params [required, String] :document_name
8577
- # The name of the Automation document to use for this execution.
8708
+ # The name of the Systems Manager document to run. This can be a public
8709
+ # document or a custom document. To run a shared document belonging to
8710
+ # another account, specify the document ARN. For more information about
8711
+ # how to use shared documents, see [Using shared SSM documents][1] in
8712
+ # the *AWS Systems Manager User Guide*.
8713
+ #
8714
+ #
8715
+ #
8716
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
8578
8717
  #
8579
8718
  # @option params [String] :document_version
8580
8719
  # The version of the Automation document to use for this execution.
@@ -9702,6 +9841,15 @@ module Aws::SSM
9702
9841
  #
9703
9842
  # * MaxErrors
9704
9843
  #
9844
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
9845
+ # Command-type tasks. Depending on the task, targets are optional for
9846
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
9847
+ # Step Functions). For more information about running tasks that do not
9848
+ # specify targets, see [Registering maintenance window tasks without
9849
+ # targets][1] in the *AWS Systems Manager User Guide*.
9850
+ #
9851
+ # </note>
9852
+ #
9705
9853
  # If the value for a parameter in `UpdateMaintenanceWindowTask` is null,
9706
9854
  # then the corresponding field is not modified. If you set `Replace` to
9707
9855
  # true, then all fields required by the
@@ -9718,6 +9866,10 @@ module Aws::SSM
9718
9866
  # and specify only a different `OutputS3BucketName` value, the values
9719
9867
  # for `Comment` and `NotificationConfig` are removed.
9720
9868
  #
9869
+ #
9870
+ #
9871
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
9872
+ #
9721
9873
  # @option params [required, String] :window_id
9722
9874
  # The maintenance window ID that contains the task to modify.
9723
9875
  #
@@ -9729,6 +9881,19 @@ module Aws::SSM
9729
9881
  # specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
9730
9882
  # Tags are specified using Key=tag\_name,Values=tag\_value.
9731
9883
  #
9884
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
9885
+ # Command-type tasks. Depending on the task, targets are optional for
9886
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
9887
+ # Step Functions). For more information about running tasks that do not
9888
+ # specify targets, see [Registering maintenance window tasks without
9889
+ # targets][1] in the *AWS Systems Manager User Guide*.
9890
+ #
9891
+ # </note>
9892
+ #
9893
+ #
9894
+ #
9895
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
9896
+ #
9732
9897
  # @option params [String] :task_arn
9733
9898
  # The task ARN to modify.
9734
9899
  #
@@ -9794,11 +9959,27 @@ module Aws::SSM
9794
9959
  # is the number of targets that are allowed to run this task in
9795
9960
  # parallel.
9796
9961
  #
9962
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
9963
+ # supply a value for this option. Instead, the system inserts a
9964
+ # placeholder value of `1`, which may be reported in the response to
9965
+ # this command. This value does not affect the running of your task and
9966
+ # can be ignored.
9967
+ #
9968
+ # </note>
9969
+ #
9797
9970
  # @option params [String] :max_errors
9798
9971
  # The new `MaxErrors` value to specify. `MaxErrors` is the maximum
9799
9972
  # number of errors that are allowed before the task stops being
9800
9973
  # scheduled.
9801
9974
  #
9975
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
9976
+ # supply a value for this option. Instead, the system inserts a
9977
+ # placeholder value of `1`, which may be reported in the response to
9978
+ # this command. This value does not affect the running of your task and
9979
+ # can be ignored.
9980
+ #
9981
+ # </note>
9982
+ #
9802
9983
  # @option params [Types::LoggingInfo] :logging_info
9803
9984
  # The new logging location in Amazon S3 to specify.
9804
9985
  #
@@ -10455,6 +10636,10 @@ module Aws::SSM
10455
10636
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
10456
10637
  # The setting ID can be one of the following.
10457
10638
  #
10639
+ # * `/ssm/automation/customer-script-log-destination`
10640
+ #
10641
+ # * `/ssm/automation/customer-script-log-group-name`
10642
+ #
10458
10643
  # * `/ssm/parameter-store/default-parameter-tier`
10459
10644
  #
10460
10645
  # * `/ssm/parameter-store/high-throughput-enabled`
@@ -10476,6 +10661,12 @@ module Aws::SSM
10476
10661
  # `/ssm/managed-instance/activation-tier` setting IDs, the setting value
10477
10662
  # can be true or false.
10478
10663
  #
10664
+ # For the `/ssm/automation/customer-script-log-destination` setting ID,
10665
+ # the setting value can be CloudWatch.
10666
+ #
10667
+ # For the `/ssm/automation/customer-script-log-group-name` setting ID,
10668
+ # the setting value can be the name of a CloudWatch Logs log group.
10669
+ #
10479
10670
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
10480
10671
  #
10481
10672
  # @example Request syntax with placeholder values
@@ -10507,7 +10698,7 @@ module Aws::SSM
10507
10698
  params: params,
10508
10699
  config: config)
10509
10700
  context[:gem_name] = 'aws-sdk-ssm'
10510
- context[:gem_version] = '1.100.0'
10701
+ context[:gem_version] = '1.105.0'
10511
10702
  Seahorse::Client::Request.new(handlers, context)
10512
10703
  end
10513
10704
 
@@ -117,6 +117,7 @@ module Aws::SSM
117
117
  BaselineDescription = Shapes::StringShape.new(name: 'BaselineDescription')
118
118
  BaselineId = Shapes::StringShape.new(name: 'BaselineId')
119
119
  BaselineName = Shapes::StringShape.new(name: 'BaselineName')
120
+ BaselineOverride = Shapes::StructureShape.new(name: 'BaselineOverride')
120
121
  BatchErrorMessage = Shapes::StringShape.new(name: 'BatchErrorMessage')
121
122
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
122
123
  CalendarNameOrARN = Shapes::StringShape.new(name: 'CalendarNameOrARN')
@@ -337,6 +338,7 @@ module Aws::SSM
337
338
  DocumentParameterName = Shapes::StringShape.new(name: 'DocumentParameterName')
338
339
  DocumentParameterType = Shapes::StringShape.new(name: 'DocumentParameterType')
339
340
  DocumentPermissionLimit = Shapes::StructureShape.new(name: 'DocumentPermissionLimit')
341
+ DocumentPermissionMaxResults = Shapes::IntegerShape.new(name: 'DocumentPermissionMaxResults')
340
342
  DocumentPermissionType = Shapes::StringShape.new(name: 'DocumentPermissionType')
341
343
  DocumentRequires = Shapes::StructureShape.new(name: 'DocumentRequires')
342
344
  DocumentRequiresList = Shapes::ListShape.new(name: 'DocumentRequiresList')
@@ -1416,6 +1418,17 @@ module Aws::SSM
1416
1418
  AutomationStepNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
1417
1419
  AutomationStepNotFoundException.struct_class = Types::AutomationStepNotFoundException
1418
1420
 
1421
+ BaselineOverride.add_member(:operating_system, Shapes::ShapeRef.new(shape: OperatingSystem, location_name: "OperatingSystem"))
1422
+ BaselineOverride.add_member(:global_filters, Shapes::ShapeRef.new(shape: PatchFilterGroup, location_name: "GlobalFilters"))
1423
+ BaselineOverride.add_member(:approval_rules, Shapes::ShapeRef.new(shape: PatchRuleGroup, location_name: "ApprovalRules"))
1424
+ BaselineOverride.add_member(:approved_patches, Shapes::ShapeRef.new(shape: PatchIdList, location_name: "ApprovedPatches"))
1425
+ BaselineOverride.add_member(:approved_patches_compliance_level, Shapes::ShapeRef.new(shape: PatchComplianceLevel, location_name: "ApprovedPatchesComplianceLevel"))
1426
+ BaselineOverride.add_member(:rejected_patches, Shapes::ShapeRef.new(shape: PatchIdList, location_name: "RejectedPatches"))
1427
+ BaselineOverride.add_member(:rejected_patches_action, Shapes::ShapeRef.new(shape: PatchAction, location_name: "RejectedPatchesAction"))
1428
+ BaselineOverride.add_member(:approved_patches_enable_non_security, Shapes::ShapeRef.new(shape: Boolean, location_name: "ApprovedPatchesEnableNonSecurity"))
1429
+ BaselineOverride.add_member(:sources, Shapes::ShapeRef.new(shape: PatchSourceList, location_name: "Sources"))
1430
+ BaselineOverride.struct_class = Types::BaselineOverride
1431
+
1419
1432
  CalendarNameOrARNList.member = Shapes::ShapeRef.new(shape: CalendarNameOrARN)
1420
1433
 
1421
1434
  CancelCommandRequest.add_member(:command_id, Shapes::ShapeRef.new(shape: CommandId, required: true, location_name: "CommandId"))
@@ -1878,10 +1891,13 @@ module Aws::SSM
1878
1891
 
1879
1892
  DescribeDocumentPermissionRequest.add_member(:name, Shapes::ShapeRef.new(shape: DocumentName, required: true, location_name: "Name"))
1880
1893
  DescribeDocumentPermissionRequest.add_member(:permission_type, Shapes::ShapeRef.new(shape: DocumentPermissionType, required: true, location_name: "PermissionType"))
1894
+ DescribeDocumentPermissionRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: DocumentPermissionMaxResults, location_name: "MaxResults", metadata: {"box"=>true}))
1895
+ DescribeDocumentPermissionRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1881
1896
  DescribeDocumentPermissionRequest.struct_class = Types::DescribeDocumentPermissionRequest
1882
1897
 
1883
1898
  DescribeDocumentPermissionResponse.add_member(:account_ids, Shapes::ShapeRef.new(shape: AccountIdList, location_name: "AccountIds"))
1884
1899
  DescribeDocumentPermissionResponse.add_member(:account_sharing_info_list, Shapes::ShapeRef.new(shape: AccountSharingInfoList, location_name: "AccountSharingInfoList"))
1900
+ DescribeDocumentPermissionResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
1885
1901
  DescribeDocumentPermissionResponse.struct_class = Types::DescribeDocumentPermissionResponse
1886
1902
 
1887
1903
  DescribeDocumentRequest.add_member(:name, Shapes::ShapeRef.new(shape: DocumentARN, required: true, location_name: "Name"))
@@ -2334,6 +2350,7 @@ module Aws::SSM
2334
2350
 
2335
2351
  GetDeployablePatchSnapshotForInstanceRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, required: true, location_name: "InstanceId"))
2336
2352
  GetDeployablePatchSnapshotForInstanceRequest.add_member(:snapshot_id, Shapes::ShapeRef.new(shape: SnapshotId, required: true, location_name: "SnapshotId"))
2353
+ GetDeployablePatchSnapshotForInstanceRequest.add_member(:baseline_override, Shapes::ShapeRef.new(shape: BaselineOverride, location_name: "BaselineOverride"))
2337
2354
  GetDeployablePatchSnapshotForInstanceRequest.struct_class = Types::GetDeployablePatchSnapshotForInstanceRequest
2338
2355
 
2339
2356
  GetDeployablePatchSnapshotForInstanceResult.add_member(:instance_id, Shapes::ShapeRef.new(shape: InstanceId, location_name: "InstanceId"))
@@ -3758,15 +3775,15 @@ module Aws::SSM
3758
3775
  RegisterTargetWithMaintenanceWindowResult.struct_class = Types::RegisterTargetWithMaintenanceWindowResult
3759
3776
 
3760
3777
  RegisterTaskWithMaintenanceWindowRequest.add_member(:window_id, Shapes::ShapeRef.new(shape: MaintenanceWindowId, required: true, location_name: "WindowId"))
3761
- RegisterTaskWithMaintenanceWindowRequest.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, required: true, location_name: "Targets"))
3778
+ RegisterTaskWithMaintenanceWindowRequest.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, location_name: "Targets", metadata: {"box"=>true}))
3762
3779
  RegisterTaskWithMaintenanceWindowRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskArn, required: true, location_name: "TaskArn"))
3763
3780
  RegisterTaskWithMaintenanceWindowRequest.add_member(:service_role_arn, Shapes::ShapeRef.new(shape: ServiceRole, location_name: "ServiceRoleArn"))
3764
3781
  RegisterTaskWithMaintenanceWindowRequest.add_member(:task_type, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskType, required: true, location_name: "TaskType"))
3765
3782
  RegisterTaskWithMaintenanceWindowRequest.add_member(:task_parameters, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskParameters, location_name: "TaskParameters"))
3766
3783
  RegisterTaskWithMaintenanceWindowRequest.add_member(:task_invocation_parameters, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskInvocationParameters, location_name: "TaskInvocationParameters"))
3767
3784
  RegisterTaskWithMaintenanceWindowRequest.add_member(:priority, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskPriority, location_name: "Priority", metadata: {"box"=>true}))
3768
- RegisterTaskWithMaintenanceWindowRequest.add_member(:max_concurrency, Shapes::ShapeRef.new(shape: MaxConcurrency, required: true, location_name: "MaxConcurrency"))
3769
- RegisterTaskWithMaintenanceWindowRequest.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, required: true, location_name: "MaxErrors"))
3785
+ RegisterTaskWithMaintenanceWindowRequest.add_member(:max_concurrency, Shapes::ShapeRef.new(shape: MaxConcurrency, location_name: "MaxConcurrency", metadata: {"box"=>true}))
3786
+ RegisterTaskWithMaintenanceWindowRequest.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, location_name: "MaxErrors", metadata: {"box"=>true}))
3770
3787
  RegisterTaskWithMaintenanceWindowRequest.add_member(:logging_info, Shapes::ShapeRef.new(shape: LoggingInfo, location_name: "LoggingInfo"))
3771
3788
  RegisterTaskWithMaintenanceWindowRequest.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
3772
3789
  RegisterTaskWithMaintenanceWindowRequest.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
@@ -4842,7 +4859,9 @@ module Aws::SSM
4842
4859
  o.output = Shapes::ShapeRef.new(shape: DescribeDocumentPermissionResponse)
4843
4860
  o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
4844
4861
  o.errors << Shapes::ShapeRef.new(shape: InvalidDocument)
4862
+ o.errors << Shapes::ShapeRef.new(shape: InvalidNextToken)
4845
4863
  o.errors << Shapes::ShapeRef.new(shape: InvalidPermissionType)
4864
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDocumentOperation)
4846
4865
  end)
4847
4866
 
4848
4867
  api.add_operation(:describe_effective_instance_associations, Seahorse::Model::Operation.new.tap do |o|
@@ -1219,10 +1219,7 @@ module Aws::SSM
1219
1219
  # }
1220
1220
  #
1221
1221
  # @!attribute [rw] key
1222
- # One or more keys to limit the results. Valid filter keys include the
1223
- # following: DocumentNamePrefix, ExecutionStatus, ExecutionId,
1224
- # ParentExecutionId, CurrentAction, StartTimeBefore, StartTimeAfter,
1225
- # TargetResourceGroup.
1222
+ # One or more keys to limit the results.
1226
1223
  # @return [String]
1227
1224
  #
1228
1225
  # @!attribute [rw] values
@@ -1452,6 +1449,132 @@ module Aws::SSM
1452
1449
  include Aws::Structure
1453
1450
  end
1454
1451
 
1452
+ # Defines the basic information about a patch baseline override.
1453
+ #
1454
+ # @note When making an API call, you may pass BaselineOverride
1455
+ # data as a hash:
1456
+ #
1457
+ # {
1458
+ # operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
1459
+ # global_filters: {
1460
+ # patch_filters: [ # required
1461
+ # {
1462
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
1463
+ # values: ["PatchFilterValue"], # required
1464
+ # },
1465
+ # ],
1466
+ # },
1467
+ # approval_rules: {
1468
+ # patch_rules: [ # required
1469
+ # {
1470
+ # patch_filter_group: { # required
1471
+ # patch_filters: [ # required
1472
+ # {
1473
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
1474
+ # values: ["PatchFilterValue"], # required
1475
+ # },
1476
+ # ],
1477
+ # },
1478
+ # compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
1479
+ # approve_after_days: 1,
1480
+ # approve_until_date: "PatchStringDateTime",
1481
+ # enable_non_security: false,
1482
+ # },
1483
+ # ],
1484
+ # },
1485
+ # approved_patches: ["PatchId"],
1486
+ # approved_patches_compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
1487
+ # rejected_patches: ["PatchId"],
1488
+ # rejected_patches_action: "ALLOW_AS_DEPENDENCY", # accepts ALLOW_AS_DEPENDENCY, BLOCK
1489
+ # approved_patches_enable_non_security: false,
1490
+ # sources: [
1491
+ # {
1492
+ # name: "PatchSourceName", # required
1493
+ # products: ["PatchSourceProduct"], # required
1494
+ # configuration: "PatchSourceConfiguration", # required
1495
+ # },
1496
+ # ],
1497
+ # }
1498
+ #
1499
+ # @!attribute [rw] operating_system
1500
+ # The operating system rule used by the patch baseline override.
1501
+ # @return [String]
1502
+ #
1503
+ # @!attribute [rw] global_filters
1504
+ # A set of patch filters, typically used for approval rules.
1505
+ # @return [Types::PatchFilterGroup]
1506
+ #
1507
+ # @!attribute [rw] approval_rules
1508
+ # A set of rules defining the approval rules for a patch baseline.
1509
+ # @return [Types::PatchRuleGroup]
1510
+ #
1511
+ # @!attribute [rw] approved_patches
1512
+ # A list of explicitly approved patches for the baseline.
1513
+ #
1514
+ # For information about accepted formats for lists of approved patches
1515
+ # and rejected patches, see [About package name formats for approved
1516
+ # and rejected patch lists][1] in the *AWS Systems Manager User
1517
+ # Guide*.
1518
+ #
1519
+ #
1520
+ #
1521
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
1522
+ # @return [Array<String>]
1523
+ #
1524
+ # @!attribute [rw] approved_patches_compliance_level
1525
+ # Defines the compliance level for approved patches. When an approved
1526
+ # patch is reported as missing, this value describes the severity of
1527
+ # the compliance violation.
1528
+ # @return [String]
1529
+ #
1530
+ # @!attribute [rw] rejected_patches
1531
+ # A list of explicitly rejected patches for the baseline.
1532
+ #
1533
+ # For information about accepted formats for lists of approved patches
1534
+ # and rejected patches, see [About package name formats for approved
1535
+ # and rejected patch lists][1] in the *AWS Systems Manager User
1536
+ # Guide*.
1537
+ #
1538
+ #
1539
+ #
1540
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
1541
+ # @return [Array<String>]
1542
+ #
1543
+ # @!attribute [rw] rejected_patches_action
1544
+ # The action for Patch Manager to take on patches included in the
1545
+ # RejectedPackages list. A patch can be allowed only if it is a
1546
+ # dependency of another package, or blocked entirely along with
1547
+ # packages that include it as a dependency.
1548
+ # @return [String]
1549
+ #
1550
+ # @!attribute [rw] approved_patches_enable_non_security
1551
+ # Indicates whether the list of approved patches includes non-security
1552
+ # updates that should be applied to the instances. The default value
1553
+ # is 'false'. Applies to Linux instances only.
1554
+ # @return [Boolean]
1555
+ #
1556
+ # @!attribute [rw] sources
1557
+ # Information about the patches to use to update the instances,
1558
+ # including target operating systems and source repositories. Applies
1559
+ # to Linux instances only.
1560
+ # @return [Array<Types::PatchSource>]
1561
+ #
1562
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/BaselineOverride AWS API Documentation
1563
+ #
1564
+ class BaselineOverride < Struct.new(
1565
+ :operating_system,
1566
+ :global_filters,
1567
+ :approval_rules,
1568
+ :approved_patches,
1569
+ :approved_patches_compliance_level,
1570
+ :rejected_patches,
1571
+ :rejected_patches_action,
1572
+ :approved_patches_enable_non_security,
1573
+ :sources)
1574
+ SENSITIVE = []
1575
+ include Aws::Structure
1576
+ end
1577
+
1455
1578
  # @note When making an API call, you may pass CancelCommandRequest
1456
1579
  # data as a hash:
1457
1580
  #
@@ -3626,8 +3749,8 @@ module Aws::SSM
3626
3749
  # @return [Array<String>]
3627
3750
  #
3628
3751
  # @!attribute [rw] approved_patches_compliance_level
3629
- # Defines the compliance level for approved patches. This means that
3630
- # if an approved patch is reported as missing, this is the severity of
3752
+ # Defines the compliance level for approved patches. When an approved
3753
+ # patch is reported as missing, this value describes the severity of
3631
3754
  # the compliance violation. The default value is UNSPECIFIED.
3632
3755
  # @return [String]
3633
3756
  #
@@ -4822,6 +4945,8 @@ module Aws::SSM
4822
4945
  # {
4823
4946
  # name: "DocumentName", # required
4824
4947
  # permission_type: "Share", # required, accepts Share
4948
+ # max_results: 1,
4949
+ # next_token: "NextToken",
4825
4950
  # }
4826
4951
  #
4827
4952
  # @!attribute [rw] name
@@ -4833,11 +4958,24 @@ module Aws::SSM
4833
4958
  # *Share*.
4834
4959
  # @return [String]
4835
4960
  #
4961
+ # @!attribute [rw] max_results
4962
+ # The maximum number of items to return for this call. The call also
4963
+ # returns a token that you can specify in a subsequent call to get the
4964
+ # next set of results.
4965
+ # @return [Integer]
4966
+ #
4967
+ # @!attribute [rw] next_token
4968
+ # The token for the next set of items to return. (You received this
4969
+ # token from a previous call.)
4970
+ # @return [String]
4971
+ #
4836
4972
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocumentPermissionRequest AWS API Documentation
4837
4973
  #
4838
4974
  class DescribeDocumentPermissionRequest < Struct.new(
4839
4975
  :name,
4840
- :permission_type)
4976
+ :permission_type,
4977
+ :max_results,
4978
+ :next_token)
4841
4979
  SENSITIVE = []
4842
4980
  include Aws::Structure
4843
4981
  end
@@ -4852,11 +4990,17 @@ module Aws::SSM
4852
4990
  # version shared with each account.
4853
4991
  # @return [Array<Types::AccountSharingInfo>]
4854
4992
  #
4993
+ # @!attribute [rw] next_token
4994
+ # The token for the next set of items to return. Use this token to get
4995
+ # the next set of results.
4996
+ # @return [String]
4997
+ #
4855
4998
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocumentPermissionResponse AWS API Documentation
4856
4999
  #
4857
5000
  class DescribeDocumentPermissionResponse < Struct.new(
4858
5001
  :account_ids,
4859
- :account_sharing_info_list)
5002
+ :account_sharing_info_list,
5003
+ :next_token)
4860
5004
  SENSITIVE = []
4861
5005
  include Aws::Structure
4862
5006
  end
@@ -7735,6 +7879,47 @@ module Aws::SSM
7735
7879
  # {
7736
7880
  # instance_id: "InstanceId", # required
7737
7881
  # snapshot_id: "SnapshotId", # required
7882
+ # baseline_override: {
7883
+ # operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
7884
+ # global_filters: {
7885
+ # patch_filters: [ # required
7886
+ # {
7887
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
7888
+ # values: ["PatchFilterValue"], # required
7889
+ # },
7890
+ # ],
7891
+ # },
7892
+ # approval_rules: {
7893
+ # patch_rules: [ # required
7894
+ # {
7895
+ # patch_filter_group: { # required
7896
+ # patch_filters: [ # required
7897
+ # {
7898
+ # key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
7899
+ # values: ["PatchFilterValue"], # required
7900
+ # },
7901
+ # ],
7902
+ # },
7903
+ # compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
7904
+ # approve_after_days: 1,
7905
+ # approve_until_date: "PatchStringDateTime",
7906
+ # enable_non_security: false,
7907
+ # },
7908
+ # ],
7909
+ # },
7910
+ # approved_patches: ["PatchId"],
7911
+ # approved_patches_compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
7912
+ # rejected_patches: ["PatchId"],
7913
+ # rejected_patches_action: "ALLOW_AS_DEPENDENCY", # accepts ALLOW_AS_DEPENDENCY, BLOCK
7914
+ # approved_patches_enable_non_security: false,
7915
+ # sources: [
7916
+ # {
7917
+ # name: "PatchSourceName", # required
7918
+ # products: ["PatchSourceProduct"], # required
7919
+ # configuration: "PatchSourceConfiguration", # required
7920
+ # },
7921
+ # ],
7922
+ # },
7738
7923
  # }
7739
7924
  #
7740
7925
  # @!attribute [rw] instance_id
@@ -7746,11 +7931,16 @@ module Aws::SSM
7746
7931
  # The user-defined snapshot ID.
7747
7932
  # @return [String]
7748
7933
  #
7934
+ # @!attribute [rw] baseline_override
7935
+ # Defines the basic information about a patch baseline override.
7936
+ # @return [Types::BaselineOverride]
7937
+ #
7749
7938
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetDeployablePatchSnapshotForInstanceRequest AWS API Documentation
7750
7939
  #
7751
7940
  class GetDeployablePatchSnapshotForInstanceRequest < Struct.new(
7752
7941
  :instance_id,
7753
- :snapshot_id)
7942
+ :snapshot_id,
7943
+ :baseline_override)
7754
7944
  SENSITIVE = []
7755
7945
  include Aws::Structure
7756
7946
  end
@@ -8547,11 +8737,27 @@ module Aws::SSM
8547
8737
  #
8548
8738
  # @!attribute [rw] max_concurrency
8549
8739
  # The maximum number of targets allowed to run this task in parallel.
8740
+ #
8741
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8742
+ # supply a value for this option. Instead, the system inserts a
8743
+ # placeholder value of `1`, which may be reported in the response to
8744
+ # this command. This value does not affect the running of your task
8745
+ # and can be ignored.
8746
+ #
8747
+ # </note>
8550
8748
  # @return [String]
8551
8749
  #
8552
8750
  # @!attribute [rw] max_errors
8553
8751
  # The maximum number of errors allowed before the task stops being
8554
8752
  # scheduled.
8753
+ #
8754
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8755
+ # supply a value for this option. Instead, the system inserts a
8756
+ # placeholder value of `1`, which may be reported in the response to
8757
+ # this command. This value does not affect the running of your task
8758
+ # and can be ignored.
8759
+ #
8760
+ # </note>
8555
8761
  # @return [String]
8556
8762
  #
8557
8763
  # @!attribute [rw] logging_info
@@ -8901,9 +9107,11 @@ module Aws::SSM
8901
9107
  #
8902
9108
  # @!attribute [rw] path
8903
9109
  # The hierarchy for the parameter. Hierarchies start with a forward
8904
- # slash (/) and end with the parameter name. A parameter name
8905
- # hierarchy can have a maximum of 15 levels. Here is an example of a
8906
- # hierarchy: `/Finance/Prod/IAD/WinServ2016/license33`
9110
+ # slash (/). The hierachy is the parameter name except the last part
9111
+ # of the parameter. For the API call to succeeed, the last part of the
9112
+ # parameter name cannot be in the path. A parameter name hierarchy can
9113
+ # have a maximum of 15 levels. Here is an example of a hierarchy:
9114
+ # `/Finance/Prod/IAD/WinServ2016/license33 `
8907
9115
  # @return [String]
8908
9116
  #
8909
9117
  # @!attribute [rw] recursive
@@ -9191,6 +9399,8 @@ module Aws::SSM
9191
9399
  #
9192
9400
  # @!attribute [rw] setting_id
9193
9401
  # The ID of the service setting to get. The setting ID can be
9402
+ # `/ssm/automation/customer-script-log-destination`,
9403
+ # `/ssm/automation/customer-script-log-group-name`,
9194
9404
  # `/ssm/parameter-store/default-parameter-tier`,
9195
9405
  # `/ssm/parameter-store/high-throughput-enabled`, or
9196
9406
  # `/ssm/managed-instance/activation-tier`.
@@ -9648,6 +9858,11 @@ module Aws::SSM
9648
9858
  #
9649
9859
  # "InstanceIds"\|"AgentVersion"\|"PingStatus"\|"PlatformTypes"\|"ActivationIds"\|"IamRole"\|"ResourceType"\|"AssociationStatus"\|"Tag
9650
9860
  # Key"
9861
+ #
9862
+ # `Tag key` is not a valid filter. You must specify either `tag-key`
9863
+ # or `tag:keyname` and a string. Here are some valid examples:
9864
+ # tag-key, tag:123, tag:al!, tag:Windows. Here are some *invalid*
9865
+ # examples: tag-keys, Tag Key, tag:, tagKey, abc:keyname.
9651
9866
  # @return [String]
9652
9867
  #
9653
9868
  # @!attribute [rw] values
@@ -11595,13 +11810,19 @@ module Aws::SSM
11595
11810
  # @return [Array<Types::DocumentFilter>]
11596
11811
  #
11597
11812
  # @!attribute [rw] filters
11598
- # One or more DocumentKeyValuesFilter objects. Use a filter to return
11599
- # a more specific list of results. For keys, you can specify one or
11600
- # more key-value pair tags that have been applied to a document. Other
11601
- # valid keys include `Owner`, `Name`, `PlatformTypes`, `DocumentType`,
11602
- # and `TargetType`. For example, to return documents you own use
11603
- # `Key=Owner,Values=Self`. To specify a custom key-value pair, use the
11604
- # format `Key=tag:tagName,Values=valueName`.
11813
+ # One or more `DocumentKeyValuesFilter` objects. Use a filter to
11814
+ # return a more specific list of results. For keys, you can specify
11815
+ # one or more key-value pair tags that have been applied to a
11816
+ # document. Other valid keys include `Owner`, `Name`, `PlatformTypes`,
11817
+ # `DocumentType`, and `TargetType`. For example, to return documents
11818
+ # you own use `Key=Owner,Values=Self`. To specify a custom key-value
11819
+ # pair, use the format `Key=tag:tagName,Values=valueName`.
11820
+ #
11821
+ # <note markdown="1"> This API action only supports filtering documents by using a single
11822
+ # tag key and one or more tag values. For example:
11823
+ # `Key=tag:tagName,Values=valueName1,valueName2`
11824
+ #
11825
+ # </note>
11605
11826
  # @return [Array<Types::DocumentKeyValuesFilter>]
11606
11827
  #
11607
11828
  # @!attribute [rw] max_results
@@ -14766,13 +14987,14 @@ module Aws::SSM
14766
14987
  # The number of days after the release date of each patch matched by
14767
14988
  # the rule that the patch is marked as approved in the patch baseline.
14768
14989
  # For example, a value of `7` means that patches are approved seven
14769
- # days after they are released. Not supported on Ubuntu Server.
14990
+ # days after they are released. Not supported on Debian Server or
14991
+ # Ubuntu Server.
14770
14992
  # @return [Integer]
14771
14993
  #
14772
14994
  # @!attribute [rw] approve_until_date
14773
14995
  # The cutoff date for auto approval of released patches. Any patches
14774
14996
  # released on or before this date are installed automatically. Not
14775
- # supported on Ubuntu Server.
14997
+ # supported on Debian Server or Ubuntu Server.
14776
14998
  #
14777
14999
  # Enter dates in the format `YYYY-MM-DD`. For example, `2020-12-31`.
14778
15000
  # @return [String]
@@ -14861,11 +15083,20 @@ module Aws::SSM
14861
15083
  #
14862
15084
  # `[main]`
14863
15085
  #
14864
- # `cachedir=/var/cache/yum/$basesearch$releasever`
15086
+ # `name=MyCustomRepository`
15087
+ #
15088
+ # `baseurl=https://my-custom-repository`
14865
15089
  #
14866
- # `keepcache=0`
15090
+ # `enabled=1`
14867
15091
  #
14868
- # `debuglevel=2`
15092
+ # <note markdown="1"> For information about other options available for your yum
15093
+ # repository configuration, see [dnf.conf(5)][1].
15094
+ #
15095
+ # </note>
15096
+ #
15097
+ #
15098
+ #
15099
+ # [1]: https://man7.org/linux/man-pages/man5/dnf.conf.5.html
14869
15100
  # @return [String]
14870
15101
  #
14871
15102
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchSource AWS API Documentation
@@ -15147,7 +15378,11 @@ module Aws::SSM
15147
15378
  # (case-insensitive).
15148
15379
  #
15149
15380
  # * Parameter names can include only the following symbols and
15150
- # letters: `a-zA-Z0-9_.-/`
15381
+ # letters: `a-zA-Z0-9_.-`
15382
+ #
15383
+ # In addition, the slash character ( / ) is used to delineate
15384
+ # hierarchies in parameter names. For example:
15385
+ # `/Dev/Production/East/Project-ABC/MyParameter`
15151
15386
  #
15152
15387
  # * A parameter name can't include spaces.
15153
15388
  #
@@ -15155,8 +15390,8 @@ module Aws::SSM
15155
15390
  # levels.
15156
15391
  #
15157
15392
  # For additional information about valid values for parameter names,
15158
- # see [About requirements and constraints for parameter names][1] in
15159
- # the *AWS Systems Manager User Guide*.
15393
+ # see [Creating Systems Manager parameters][1] in the *AWS Systems
15394
+ # Manager User Guide*.
15160
15395
  #
15161
15396
  # <note markdown="1"> The maximum length constraint listed below includes capacity for
15162
15397
  # additional system attributes that are not part of the name. The
@@ -15170,7 +15405,7 @@ module Aws::SSM
15170
15405
  #
15171
15406
  #
15172
15407
  #
15173
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-parameter-name-constraints.html
15408
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html
15174
15409
  # @return [String]
15175
15410
  #
15176
15411
  # @!attribute [rw] description
@@ -15536,6 +15771,14 @@ module Aws::SSM
15536
15771
  # The targets to register with the maintenance window. In other words,
15537
15772
  # the instances to run commands on when the maintenance window runs.
15538
15773
  #
15774
+ # <note markdown="1"> If a single maintenance window task is registered with multiple
15775
+ # targets, its task invocations occur sequentially and not in
15776
+ # parallel. If your task must run on multiple targets at the same
15777
+ # time, register a task for each target individually and assign each
15778
+ # task the same priority level.
15779
+ #
15780
+ # </note>
15781
+ #
15539
15782
  # You can specify targets using instance IDs, resource group names, or
15540
15783
  # tags that have been applied to instances.
15541
15784
  #
@@ -15629,7 +15872,7 @@ module Aws::SSM
15629
15872
  #
15630
15873
  # {
15631
15874
  # window_id: "MaintenanceWindowId", # required
15632
- # targets: [ # required
15875
+ # targets: [
15633
15876
  # {
15634
15877
  # key: "TargetKey",
15635
15878
  # values: ["TargetValue"],
@@ -15683,8 +15926,8 @@ module Aws::SSM
15683
15926
  # },
15684
15927
  # },
15685
15928
  # priority: 1,
15686
- # max_concurrency: "MaxConcurrency", # required
15687
- # max_errors: "MaxErrors", # required
15929
+ # max_concurrency: "MaxConcurrency",
15930
+ # max_errors: "MaxErrors",
15688
15931
  # logging_info: {
15689
15932
  # s3_bucket_name: "S3BucketName", # required
15690
15933
  # s3_key_prefix: "S3KeyPrefix",
@@ -15702,6 +15945,15 @@ module Aws::SSM
15702
15945
  # @!attribute [rw] targets
15703
15946
  # The targets (either instances or maintenance window targets).
15704
15947
  #
15948
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
15949
+ # Command-type tasks. Depending on the task, targets are optional for
15950
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
15951
+ # Step Functions). For more information about running tasks that do
15952
+ # not specify targets, see [Registering maintenance window tasks
15953
+ # without targets][1] in the *AWS Systems Manager User Guide*.
15954
+ #
15955
+ # </note>
15956
+ #
15705
15957
  # Specify instances using the following format:
15706
15958
  #
15707
15959
  # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
@@ -15709,6 +15961,10 @@ module Aws::SSM
15709
15961
  # Specify maintenance window targets using the following format:
15710
15962
  #
15711
15963
  # `Key=WindowTargetIds,Values=<window-target-id-1>,<window-target-id-2>`
15964
+ #
15965
+ #
15966
+ #
15967
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
15712
15968
  # @return [Array<Types::Target>]
15713
15969
  #
15714
15970
  # @!attribute [rw] task_arn
@@ -15768,11 +16024,25 @@ module Aws::SSM
15768
16024
  #
15769
16025
  # @!attribute [rw] max_concurrency
15770
16026
  # The maximum number of targets this task can be run for in parallel.
16027
+ #
16028
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
16029
+ # supply a value for this option. Instead, the system inserts a
16030
+ # placeholder value of `1`. This value does not affect the running of
16031
+ # your task.
16032
+ #
16033
+ # </note>
15771
16034
  # @return [String]
15772
16035
  #
15773
16036
  # @!attribute [rw] max_errors
15774
16037
  # The maximum number of errors allowed before this task stops being
15775
16038
  # scheduled.
16039
+ #
16040
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
16041
+ # supply a value for this option. Instead, the system inserts a
16042
+ # placeholder value of `1`. This value does not affect the running of
16043
+ # your task.
16044
+ #
16045
+ # </note>
15776
16046
  # @return [String]
15777
16047
  #
15778
16048
  # @!attribute [rw] logging_info
@@ -15927,7 +16197,9 @@ module Aws::SSM
15927
16197
  #
15928
16198
  # @!attribute [rw] setting_id
15929
16199
  # The Amazon Resource Name (ARN) of the service setting to reset. The
15930
- # setting ID can be `/ssm/parameter-store/default-parameter-tier`,
16200
+ # setting ID can be `/ssm/automation/customer-script-log-destination`,
16201
+ # `/ssm/automation/customer-script-log-group-name`,
16202
+ # `/ssm/parameter-store/default-parameter-tier`,
15931
16203
  # `/ssm/parameter-store/high-throughput-enabled`, or
15932
16204
  # `/ssm/managed-instance/activation-tier`. For example,
15933
16205
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
@@ -16865,8 +17137,15 @@ module Aws::SSM
16865
17137
  # @return [Array<Types::Target>]
16866
17138
  #
16867
17139
  # @!attribute [rw] document_name
16868
- # Required. The name of the Systems Manager document to run. This can
16869
- # be a public document or a custom document.
17140
+ # The name of the Systems Manager document to run. This can be a
17141
+ # public document or a custom document. To run a shared document
17142
+ # belonging to another account, specify the document ARN. For more
17143
+ # information about how to use shared documents, see [Using shared SSM
17144
+ # documents][1] in the *AWS Systems Manager User Guide*.
17145
+ #
17146
+ #
17147
+ #
17148
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
16870
17149
  # @return [String]
16871
17150
  #
16872
17151
  # @!attribute [rw] document_version
@@ -17344,7 +17623,15 @@ module Aws::SSM
17344
17623
  # }
17345
17624
  #
17346
17625
  # @!attribute [rw] document_name
17347
- # The name of the Automation document to use for this execution.
17626
+ # The name of the Systems Manager document to run. This can be a
17627
+ # public document or a custom document. To run a shared document
17628
+ # belonging to another account, specify the document ARN. For more
17629
+ # information about how to use shared documents, see [Using shared SSM
17630
+ # documents][1] in the *AWS Systems Manager User Guide*.
17631
+ #
17632
+ #
17633
+ #
17634
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
17348
17635
  # @return [String]
17349
17636
  #
17350
17637
  # @!attribute [rw] document_version
@@ -17924,6 +18211,15 @@ module Aws::SSM
17924
18211
  # An array of search criteria that targets instances using a Key,Value
17925
18212
  # combination that you specify.
17926
18213
  #
18214
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
18215
+ # Command-type tasks. Depending on the task, targets are optional for
18216
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
18217
+ # Step Functions). For more information about running tasks that do not
18218
+ # specify targets, see [Registering maintenance window tasks without
18219
+ # targets][1] in the *AWS Systems Manager User Guide*.
18220
+ #
18221
+ # </note>
18222
+ #
17927
18223
  # Supported formats include the following.
17928
18224
  #
17929
18225
  # * `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3 `
@@ -17974,12 +18270,13 @@ module Aws::SSM
17974
18270
  # AWS Region where the association was created.
17975
18271
  #
17976
18272
  # For more information about how to send commands that target instances
17977
- # using `Key,Value` parameters, see [Targeting multiple instances][1] in
18273
+ # using `Key,Value` parameters, see [Targeting multiple instances][2] in
17978
18274
  # the *AWS Systems Manager User Guide*.
17979
18275
  #
17980
18276
  #
17981
18277
  #
17982
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
18278
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
18279
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
17983
18280
  #
17984
18281
  # @note When making an API call, you may pass Target
17985
18282
  # data as a hash:
@@ -19096,6 +19393,19 @@ module Aws::SSM
19096
19393
  # The targets (either instances or tags) to modify. Instances are
19097
19394
  # specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
19098
19395
  # Tags are specified using Key=tag\_name,Values=tag\_value.
19396
+ #
19397
+ # <note markdown="1"> One or more targets must be specified for maintenance window Run
19398
+ # Command-type tasks. Depending on the task, targets are optional for
19399
+ # other maintenance window task types (Automation, AWS Lambda, and AWS
19400
+ # Step Functions). For more information about running tasks that do
19401
+ # not specify targets, see [Registering maintenance window tasks
19402
+ # without targets][1] in the *AWS Systems Manager User Guide*.
19403
+ #
19404
+ # </note>
19405
+ #
19406
+ #
19407
+ #
19408
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
19099
19409
  # @return [Array<Types::Target>]
19100
19410
  #
19101
19411
  # @!attribute [rw] task_arn
@@ -19170,12 +19480,28 @@ module Aws::SSM
19170
19480
  # The new `MaxConcurrency` value you want to specify. `MaxConcurrency`
19171
19481
  # is the number of targets that are allowed to run this task in
19172
19482
  # parallel.
19483
+ #
19484
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
19485
+ # supply a value for this option. Instead, the system inserts a
19486
+ # placeholder value of `1`, which may be reported in the response to
19487
+ # this command. This value does not affect the running of your task
19488
+ # and can be ignored.
19489
+ #
19490
+ # </note>
19173
19491
  # @return [String]
19174
19492
  #
19175
19493
  # @!attribute [rw] max_errors
19176
19494
  # The new `MaxErrors` value to specify. `MaxErrors` is the maximum
19177
19495
  # number of errors that are allowed before the task stops being
19178
19496
  # scheduled.
19497
+ #
19498
+ # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
19499
+ # supply a value for this option. Instead, the system inserts a
19500
+ # placeholder value of `1`, which may be reported in the response to
19501
+ # this command. This value does not affect the running of your task
19502
+ # and can be ignored.
19503
+ #
19504
+ # </note>
19179
19505
  # @return [String]
19180
19506
  #
19181
19507
  # @!attribute [rw] logging_info
@@ -19865,6 +20191,10 @@ module Aws::SSM
19865
20191
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
19866
20192
  # The setting ID can be one of the following.
19867
20193
  #
20194
+ # * `/ssm/automation/customer-script-log-destination`
20195
+ #
20196
+ # * `/ssm/automation/customer-script-log-group-name`
20197
+ #
19868
20198
  # * `/ssm/parameter-store/default-parameter-tier`
19869
20199
  #
19870
20200
  # * `/ssm/parameter-store/high-throughput-enabled`
@@ -19886,6 +20216,12 @@ module Aws::SSM
19886
20216
  # For the `/ssm/parameter-store/high-throughput-enabled`, and
19887
20217
  # `/ssm/managed-instance/activation-tier` setting IDs, the setting
19888
20218
  # value can be true or false.
20219
+ #
20220
+ # For the `/ssm/automation/customer-script-log-destination` setting
20221
+ # ID, the setting value can be CloudWatch.
20222
+ #
20223
+ # For the `/ssm/automation/customer-script-log-group-name` setting ID,
20224
+ # the setting value can be the name of a CloudWatch Logs log group.
19889
20225
  # @return [String]
19890
20226
  #
19891
20227
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateServiceSettingRequest AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ssm
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.100.0
4
+ version: 1.105.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-12-15 00:00:00.000000000 Z
11
+ date: 2021-03-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.109.0
22
+ version: 3.112.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.109.0
32
+ version: 3.112.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement