aws-sdk-cloudformation 1.10.0 → 1.11.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 +4 -4
- data/lib/aws-sdk-cloudformation.rb +1 -1
- data/lib/aws-sdk-cloudformation/client.rb +330 -15
- data/lib/aws-sdk-cloudformation/client_api.rb +160 -0
- data/lib/aws-sdk-cloudformation/stack.rb +14 -0
- data/lib/aws-sdk-cloudformation/stack_resource.rb +14 -0
- data/lib/aws-sdk-cloudformation/stack_resource_summary.rb +14 -0
- data/lib/aws-sdk-cloudformation/types.rb +678 -11
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz: '
|
3
|
+
metadata.gz: 1da8953ca5679635ac12b311f08b59862b926890
|
4
|
+
data.tar.gz: '096f0d873c607479636e836bb97245e4c8597201'
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: c3cffc4b020daad01053c6b3c06e2fcf22df05ec39c5da60a89b906c5f633cd4596b684dbffcbc71d9676eb94957abfd92d06133e78fc3bfee5db27dae08f4fd
|
7
|
+
data.tar.gz: d3bd47531c9ccac1fed678b064699cb51cd0e34adb53a334e65a57c506d65b5c86ecc17d3961527db0bb8fe1329a526e6d0e9baa32062cd072148371ca894ecb
|
@@ -15,6 +15,7 @@ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
|
|
15
15
|
require 'aws-sdk-core/plugins/retry_errors.rb'
|
16
16
|
require 'aws-sdk-core/plugins/global_configuration.rb'
|
17
17
|
require 'aws-sdk-core/plugins/regional_endpoint.rb'
|
18
|
+
require 'aws-sdk-core/plugins/endpoint_discovery.rb'
|
18
19
|
require 'aws-sdk-core/plugins/response_paging.rb'
|
19
20
|
require 'aws-sdk-core/plugins/stub_responses.rb'
|
20
21
|
require 'aws-sdk-core/plugins/idempotency_token.rb'
|
@@ -45,6 +46,7 @@ module Aws::CloudFormation
|
|
45
46
|
add_plugin(Aws::Plugins::RetryErrors)
|
46
47
|
add_plugin(Aws::Plugins::GlobalConfiguration)
|
47
48
|
add_plugin(Aws::Plugins::RegionalEndpoint)
|
49
|
+
add_plugin(Aws::Plugins::EndpointDiscovery)
|
48
50
|
add_plugin(Aws::Plugins::ResponsePaging)
|
49
51
|
add_plugin(Aws::Plugins::StubResponses)
|
50
52
|
add_plugin(Aws::Plugins::IdempotencyToken)
|
@@ -98,6 +100,10 @@ module Aws::CloudFormation
|
|
98
100
|
#
|
99
101
|
# @option options [String] :access_key_id
|
100
102
|
#
|
103
|
+
# @option options [Boolean] :active_endpoint_cache (false)
|
104
|
+
# When set to `true`, a thread polling for endpoints will be running in
|
105
|
+
# the background every 60 secs (default). Defaults to `false`.
|
106
|
+
#
|
101
107
|
# @option options [Boolean] :client_side_monitoring (false)
|
102
108
|
# When `true`, client-side metrics will be collected for all API requests from
|
103
109
|
# this client.
|
@@ -123,6 +129,21 @@ module Aws::CloudFormation
|
|
123
129
|
# option. You should only configure an `:endpoint` when connecting
|
124
130
|
# to test endpoints. This should be avalid HTTP(S) URI.
|
125
131
|
#
|
132
|
+
# @option options [Integer] :endpoint_cache_max_entries (1000)
|
133
|
+
# Used for the maximum size limit of the LRU cache storing endpoints data
|
134
|
+
# for endpoint discovery enabled operations. Defaults to 1000.
|
135
|
+
#
|
136
|
+
# @option options [Integer] :endpoint_cache_max_threads (10)
|
137
|
+
# Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
|
138
|
+
#
|
139
|
+
# @option options [Integer] :endpoint_cache_poll_interval (60)
|
140
|
+
# When :endpoint_discovery and :active_endpoint_cache is enabled,
|
141
|
+
# Use this option to config the time interval in seconds for making
|
142
|
+
# requests fetching endpoints information. Defaults to 60 sec.
|
143
|
+
#
|
144
|
+
# @option options [Boolean] :endpoint_discovery (false)
|
145
|
+
# When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
|
146
|
+
#
|
126
147
|
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
127
148
|
# The log formatter.
|
128
149
|
#
|
@@ -382,11 +403,7 @@ module Aws::CloudFormation
|
|
382
403
|
#
|
383
404
|
# @option params [Array<Types::Parameter>] :parameters
|
384
405
|
# A list of `Parameter` structures that specify input parameters for the
|
385
|
-
# change set. For more information, see the
|
386
|
-
#
|
387
|
-
#
|
388
|
-
#
|
389
|
-
# [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html
|
406
|
+
# change set. For more information, see the Parameter data type.
|
390
407
|
#
|
391
408
|
# @option params [Array<String>] :capabilities
|
392
409
|
# A list of values that you must specify before AWS CloudFormation can
|
@@ -1469,6 +1486,69 @@ module Aws::CloudFormation
|
|
1469
1486
|
req.send_request(options)
|
1470
1487
|
end
|
1471
1488
|
|
1489
|
+
# Returns information about a stack drift detection operation. A stack
|
1490
|
+
# drift detection operation detects whether a stack's actual
|
1491
|
+
# configuration differs, or has *drifted*, from it's expected
|
1492
|
+
# configuration, as defined in the stack template and any values
|
1493
|
+
# specified as template parameters. A stack is considered to have
|
1494
|
+
# drifted if one or more of its resources have drifted. For more
|
1495
|
+
# information on stack and resource drift, see [Detecting Unregulated
|
1496
|
+
# Configuration Changes to Stacks and Resources][1].
|
1497
|
+
#
|
1498
|
+
# Use DetectStackDrift to initiate a stack drift detection operation.
|
1499
|
+
# `DetectStackDrift` returns a `StackDriftDetectionId` you can use to
|
1500
|
+
# monitor the progress of the operation using
|
1501
|
+
# `DescribeStackDriftDetectionStatus`. Once the drift detection
|
1502
|
+
# operation has completed, use DescribeStackResourceDrifts to return
|
1503
|
+
# drift information about the stack and its resources.
|
1504
|
+
#
|
1505
|
+
#
|
1506
|
+
#
|
1507
|
+
# [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
|
1508
|
+
#
|
1509
|
+
# @option params [required, String] :stack_drift_detection_id
|
1510
|
+
# The ID of the drift detection results of this operation.
|
1511
|
+
#
|
1512
|
+
# AWS CloudFormation generates new results, with a new drift detection
|
1513
|
+
# ID, each time this operation is run. However, the number of drift
|
1514
|
+
# results AWS CloudFormation retains for any given stack, and for how
|
1515
|
+
# long, may vary.
|
1516
|
+
#
|
1517
|
+
# @return [Types::DescribeStackDriftDetectionStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1518
|
+
#
|
1519
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#stack_id #stack_id} => String
|
1520
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#stack_drift_detection_id #stack_drift_detection_id} => String
|
1521
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#stack_drift_status #stack_drift_status} => String
|
1522
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#detection_status #detection_status} => String
|
1523
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#detection_status_reason #detection_status_reason} => String
|
1524
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#drifted_stack_resource_count #drifted_stack_resource_count} => Integer
|
1525
|
+
# * {Types::DescribeStackDriftDetectionStatusOutput#timestamp #timestamp} => Time
|
1526
|
+
#
|
1527
|
+
# @example Request syntax with placeholder values
|
1528
|
+
#
|
1529
|
+
# resp = client.describe_stack_drift_detection_status({
|
1530
|
+
# stack_drift_detection_id: "StackDriftDetectionId", # required
|
1531
|
+
# })
|
1532
|
+
#
|
1533
|
+
# @example Response structure
|
1534
|
+
#
|
1535
|
+
# resp.stack_id #=> String
|
1536
|
+
# resp.stack_drift_detection_id #=> String
|
1537
|
+
# resp.stack_drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
|
1538
|
+
# resp.detection_status #=> String, one of "DETECTION_IN_PROGRESS", "DETECTION_FAILED", "DETECTION_COMPLETE"
|
1539
|
+
# resp.detection_status_reason #=> String
|
1540
|
+
# resp.drifted_stack_resource_count #=> Integer
|
1541
|
+
# resp.timestamp #=> Time
|
1542
|
+
#
|
1543
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackDriftDetectionStatus AWS API Documentation
|
1544
|
+
#
|
1545
|
+
# @overload describe_stack_drift_detection_status(params = {})
|
1546
|
+
# @param [Hash] params ({})
|
1547
|
+
def describe_stack_drift_detection_status(params = {}, options = {})
|
1548
|
+
req = build_request(:describe_stack_drift_detection_status, params)
|
1549
|
+
req.send_request(options)
|
1550
|
+
end
|
1551
|
+
|
1472
1552
|
# Returns all stack related events for a specified stack in reverse
|
1473
1553
|
# chronological order. For more information about a stack's event
|
1474
1554
|
# history, go to [Stacks][1] in the AWS CloudFormation User Guide.
|
@@ -1630,6 +1710,8 @@ module Aws::CloudFormation
|
|
1630
1710
|
# resp.stack_resource_detail.resource_status_reason #=> String
|
1631
1711
|
# resp.stack_resource_detail.description #=> String
|
1632
1712
|
# resp.stack_resource_detail.metadata #=> String
|
1713
|
+
# resp.stack_resource_detail.drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
1714
|
+
# resp.stack_resource_detail.drift_information.last_check_timestamp #=> Time
|
1633
1715
|
#
|
1634
1716
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackResource AWS API Documentation
|
1635
1717
|
#
|
@@ -1640,6 +1722,99 @@ module Aws::CloudFormation
|
|
1640
1722
|
req.send_request(options)
|
1641
1723
|
end
|
1642
1724
|
|
1725
|
+
# Returns drift information for the resources that have been checked for
|
1726
|
+
# drift in the specified stack. This includes actual and expected
|
1727
|
+
# configuration values for resources where AWS CloudFormation detects
|
1728
|
+
# configuration drift.
|
1729
|
+
#
|
1730
|
+
# For a given stack, there will be one `StackResourceDrift` for each
|
1731
|
+
# stack resource that has been checked for drift. Resources that have
|
1732
|
+
# not yet been checked for drift are not included. Resources that do not
|
1733
|
+
# currently support drift detection are not checked, and so not
|
1734
|
+
# included. For a list of resources that support drift detection, see
|
1735
|
+
# [Resources that Support Drift Detection][1].
|
1736
|
+
#
|
1737
|
+
# Use DetectStackResourceDrift to detect drift on individual resources,
|
1738
|
+
# or DetectStackDrift to detect drift on all supported resources for a
|
1739
|
+
# given stack.
|
1740
|
+
#
|
1741
|
+
#
|
1742
|
+
#
|
1743
|
+
# [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html
|
1744
|
+
#
|
1745
|
+
# @option params [required, String] :stack_name
|
1746
|
+
# The name of the stack for which you want drift information.
|
1747
|
+
#
|
1748
|
+
# @option params [Array<String>] :stack_resource_drift_status_filters
|
1749
|
+
# The resource drift status values to use as filters for the resource
|
1750
|
+
# drift results returned.
|
1751
|
+
#
|
1752
|
+
# * `DELETED`\: The resource differs from its expected template
|
1753
|
+
# configuration in that the resource has been deleted.
|
1754
|
+
#
|
1755
|
+
# * `MODIFIED`\: One or more resource properties differ from their
|
1756
|
+
# expected template values.
|
1757
|
+
#
|
1758
|
+
# * `IN_SYNC`\: The resources's actual configuration matches its
|
1759
|
+
# expected template configuration.
|
1760
|
+
#
|
1761
|
+
# * `NOT_CHECKED`\: AWS CloudFormation does not currently return this
|
1762
|
+
# value.
|
1763
|
+
#
|
1764
|
+
# @option params [String] :next_token
|
1765
|
+
# A string that identifies the next page of stack resource drift
|
1766
|
+
# results.
|
1767
|
+
#
|
1768
|
+
# @option params [Integer] :max_results
|
1769
|
+
# The maximum number of results to be returned with a single call. If
|
1770
|
+
# the number of available results exceeds this maximum, the response
|
1771
|
+
# includes a `NextToken` value that you can assign to the `NextToken`
|
1772
|
+
# request parameter to get the next set of results.
|
1773
|
+
#
|
1774
|
+
# @return [Types::DescribeStackResourceDriftsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1775
|
+
#
|
1776
|
+
# * {Types::DescribeStackResourceDriftsOutput#stack_resource_drifts #stack_resource_drifts} => Array<Types::StackResourceDrift>
|
1777
|
+
# * {Types::DescribeStackResourceDriftsOutput#next_token #next_token} => String
|
1778
|
+
#
|
1779
|
+
# @example Request syntax with placeholder values
|
1780
|
+
#
|
1781
|
+
# resp = client.describe_stack_resource_drifts({
|
1782
|
+
# stack_name: "StackNameOrId", # required
|
1783
|
+
# stack_resource_drift_status_filters: ["IN_SYNC"], # accepts IN_SYNC, MODIFIED, DELETED, NOT_CHECKED
|
1784
|
+
# next_token: "NextToken",
|
1785
|
+
# max_results: 1,
|
1786
|
+
# })
|
1787
|
+
#
|
1788
|
+
# @example Response structure
|
1789
|
+
#
|
1790
|
+
# resp.stack_resource_drifts #=> Array
|
1791
|
+
# resp.stack_resource_drifts[0].stack_id #=> String
|
1792
|
+
# resp.stack_resource_drifts[0].logical_resource_id #=> String
|
1793
|
+
# resp.stack_resource_drifts[0].physical_resource_id #=> String
|
1794
|
+
# resp.stack_resource_drifts[0].physical_resource_id_context #=> Array
|
1795
|
+
# resp.stack_resource_drifts[0].physical_resource_id_context[0].key #=> String
|
1796
|
+
# resp.stack_resource_drifts[0].physical_resource_id_context[0].value #=> String
|
1797
|
+
# resp.stack_resource_drifts[0].resource_type #=> String
|
1798
|
+
# resp.stack_resource_drifts[0].expected_properties #=> String
|
1799
|
+
# resp.stack_resource_drifts[0].actual_properties #=> String
|
1800
|
+
# resp.stack_resource_drifts[0].property_differences #=> Array
|
1801
|
+
# resp.stack_resource_drifts[0].property_differences[0].property_path #=> String
|
1802
|
+
# resp.stack_resource_drifts[0].property_differences[0].expected_value #=> String
|
1803
|
+
# resp.stack_resource_drifts[0].property_differences[0].actual_value #=> String
|
1804
|
+
# resp.stack_resource_drifts[0].property_differences[0].difference_type #=> String, one of "ADD", "REMOVE", "NOT_EQUAL"
|
1805
|
+
# resp.stack_resource_drifts[0].stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
1806
|
+
# resp.stack_resource_drifts[0].timestamp #=> Time
|
1807
|
+
# resp.next_token #=> String
|
1808
|
+
#
|
1809
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackResourceDrifts AWS API Documentation
|
1810
|
+
#
|
1811
|
+
# @overload describe_stack_resource_drifts(params = {})
|
1812
|
+
# @param [Hash] params ({})
|
1813
|
+
def describe_stack_resource_drifts(params = {}, options = {})
|
1814
|
+
req = build_request(:describe_stack_resource_drifts, params)
|
1815
|
+
req.send_request(options)
|
1816
|
+
end
|
1817
|
+
|
1643
1818
|
# Returns AWS resource descriptions for running and deleted stacks. If
|
1644
1819
|
# `StackName` is specified, all the associated resources that are part
|
1645
1820
|
# of the stack are returned. If `PhysicalResourceId` is specified, the
|
@@ -1726,6 +1901,8 @@ module Aws::CloudFormation
|
|
1726
1901
|
# resp.stack_resources[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE"
|
1727
1902
|
# resp.stack_resources[0].resource_status_reason #=> String
|
1728
1903
|
# resp.stack_resources[0].description #=> String
|
1904
|
+
# resp.stack_resources[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
1905
|
+
# resp.stack_resources[0].drift_information.last_check_timestamp #=> Time
|
1729
1906
|
#
|
1730
1907
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStackResources AWS API Documentation
|
1731
1908
|
#
|
@@ -1902,6 +2079,8 @@ module Aws::CloudFormation
|
|
1902
2079
|
# resp.stacks[0].enable_termination_protection #=> Boolean
|
1903
2080
|
# resp.stacks[0].parent_id #=> String
|
1904
2081
|
# resp.stacks[0].root_id #=> String
|
2082
|
+
# resp.stacks[0].drift_information.stack_drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
|
2083
|
+
# resp.stacks[0].drift_information.last_check_timestamp #=> Time
|
1905
2084
|
# resp.next_token #=> String
|
1906
2085
|
#
|
1907
2086
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DescribeStacks AWS API Documentation
|
@@ -1913,6 +2092,140 @@ module Aws::CloudFormation
|
|
1913
2092
|
req.send_request(options)
|
1914
2093
|
end
|
1915
2094
|
|
2095
|
+
# Detects whether a stack's actual configuration differs, or has
|
2096
|
+
# *drifted*, from it's expected configuration, as defined in the stack
|
2097
|
+
# template and any values specified as template parameters. For each
|
2098
|
+
# resource in the stack that supports drift detection, AWS
|
2099
|
+
# CloudFormation compares the actual configuration of the resource with
|
2100
|
+
# its expected template configuration. Only resource properties
|
2101
|
+
# explicitly defined in the stack template are checked for drift. A
|
2102
|
+
# stack is considered to have drifted if one or more of its resources
|
2103
|
+
# differ from their expected template configurations. For more
|
2104
|
+
# information, see [Detecting Unregulated Configuration Changes to
|
2105
|
+
# Stacks and Resources][1].
|
2106
|
+
#
|
2107
|
+
# Use `DetectStackDrift` to detect drift on all supported resources for
|
2108
|
+
# a given stack, or DetectStackResourceDrift to detect drift on
|
2109
|
+
# individual resources.
|
2110
|
+
#
|
2111
|
+
# For a list of stack resources that currently support drift detection,
|
2112
|
+
# see [Resources that Support Drift Detection][2].
|
2113
|
+
#
|
2114
|
+
# `DetectStackDrift` can take up to several minutes, depending on the
|
2115
|
+
# number of resources contained within the stack. Use
|
2116
|
+
# DescribeStackDriftDetectionStatus to monitor the progress of a detect
|
2117
|
+
# stack drift operation. Once the drift detection operation has
|
2118
|
+
# completed, use DescribeStackResourceDrifts to return drift information
|
2119
|
+
# about the stack and its resources.
|
2120
|
+
#
|
2121
|
+
# When detecting drift on a stack, AWS CloudFormation does not detect
|
2122
|
+
# drift on any nested stacks belonging to that stack. Perform
|
2123
|
+
# `DetectStackDrift` directly on the nested stack itself.
|
2124
|
+
#
|
2125
|
+
#
|
2126
|
+
#
|
2127
|
+
# [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
|
2128
|
+
# [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html
|
2129
|
+
#
|
2130
|
+
# @option params [required, String] :stack_name
|
2131
|
+
# The name of the stack for which you want to detect drift.
|
2132
|
+
#
|
2133
|
+
# @option params [Array<String>] :logical_resource_ids
|
2134
|
+
# The logical names of any resources you want to use as filters.
|
2135
|
+
#
|
2136
|
+
# @return [Types::DetectStackDriftOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2137
|
+
#
|
2138
|
+
# * {Types::DetectStackDriftOutput#stack_drift_detection_id #stack_drift_detection_id} => String
|
2139
|
+
#
|
2140
|
+
# @example Request syntax with placeholder values
|
2141
|
+
#
|
2142
|
+
# resp = client.detect_stack_drift({
|
2143
|
+
# stack_name: "StackNameOrId", # required
|
2144
|
+
# logical_resource_ids: ["LogicalResourceId"],
|
2145
|
+
# })
|
2146
|
+
#
|
2147
|
+
# @example Response structure
|
2148
|
+
#
|
2149
|
+
# resp.stack_drift_detection_id #=> String
|
2150
|
+
#
|
2151
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DetectStackDrift AWS API Documentation
|
2152
|
+
#
|
2153
|
+
# @overload detect_stack_drift(params = {})
|
2154
|
+
# @param [Hash] params ({})
|
2155
|
+
def detect_stack_drift(params = {}, options = {})
|
2156
|
+
req = build_request(:detect_stack_drift, params)
|
2157
|
+
req.send_request(options)
|
2158
|
+
end
|
2159
|
+
|
2160
|
+
# Returns information about whether a resource's actual configuration
|
2161
|
+
# differs, or has *drifted*, from it's expected configuration, as
|
2162
|
+
# defined in the stack template and any values specified as template
|
2163
|
+
# parameters. This information includes actual and expected property
|
2164
|
+
# values for resources in which AWS CloudFormation detects drift. Only
|
2165
|
+
# resource properties explicitly defined in the stack template are
|
2166
|
+
# checked for drift. For more information about stack and resource
|
2167
|
+
# drift, see [Detecting Unregulated Configuration Changes to Stacks and
|
2168
|
+
# Resources][1].
|
2169
|
+
#
|
2170
|
+
# Use `DetectStackResourceDrift` to detect drift on individual
|
2171
|
+
# resources, or DetectStackDrift to detect drift on all resources in a
|
2172
|
+
# given stack that support drift detection.
|
2173
|
+
#
|
2174
|
+
# Resources that do not currently support drift detection cannot be
|
2175
|
+
# checked. For a list of resources that support drift detection, see
|
2176
|
+
# [Resources that Support Drift Detection][2].
|
2177
|
+
#
|
2178
|
+
#
|
2179
|
+
#
|
2180
|
+
# [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html
|
2181
|
+
# [2]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift-resource-list.html
|
2182
|
+
#
|
2183
|
+
# @option params [required, String] :stack_name
|
2184
|
+
# The name of the stack to which the resource belongs.
|
2185
|
+
#
|
2186
|
+
# @option params [required, String] :logical_resource_id
|
2187
|
+
# The logical name of the resource for which to return drift
|
2188
|
+
# information.
|
2189
|
+
#
|
2190
|
+
# @return [Types::DetectStackResourceDriftOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2191
|
+
#
|
2192
|
+
# * {Types::DetectStackResourceDriftOutput#stack_resource_drift #stack_resource_drift} => Types::StackResourceDrift
|
2193
|
+
#
|
2194
|
+
# @example Request syntax with placeholder values
|
2195
|
+
#
|
2196
|
+
# resp = client.detect_stack_resource_drift({
|
2197
|
+
# stack_name: "StackNameOrId", # required
|
2198
|
+
# logical_resource_id: "LogicalResourceId", # required
|
2199
|
+
# })
|
2200
|
+
#
|
2201
|
+
# @example Response structure
|
2202
|
+
#
|
2203
|
+
# resp.stack_resource_drift.stack_id #=> String
|
2204
|
+
# resp.stack_resource_drift.logical_resource_id #=> String
|
2205
|
+
# resp.stack_resource_drift.physical_resource_id #=> String
|
2206
|
+
# resp.stack_resource_drift.physical_resource_id_context #=> Array
|
2207
|
+
# resp.stack_resource_drift.physical_resource_id_context[0].key #=> String
|
2208
|
+
# resp.stack_resource_drift.physical_resource_id_context[0].value #=> String
|
2209
|
+
# resp.stack_resource_drift.resource_type #=> String
|
2210
|
+
# resp.stack_resource_drift.expected_properties #=> String
|
2211
|
+
# resp.stack_resource_drift.actual_properties #=> String
|
2212
|
+
# resp.stack_resource_drift.property_differences #=> Array
|
2213
|
+
# resp.stack_resource_drift.property_differences[0].property_path #=> String
|
2214
|
+
# resp.stack_resource_drift.property_differences[0].expected_value #=> String
|
2215
|
+
# resp.stack_resource_drift.property_differences[0].actual_value #=> String
|
2216
|
+
# resp.stack_resource_drift.property_differences[0].difference_type #=> String, one of "ADD", "REMOVE", "NOT_EQUAL"
|
2217
|
+
# resp.stack_resource_drift.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
2218
|
+
# resp.stack_resource_drift.timestamp #=> Time
|
2219
|
+
#
|
2220
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/DetectStackResourceDrift AWS API Documentation
|
2221
|
+
#
|
2222
|
+
# @overload detect_stack_resource_drift(params = {})
|
2223
|
+
# @param [Hash] params ({})
|
2224
|
+
def detect_stack_resource_drift(params = {}, options = {})
|
2225
|
+
req = build_request(:detect_stack_resource_drift, params)
|
2226
|
+
req.send_request(options)
|
2227
|
+
end
|
2228
|
+
|
1916
2229
|
# Returns the estimated monthly cost of a template. The return value is
|
1917
2230
|
# an AWS Simple Monthly Calculator URL with a query string that
|
1918
2231
|
# describes the resources required to run the template.
|
@@ -2466,6 +2779,8 @@ module Aws::CloudFormation
|
|
2466
2779
|
# resp.stack_resource_summaries[0].last_updated_timestamp #=> Time
|
2467
2780
|
# resp.stack_resource_summaries[0].resource_status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_FAILED", "CREATE_COMPLETE", "DELETE_IN_PROGRESS", "DELETE_FAILED", "DELETE_COMPLETE", "DELETE_SKIPPED", "UPDATE_IN_PROGRESS", "UPDATE_FAILED", "UPDATE_COMPLETE"
|
2468
2781
|
# resp.stack_resource_summaries[0].resource_status_reason #=> String
|
2782
|
+
# resp.stack_resource_summaries[0].drift_information.stack_resource_drift_status #=> String, one of "IN_SYNC", "MODIFIED", "DELETED", "NOT_CHECKED"
|
2783
|
+
# resp.stack_resource_summaries[0].drift_information.last_check_timestamp #=> Time
|
2469
2784
|
# resp.next_token #=> String
|
2470
2785
|
#
|
2471
2786
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackResources AWS API Documentation
|
@@ -2683,6 +2998,8 @@ module Aws::CloudFormation
|
|
2683
2998
|
# resp.stack_summaries[0].stack_status_reason #=> String
|
2684
2999
|
# resp.stack_summaries[0].parent_id #=> String
|
2685
3000
|
# resp.stack_summaries[0].root_id #=> String
|
3001
|
+
# resp.stack_summaries[0].drift_information.stack_drift_status #=> String, one of "DRIFTED", "IN_SYNC", "UNKNOWN", "NOT_CHECKED"
|
3002
|
+
# resp.stack_summaries[0].drift_information.last_check_timestamp #=> Time
|
2686
3003
|
# resp.next_token #=> String
|
2687
3004
|
#
|
2688
3005
|
# @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStacks AWS API Documentation
|
@@ -3496,16 +3813,14 @@ module Aws::CloudFormation
|
|
3496
3813
|
# Updates termination protection for the specified stack. If a user
|
3497
3814
|
# attempts to delete a stack with termination protection enabled, the
|
3498
3815
|
# operation fails and the stack remains unchanged. For more information,
|
3499
|
-
# see [Protecting a Stack From Being
|
3500
|
-
#
|
3501
|
-
#
|
3502
|
-
# For [nested stacks][2], termination protection is set on the root
|
3503
|
-
# stack and cannot be changed directly on the nested stack.
|
3504
|
-
#
|
3505
|
-
#
|
3816
|
+
# see [Protecting a Stack From Being
|
3817
|
+
# Deleted](AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html)
|
3818
|
+
# in the *AWS CloudFormation User Guide*.
|
3506
3819
|
#
|
3507
|
-
# [
|
3508
|
-
#
|
3820
|
+
# For [nested
|
3821
|
+
# stacks](AWSCloudFormation/latest/UserGuide/using-cfn-nested-stacks.html),
|
3822
|
+
# termination protection is set on the root stack and cannot be changed
|
3823
|
+
# directly on the nested stack.
|
3509
3824
|
#
|
3510
3825
|
# @option params [required, Boolean] :enable_termination_protection
|
3511
3826
|
# Whether to enable termination protection on the specified stack.
|
@@ -3619,7 +3934,7 @@ module Aws::CloudFormation
|
|
3619
3934
|
params: params,
|
3620
3935
|
config: config)
|
3621
3936
|
context[:gem_name] = 'aws-sdk-cloudformation'
|
3622
|
-
context[:gem_version] = '1.
|
3937
|
+
context[:gem_version] = '1.11.0'
|
3623
3938
|
Seahorse::Client::Request.new(handlers, context)
|
3624
3939
|
end
|
3625
3940
|
|