aws-sdk-ssm 1.184.0 → 1.186.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ssm/client.rb +442 -9
- data/lib/aws-sdk-ssm/client_api.rb +246 -0
- data/lib/aws-sdk-ssm/errors.rb +37 -0
- data/lib/aws-sdk-ssm/types.rb +633 -17
- data/lib/aws-sdk-ssm.rb +1 -1
- data/sig/client.rbs +116 -0
- data/sig/errors.rbs +7 -0
- data/sig/types.rbs +168 -0
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: fb951d14ae36884e5ac5e7a1a36e891e20e9d08b5d5f888c9b547d367c20f2ec
|
4
|
+
data.tar.gz: d65962428e34cb58c43fa74b88fd8c10d7d7e1b0d0864ff420525c1f8a9ef9e8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 5cef0d5ba1dccc2398ba087c641482150bdef744828924fb95db6219250d18a0b6a303f5f79508c5f091c8d2a68d3e22764f490c2f5f8acf2c8406072413dbb7
|
7
|
+
data.tar.gz: 5c37854ea00c016d044eb95eb7891fbf6848d02058c0c8781602b57275a12518cde5cfeeec30d5a4155f3eaf73dd06b6e4b393c3a81a0c52ba3bed768830e529
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.186.0 (2024-11-21)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Added support for providing high-level overviews of managed nodes and previewing the potential impact of a runbook execution.
|
8
|
+
|
9
|
+
1.185.0 (2024-11-18)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
4
14
|
1.184.0 (2024-11-06)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.186.0
|
data/lib/aws-sdk-ssm/client.rb
CHANGED
@@ -2066,6 +2066,10 @@ module Aws::SSM
|
|
2066
2066
|
# @option params [Types::PatchFilterGroup] :global_filters
|
2067
2067
|
# A set of global filters used to include patches in the baseline.
|
2068
2068
|
#
|
2069
|
+
# The `GlobalFilters` parameter can be configured only by using the CLI
|
2070
|
+
# or an Amazon Web Services SDK. It can't be configured from the Patch
|
2071
|
+
# Manager console, and its value isn't displayed in the console.
|
2072
|
+
#
|
2069
2073
|
# @option params [Types::PatchRuleGroup] :approval_rules
|
2070
2074
|
# A set of rules used to include patches in the baseline.
|
2071
2075
|
#
|
@@ -2238,7 +2242,7 @@ module Aws::SSM
|
|
2238
2242
|
# You can configure Systems Manager Inventory to use the
|
2239
2243
|
# `SyncToDestination` type to synchronize Inventory data from multiple
|
2240
2244
|
# Amazon Web Services Regions to a single Amazon Simple Storage Service
|
2241
|
-
# (Amazon S3) bucket. For more information, see [
|
2245
|
+
# (Amazon S3) bucket. For more information, see [Creating a resource
|
2242
2246
|
# data sync for Inventory][1] in the *Amazon Web Services Systems
|
2243
2247
|
# Manager User Guide*.
|
2244
2248
|
#
|
@@ -6277,6 +6281,78 @@ module Aws::SSM
|
|
6277
6281
|
req.send_request(options)
|
6278
6282
|
end
|
6279
6283
|
|
6284
|
+
# Initiates the process of retrieving an existing preview that shows the
|
6285
|
+
# effects that running a specified Automation runbook would have on the
|
6286
|
+
# targeted resources.
|
6287
|
+
#
|
6288
|
+
# @option params [required, String] :execution_preview_id
|
6289
|
+
# The ID of the existing execution preview.
|
6290
|
+
#
|
6291
|
+
# @return [Types::GetExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6292
|
+
#
|
6293
|
+
# * {Types::GetExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
|
6294
|
+
# * {Types::GetExecutionPreviewResponse#ended_at #ended_at} => Time
|
6295
|
+
# * {Types::GetExecutionPreviewResponse#status #status} => String
|
6296
|
+
# * {Types::GetExecutionPreviewResponse#status_message #status_message} => String
|
6297
|
+
# * {Types::GetExecutionPreviewResponse#execution_preview #execution_preview} => Types::ExecutionPreview
|
6298
|
+
#
|
6299
|
+
#
|
6300
|
+
# @example Example: GetExecutionPreview
|
6301
|
+
#
|
6302
|
+
# # This example illustrates one usage of GetExecutionPreview
|
6303
|
+
#
|
6304
|
+
# resp = client.get_execution_preview({
|
6305
|
+
# execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
|
6306
|
+
# })
|
6307
|
+
#
|
6308
|
+
# resp.to_h outputs the following:
|
6309
|
+
# {
|
6310
|
+
# ended_at: Time.parse("2024-11-13T01:50:39.424000+00:00"),
|
6311
|
+
# execution_preview: {
|
6312
|
+
# automation: {
|
6313
|
+
# regions: [
|
6314
|
+
# "us-east-2",
|
6315
|
+
# ],
|
6316
|
+
# step_previews: {
|
6317
|
+
# "Undetermined" => 1,
|
6318
|
+
# },
|
6319
|
+
# total_accounts: 1,
|
6320
|
+
# },
|
6321
|
+
# },
|
6322
|
+
# execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
|
6323
|
+
# status: "Success",
|
6324
|
+
# }
|
6325
|
+
#
|
6326
|
+
# @example Request syntax with placeholder values
|
6327
|
+
#
|
6328
|
+
# resp = client.get_execution_preview({
|
6329
|
+
# execution_preview_id: "ExecutionPreviewId", # required
|
6330
|
+
# })
|
6331
|
+
#
|
6332
|
+
# @example Response structure
|
6333
|
+
#
|
6334
|
+
# resp.execution_preview_id #=> String
|
6335
|
+
# resp.ended_at #=> Time
|
6336
|
+
# resp.status #=> String, one of "Pending", "InProgress", "Success", "Failed"
|
6337
|
+
# resp.status_message #=> String
|
6338
|
+
# resp.execution_preview.automation.step_previews #=> Hash
|
6339
|
+
# resp.execution_preview.automation.step_previews["ImpactType"] #=> Integer
|
6340
|
+
# resp.execution_preview.automation.regions #=> Array
|
6341
|
+
# resp.execution_preview.automation.regions[0] #=> String
|
6342
|
+
# resp.execution_preview.automation.target_previews #=> Array
|
6343
|
+
# resp.execution_preview.automation.target_previews[0].count #=> Integer
|
6344
|
+
# resp.execution_preview.automation.target_previews[0].target_type #=> String
|
6345
|
+
# resp.execution_preview.automation.total_accounts #=> Integer
|
6346
|
+
#
|
6347
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreview AWS API Documentation
|
6348
|
+
#
|
6349
|
+
# @overload get_execution_preview(params = {})
|
6350
|
+
# @param [Hash] params ({})
|
6351
|
+
def get_execution_preview(params = {}, options = {})
|
6352
|
+
req = build_request(:get_execution_preview, params)
|
6353
|
+
req.send_request(options)
|
6354
|
+
end
|
6355
|
+
|
6280
6356
|
# Query inventory information. This includes managed node status, such
|
6281
6357
|
# as `Stopped` or `Terminated`.
|
6282
6358
|
#
|
@@ -7473,16 +7549,20 @@ module Aws::SSM
|
|
7473
7549
|
# The ID of the service setting to get. The setting ID can be one of the
|
7474
7550
|
# following.
|
7475
7551
|
#
|
7476
|
-
# * `/ssm/
|
7552
|
+
# * `/ssm/appmanager/appmanager-enabled`
|
7477
7553
|
#
|
7478
7554
|
# * `/ssm/automation/customer-script-log-destination`
|
7479
7555
|
#
|
7480
7556
|
# * `/ssm/automation/customer-script-log-group-name`
|
7481
7557
|
#
|
7558
|
+
# * /ssm/automation/enable-adaptive-concurrency
|
7559
|
+
#
|
7482
7560
|
# * `/ssm/documents/console/public-sharing-permission`
|
7483
7561
|
#
|
7484
7562
|
# * `/ssm/managed-instance/activation-tier`
|
7485
7563
|
#
|
7564
|
+
# * `/ssm/managed-instance/default-ec2-instance-management-role`
|
7565
|
+
#
|
7486
7566
|
# * `/ssm/opsinsights/opscenter`
|
7487
7567
|
#
|
7488
7568
|
# * `/ssm/parameter-store/default-parameter-tier`
|
@@ -8393,6 +8473,246 @@ module Aws::SSM
|
|
8393
8473
|
req.send_request(options)
|
8394
8474
|
end
|
8395
8475
|
|
8476
|
+
# Takes in filters and returns a list of managed nodes matching the
|
8477
|
+
# filter criteria.
|
8478
|
+
#
|
8479
|
+
# @option params [String] :sync_name
|
8480
|
+
# The name of the resource data sync to retrieve information about.
|
8481
|
+
# Required for cross-account/cross-Region configurations. Optional for
|
8482
|
+
# single account/single-Region configurations.
|
8483
|
+
#
|
8484
|
+
# @option params [Array<Types::NodeFilter>] :filters
|
8485
|
+
# One or more filters. Use a filter to return a more specific list of
|
8486
|
+
# managed nodes.
|
8487
|
+
#
|
8488
|
+
# @option params [String] :next_token
|
8489
|
+
# The token for the next set of items to return. (You received this
|
8490
|
+
# token from a previous call.)
|
8491
|
+
#
|
8492
|
+
# @option params [Integer] :max_results
|
8493
|
+
# The maximum number of items to return for this call. The call also
|
8494
|
+
# returns a token that you can specify in a subsequent call to get the
|
8495
|
+
# next set of results.
|
8496
|
+
#
|
8497
|
+
# @return [Types::ListNodesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8498
|
+
#
|
8499
|
+
# * {Types::ListNodesResult#nodes #nodes} => Array<Types::Node>
|
8500
|
+
# * {Types::ListNodesResult#next_token #next_token} => String
|
8501
|
+
#
|
8502
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
8503
|
+
#
|
8504
|
+
#
|
8505
|
+
# @example Example: ListNodes
|
8506
|
+
#
|
8507
|
+
# # This example illustrates one usage of ListNodes
|
8508
|
+
#
|
8509
|
+
# resp = client.list_nodes({
|
8510
|
+
# filters: [
|
8511
|
+
# {
|
8512
|
+
# key: "Region",
|
8513
|
+
# type: "Equal",
|
8514
|
+
# values: [
|
8515
|
+
# "us-east-2",
|
8516
|
+
# ],
|
8517
|
+
# },
|
8518
|
+
# ],
|
8519
|
+
# max_results: 1,
|
8520
|
+
# sync_name: "AWS-QuickSetup-ManagedNode",
|
8521
|
+
# })
|
8522
|
+
#
|
8523
|
+
# resp.to_h outputs the following:
|
8524
|
+
# {
|
8525
|
+
# next_token: "A9lT8CAxj9aDFRi+MNAoFq08IEXAMPLE",
|
8526
|
+
# nodes: [
|
8527
|
+
# {
|
8528
|
+
# capture_time: Time.parse("2024-11-19T22:01:18"),
|
8529
|
+
# id: "i-02573cafcfEXAMPLE",
|
8530
|
+
# node_type: {
|
8531
|
+
# instance: {
|
8532
|
+
# agent_type: "amazon-ssm-agent",
|
8533
|
+
# agent_version: "3.3.859.0",
|
8534
|
+
# computer_name: "ip-192.0.2.0.ec2.internal",
|
8535
|
+
# instance_status: "Active",
|
8536
|
+
# ip_address: "192.0.2.0",
|
8537
|
+
# managed_status: "Managed",
|
8538
|
+
# platform_name: "Amazon Linux",
|
8539
|
+
# platform_type: "Linux",
|
8540
|
+
# platform_version: "2023",
|
8541
|
+
# resource_type: "EC2Instance",
|
8542
|
+
# },
|
8543
|
+
# },
|
8544
|
+
# owner: {
|
8545
|
+
# account_id: "111122223333",
|
8546
|
+
# organizational_unit_id: "ou-b8dn-sasv9tfp",
|
8547
|
+
# organizational_unit_path: "r-b8dn/ou-b8dn-sasv9tfp",
|
8548
|
+
# },
|
8549
|
+
# region: "us-east-2",
|
8550
|
+
# },
|
8551
|
+
# ],
|
8552
|
+
# }
|
8553
|
+
#
|
8554
|
+
# @example Request syntax with placeholder values
|
8555
|
+
#
|
8556
|
+
# resp = client.list_nodes({
|
8557
|
+
# sync_name: "ResourceDataSyncName",
|
8558
|
+
# filters: [
|
8559
|
+
# {
|
8560
|
+
# key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
|
8561
|
+
# values: ["NodeFilterValue"], # required
|
8562
|
+
# type: "Equal", # accepts Equal, NotEqual, BeginWith
|
8563
|
+
# },
|
8564
|
+
# ],
|
8565
|
+
# next_token: "NextToken",
|
8566
|
+
# max_results: 1,
|
8567
|
+
# })
|
8568
|
+
#
|
8569
|
+
# @example Response structure
|
8570
|
+
#
|
8571
|
+
# resp.nodes #=> Array
|
8572
|
+
# resp.nodes[0].capture_time #=> Time
|
8573
|
+
# resp.nodes[0].id #=> String
|
8574
|
+
# resp.nodes[0].owner.account_id #=> String
|
8575
|
+
# resp.nodes[0].owner.organizational_unit_id #=> String
|
8576
|
+
# resp.nodes[0].owner.organizational_unit_path #=> String
|
8577
|
+
# resp.nodes[0].region #=> String
|
8578
|
+
# resp.nodes[0].node_type.instance.agent_type #=> String
|
8579
|
+
# resp.nodes[0].node_type.instance.agent_version #=> String
|
8580
|
+
# resp.nodes[0].node_type.instance.computer_name #=> String
|
8581
|
+
# resp.nodes[0].node_type.instance.instance_status #=> String
|
8582
|
+
# resp.nodes[0].node_type.instance.ip_address #=> String
|
8583
|
+
# resp.nodes[0].node_type.instance.managed_status #=> String, one of "All", "Managed", "Unmanaged"
|
8584
|
+
# resp.nodes[0].node_type.instance.platform_type #=> String, one of "Windows", "Linux", "MacOS"
|
8585
|
+
# resp.nodes[0].node_type.instance.platform_name #=> String
|
8586
|
+
# resp.nodes[0].node_type.instance.platform_version #=> String
|
8587
|
+
# resp.nodes[0].node_type.instance.resource_type #=> String, one of "ManagedInstance", "EC2Instance"
|
8588
|
+
# resp.next_token #=> String
|
8589
|
+
#
|
8590
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodes AWS API Documentation
|
8591
|
+
#
|
8592
|
+
# @overload list_nodes(params = {})
|
8593
|
+
# @param [Hash] params ({})
|
8594
|
+
def list_nodes(params = {}, options = {})
|
8595
|
+
req = build_request(:list_nodes, params)
|
8596
|
+
req.send_request(options)
|
8597
|
+
end
|
8598
|
+
|
8599
|
+
# Generates a summary of managed instance/node metadata based on the
|
8600
|
+
# filters and aggregators you specify. Results are grouped by the input
|
8601
|
+
# aggregator you specify.
|
8602
|
+
#
|
8603
|
+
# @option params [String] :sync_name
|
8604
|
+
# The name of the resource data sync to retrieve information about.
|
8605
|
+
# Required for cross-account/cross-Region configuration. Optional for
|
8606
|
+
# single account/single-Region configurations.
|
8607
|
+
#
|
8608
|
+
# @option params [Array<Types::NodeFilter>] :filters
|
8609
|
+
# One or more filters. Use a filter to generate a summary that matches
|
8610
|
+
# your specified filter criteria.
|
8611
|
+
#
|
8612
|
+
# @option params [required, Array<Types::NodeAggregator>] :aggregators
|
8613
|
+
# Specify one or more aggregators to return a count of managed nodes
|
8614
|
+
# that match that expression. For example, a count of managed nodes by
|
8615
|
+
# operating system.
|
8616
|
+
#
|
8617
|
+
# @option params [String] :next_token
|
8618
|
+
# The token for the next set of items to return. (You received this
|
8619
|
+
# token from a previous call.) The call also returns a token that you
|
8620
|
+
# can specify in a subsequent call to get the next set of results.
|
8621
|
+
#
|
8622
|
+
# @option params [Integer] :max_results
|
8623
|
+
# The maximum number of items to return for this call. The call also
|
8624
|
+
# returns a token that you can specify in a subsequent call to get the
|
8625
|
+
# next set of results.
|
8626
|
+
#
|
8627
|
+
# @return [Types::ListNodesSummaryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8628
|
+
#
|
8629
|
+
# * {Types::ListNodesSummaryResult#summary #summary} => Array<Hash<String,String>>
|
8630
|
+
# * {Types::ListNodesSummaryResult#next_token #next_token} => String
|
8631
|
+
#
|
8632
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
8633
|
+
#
|
8634
|
+
#
|
8635
|
+
# @example Example: ListNodesSummary
|
8636
|
+
#
|
8637
|
+
# # This example illustrates one usage of ListNodesSummary
|
8638
|
+
#
|
8639
|
+
# resp = client.list_nodes_summary({
|
8640
|
+
# aggregators: [
|
8641
|
+
# {
|
8642
|
+
# aggregator_type: "Count",
|
8643
|
+
# attribute_name: "Region",
|
8644
|
+
# type_name: "Instance",
|
8645
|
+
# },
|
8646
|
+
# ],
|
8647
|
+
# filters: [
|
8648
|
+
# {
|
8649
|
+
# key: "InstanceStatus",
|
8650
|
+
# type: "Equal",
|
8651
|
+
# values: [
|
8652
|
+
# "Active",
|
8653
|
+
# ],
|
8654
|
+
# },
|
8655
|
+
# ],
|
8656
|
+
# max_results: 2,
|
8657
|
+
# next_token: "A9lT8CAxj9aDFRi+MNAoFq08I---EXAMPLE",
|
8658
|
+
# sync_name: "AWS-QuickSetup-ManagedNode",
|
8659
|
+
# })
|
8660
|
+
#
|
8661
|
+
# resp.to_h outputs the following:
|
8662
|
+
# {
|
8663
|
+
# summary: [
|
8664
|
+
# {
|
8665
|
+
# "Count" => "26",
|
8666
|
+
# "Region" => "us-east-1",
|
8667
|
+
# },
|
8668
|
+
# {
|
8669
|
+
# "Count" => "7",
|
8670
|
+
# "Region" => "us-east-2",
|
8671
|
+
# },
|
8672
|
+
# ],
|
8673
|
+
# }
|
8674
|
+
#
|
8675
|
+
# @example Request syntax with placeholder values
|
8676
|
+
#
|
8677
|
+
# resp = client.list_nodes_summary({
|
8678
|
+
# sync_name: "ResourceDataSyncName",
|
8679
|
+
# filters: [
|
8680
|
+
# {
|
8681
|
+
# key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
|
8682
|
+
# values: ["NodeFilterValue"], # required
|
8683
|
+
# type: "Equal", # accepts Equal, NotEqual, BeginWith
|
8684
|
+
# },
|
8685
|
+
# ],
|
8686
|
+
# aggregators: [ # required
|
8687
|
+
# {
|
8688
|
+
# aggregator_type: "Count", # required, accepts Count
|
8689
|
+
# type_name: "Instance", # required, accepts Instance
|
8690
|
+
# attribute_name: "AgentVersion", # required, accepts AgentVersion, PlatformName, PlatformType, PlatformVersion, Region, ResourceType
|
8691
|
+
# aggregators: {
|
8692
|
+
# # recursive NodeAggregatorList
|
8693
|
+
# },
|
8694
|
+
# },
|
8695
|
+
# ],
|
8696
|
+
# next_token: "NextToken",
|
8697
|
+
# max_results: 1,
|
8698
|
+
# })
|
8699
|
+
#
|
8700
|
+
# @example Response structure
|
8701
|
+
#
|
8702
|
+
# resp.summary #=> Array
|
8703
|
+
# resp.summary[0] #=> Hash
|
8704
|
+
# resp.summary[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
8705
|
+
# resp.next_token #=> String
|
8706
|
+
#
|
8707
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummary AWS API Documentation
|
8708
|
+
#
|
8709
|
+
# @overload list_nodes_summary(params = {})
|
8710
|
+
# @param [Hash] params ({})
|
8711
|
+
def list_nodes_summary(params = {}, options = {})
|
8712
|
+
req = build_request(:list_nodes_summary, params)
|
8713
|
+
req.send_request(options)
|
8714
|
+
end
|
8715
|
+
|
8396
8716
|
# Returns a list of all OpsItem events in the current Amazon Web
|
8397
8717
|
# Services Region and Amazon Web Services account. You can limit the
|
8398
8718
|
# results to events associated with specific OpsItems by specifying a
|
@@ -9729,7 +10049,6 @@ module Aws::SSM
|
|
9729
10049
|
# command associated with the task. However, there is no guarantee
|
9730
10050
|
# that the command will be terminated and the underlying process
|
9731
10051
|
# stopped.
|
9732
|
-
#
|
9733
10052
|
# The status for tasks that are not completed is `TIMED_OUT`.
|
9734
10053
|
#
|
9735
10054
|
# @option params [Types::AlarmConfiguration] :alarm_configuration
|
@@ -9917,16 +10236,20 @@ module Aws::SSM
|
|
9917
10236
|
# The Amazon Resource Name (ARN) of the service setting to reset. The
|
9918
10237
|
# setting ID can be one of the following.
|
9919
10238
|
#
|
9920
|
-
# * `/ssm/
|
10239
|
+
# * `/ssm/appmanager/appmanager-enabled`
|
9921
10240
|
#
|
9922
10241
|
# * `/ssm/automation/customer-script-log-destination`
|
9923
10242
|
#
|
9924
10243
|
# * `/ssm/automation/customer-script-log-group-name`
|
9925
10244
|
#
|
10245
|
+
# * /ssm/automation/enable-adaptive-concurrency
|
10246
|
+
#
|
9926
10247
|
# * `/ssm/documents/console/public-sharing-permission`
|
9927
10248
|
#
|
9928
10249
|
# * `/ssm/managed-instance/activation-tier`
|
9929
10250
|
#
|
10251
|
+
# * `/ssm/managed-instance/default-ec2-instance-management-role`
|
10252
|
+
#
|
9930
10253
|
# * `/ssm/opsinsights/opscenter`
|
9931
10254
|
#
|
9932
10255
|
# * `/ssm/parameter-store/default-parameter-tier`
|
@@ -10700,6 +11023,107 @@ module Aws::SSM
|
|
10700
11023
|
req.send_request(options)
|
10701
11024
|
end
|
10702
11025
|
|
11026
|
+
# Initiates the process of creating a preview showing the effects that
|
11027
|
+
# running a specified Automation runbook would have on the targeted
|
11028
|
+
# resources.
|
11029
|
+
#
|
11030
|
+
# @option params [required, String] :document_name
|
11031
|
+
# The name of the Automation runbook to run. The result of the execution
|
11032
|
+
# preview indicates what the impact would be of running this runbook.
|
11033
|
+
#
|
11034
|
+
# @option params [String] :document_version
|
11035
|
+
# The version of the Automation runbook to run. The default value is
|
11036
|
+
# `$DEFAULT`.
|
11037
|
+
#
|
11038
|
+
# @option params [Types::ExecutionInputs] :execution_inputs
|
11039
|
+
# Information about the inputs that can be specified for the preview
|
11040
|
+
# operation.
|
11041
|
+
#
|
11042
|
+
# @return [Types::StartExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
11043
|
+
#
|
11044
|
+
# * {Types::StartExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
|
11045
|
+
#
|
11046
|
+
#
|
11047
|
+
# @example Example: StartExecutionPreview
|
11048
|
+
#
|
11049
|
+
# # This example illustrates one usage of StartExecutionPreview
|
11050
|
+
#
|
11051
|
+
# resp = client.start_execution_preview({
|
11052
|
+
# document_name: "AWS-StartEC2Instance",
|
11053
|
+
# })
|
11054
|
+
#
|
11055
|
+
# resp.to_h outputs the following:
|
11056
|
+
# {
|
11057
|
+
# execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
|
11058
|
+
# }
|
11059
|
+
#
|
11060
|
+
# @example Request syntax with placeholder values
|
11061
|
+
#
|
11062
|
+
# resp = client.start_execution_preview({
|
11063
|
+
# document_name: "DocumentName", # required
|
11064
|
+
# document_version: "DocumentVersion",
|
11065
|
+
# execution_inputs: {
|
11066
|
+
# automation: {
|
11067
|
+
# parameters: {
|
11068
|
+
# "AutomationParameterKey" => ["AutomationParameterValue"],
|
11069
|
+
# },
|
11070
|
+
# target_parameter_name: "AutomationParameterKey",
|
11071
|
+
# targets: [
|
11072
|
+
# {
|
11073
|
+
# key: "TargetKey",
|
11074
|
+
# values: ["TargetValue"],
|
11075
|
+
# },
|
11076
|
+
# ],
|
11077
|
+
# target_maps: [
|
11078
|
+
# {
|
11079
|
+
# "TargetMapKey" => ["TargetMapValue"],
|
11080
|
+
# },
|
11081
|
+
# ],
|
11082
|
+
# target_locations: [
|
11083
|
+
# {
|
11084
|
+
# accounts: ["Account"],
|
11085
|
+
# regions: ["Region"],
|
11086
|
+
# target_location_max_concurrency: "MaxConcurrency",
|
11087
|
+
# target_location_max_errors: "MaxErrors",
|
11088
|
+
# execution_role_name: "ExecutionRoleName",
|
11089
|
+
# target_location_alarm_configuration: {
|
11090
|
+
# ignore_poll_alarm_failure: false,
|
11091
|
+
# alarms: [ # required
|
11092
|
+
# {
|
11093
|
+
# name: "AlarmName", # required
|
11094
|
+
# },
|
11095
|
+
# ],
|
11096
|
+
# },
|
11097
|
+
# include_child_organization_units: false,
|
11098
|
+
# exclude_accounts: ["ExcludeAccount"],
|
11099
|
+
# targets: [
|
11100
|
+
# {
|
11101
|
+
# key: "TargetKey",
|
11102
|
+
# values: ["TargetValue"],
|
11103
|
+
# },
|
11104
|
+
# ],
|
11105
|
+
# targets_max_concurrency: "MaxConcurrency",
|
11106
|
+
# targets_max_errors: "MaxErrors",
|
11107
|
+
# },
|
11108
|
+
# ],
|
11109
|
+
# target_locations_url: "TargetLocationsURL",
|
11110
|
+
# },
|
11111
|
+
# },
|
11112
|
+
# })
|
11113
|
+
#
|
11114
|
+
# @example Response structure
|
11115
|
+
#
|
11116
|
+
# resp.execution_preview_id #=> String
|
11117
|
+
#
|
11118
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreview AWS API Documentation
|
11119
|
+
#
|
11120
|
+
# @overload start_execution_preview(params = {})
|
11121
|
+
# @param [Hash] params ({})
|
11122
|
+
def start_execution_preview(params = {}, options = {})
|
11123
|
+
req = build_request(:start_execution_preview, params)
|
11124
|
+
req.send_request(options)
|
11125
|
+
end
|
11126
|
+
|
10703
11127
|
# Initiates a connection to a target (for example, a managed node) for a
|
10704
11128
|
# Session Manager session. Returns a URL and token that can be used to
|
10705
11129
|
# open a WebSocket connection for sending input and receiving outputs.
|
@@ -12033,7 +12457,6 @@ module Aws::SSM
|
|
12033
12457
|
# command associated with the task. However, there is no guarantee
|
12034
12458
|
# that the command will be terminated and the underlying process
|
12035
12459
|
# stopped.
|
12036
|
-
#
|
12037
12460
|
# The status for tasks that are not completed is `TIMED_OUT`.
|
12038
12461
|
#
|
12039
12462
|
# @option params [Types::AlarmConfiguration] :alarm_configuration
|
@@ -12456,6 +12879,10 @@ module Aws::SSM
|
|
12456
12879
|
# @option params [Types::PatchFilterGroup] :global_filters
|
12457
12880
|
# A set of global filters used to include patches in the baseline.
|
12458
12881
|
#
|
12882
|
+
# The `GlobalFilters` parameter can be configured only by using the CLI
|
12883
|
+
# or an Amazon Web Services SDK. It can't be configured from the Patch
|
12884
|
+
# Manager console, and its value isn't displayed in the console.
|
12885
|
+
#
|
12459
12886
|
# @option params [Types::PatchRuleGroup] :approval_rules
|
12460
12887
|
# A set of rules used to include patches in the baseline.
|
12461
12888
|
#
|
@@ -12718,16 +13145,20 @@ module Aws::SSM
|
|
12718
13145
|
# `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
|
12719
13146
|
# The setting ID can be one of the following.
|
12720
13147
|
#
|
12721
|
-
# * `/ssm/
|
13148
|
+
# * `/ssm/appmanager/appmanager-enabled`
|
12722
13149
|
#
|
12723
13150
|
# * `/ssm/automation/customer-script-log-destination`
|
12724
13151
|
#
|
12725
13152
|
# * `/ssm/automation/customer-script-log-group-name`
|
12726
13153
|
#
|
13154
|
+
# * /ssm/automation/enable-adaptive-concurrency
|
13155
|
+
#
|
12727
13156
|
# * `/ssm/documents/console/public-sharing-permission`
|
12728
13157
|
#
|
12729
13158
|
# * `/ssm/managed-instance/activation-tier`
|
12730
13159
|
#
|
13160
|
+
# * `/ssm/managed-instance/default-ec2-instance-management-role`
|
13161
|
+
#
|
12731
13162
|
# * `/ssm/opsinsights/opscenter`
|
12732
13163
|
#
|
12733
13164
|
# * `/ssm/parameter-store/default-parameter-tier`
|
@@ -12746,8 +13177,7 @@ module Aws::SSM
|
|
12746
13177
|
# The new value to specify for the service setting. The following list
|
12747
13178
|
# specifies the available values for each setting.
|
12748
13179
|
#
|
12749
|
-
# * For `/ssm/
|
12750
|
-
# enter the name of an IAM role.
|
13180
|
+
# * For `/ssm/appmanager/appmanager-enabled`, enter `True` or `False`.
|
12751
13181
|
#
|
12752
13182
|
# * For `/ssm/automation/customer-script-log-destination`, enter
|
12753
13183
|
# `CloudWatch`.
|
@@ -12761,6 +13191,9 @@ module Aws::SSM
|
|
12761
13191
|
# * For `/ssm/managed-instance/activation-tier`, enter `standard` or
|
12762
13192
|
# `advanced`.
|
12763
13193
|
#
|
13194
|
+
# * For `/ssm/managed-instance/default-ec2-instance-management-role`,
|
13195
|
+
# enter the name of an IAM role.
|
13196
|
+
#
|
12764
13197
|
# * For `/ssm/opsinsights/opscenter`, enter `Enabled` or `Disabled`.
|
12765
13198
|
#
|
12766
13199
|
# * For `/ssm/parameter-store/default-parameter-tier`, enter `Standard`,
|
@@ -12805,7 +13238,7 @@ module Aws::SSM
|
|
12805
13238
|
tracer: tracer
|
12806
13239
|
)
|
12807
13240
|
context[:gem_name] = 'aws-sdk-ssm'
|
12808
|
-
context[:gem_version] = '1.
|
13241
|
+
context[:gem_version] = '1.186.0'
|
12809
13242
|
Seahorse::Client::Request.new(handlers, context)
|
12810
13243
|
end
|
12811
13244
|
|