@Generated(value="software.amazon.awssdk:codegen") public interface CloudFormationClient extends SdkClient
builder()
method.
AWS CloudFormation allows you to create and manage AWS infrastructure deployments predictably and repeatedly. You can use AWS CloudFormation to leverage AWS products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly-reliable, highly scalable, cost-effective applications without creating or configuring the underlying AWS infrastructure.
With AWS CloudFormation, you declare all of your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. AWS CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.
For more information about AWS CloudFormation, see the AWS CloudFormation Product Page.
Amazon CloudFormation makes use of other AWS products. If you need additional technical information about a specific AWS product, you can find the product's technical documentation at docs.aws.amazon.com.
Modifier and Type | Field and Description |
---|---|
static String |
SERVICE_NAME |
Modifier and Type | Method and Description |
---|---|
static CloudFormationClientBuilder |
builder()
Create a builder that can be used to configure and create a
CloudFormationClient . |
default CancelUpdateStackResponse |
cancelUpdateStack(CancelUpdateStackRequest cancelUpdateStackRequest)
Cancels an update on the specified stack.
|
default CancelUpdateStackResponse |
cancelUpdateStack(Consumer<CancelUpdateStackRequest.Builder> cancelUpdateStackRequest)
Cancels an update on the specified stack.
|
default ContinueUpdateRollbackResponse |
continueUpdateRollback(Consumer<ContinueUpdateRollbackRequest.Builder> continueUpdateRollbackRequest)
For a specified stack that is in the
UPDATE_ROLLBACK_FAILED state, continues rolling it back to the
UPDATE_ROLLBACK_COMPLETE state. |
default ContinueUpdateRollbackResponse |
continueUpdateRollback(ContinueUpdateRollbackRequest continueUpdateRollbackRequest)
For a specified stack that is in the
UPDATE_ROLLBACK_FAILED state, continues rolling it back to the
UPDATE_ROLLBACK_COMPLETE state. |
static CloudFormationClient |
create()
Create a
CloudFormationClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider . |
default CreateChangeSetResponse |
createChangeSet(Consumer<CreateChangeSetRequest.Builder> createChangeSetRequest)
Creates a list of changes that will be applied to a stack so that you can review the changes before executing
them.
|
default CreateChangeSetResponse |
createChangeSet(CreateChangeSetRequest createChangeSetRequest)
Creates a list of changes that will be applied to a stack so that you can review the changes before executing
them.
|
default CreateStackResponse |
createStack(Consumer<CreateStackRequest.Builder> createStackRequest)
Creates a stack as specified in the template.
|
default CreateStackResponse |
createStack(CreateStackRequest createStackRequest)
Creates a stack as specified in the template.
|
default CreateStackInstancesResponse |
createStackInstances(Consumer<CreateStackInstancesRequest.Builder> createStackInstancesRequest)
Creates stack instances for the specified accounts, within the specified regions.
|
default CreateStackInstancesResponse |
createStackInstances(CreateStackInstancesRequest createStackInstancesRequest)
Creates stack instances for the specified accounts, within the specified regions.
|
default CreateStackSetResponse |
createStackSet(Consumer<CreateStackSetRequest.Builder> createStackSetRequest)
Creates a stack set.
|
default CreateStackSetResponse |
createStackSet(CreateStackSetRequest createStackSetRequest)
Creates a stack set.
|
default DeleteChangeSetResponse |
deleteChangeSet(Consumer<DeleteChangeSetRequest.Builder> deleteChangeSetRequest)
Deletes the specified change set.
|
default DeleteChangeSetResponse |
deleteChangeSet(DeleteChangeSetRequest deleteChangeSetRequest)
Deletes the specified change set.
|
default DeleteStackResponse |
deleteStack(Consumer<DeleteStackRequest.Builder> deleteStackRequest)
Deletes a specified stack.
|
default DeleteStackResponse |
deleteStack(DeleteStackRequest deleteStackRequest)
Deletes a specified stack.
|
default DeleteStackInstancesResponse |
deleteStackInstances(Consumer<DeleteStackInstancesRequest.Builder> deleteStackInstancesRequest)
Deletes stack instances for the specified accounts, in the specified regions.
|
default DeleteStackInstancesResponse |
deleteStackInstances(DeleteStackInstancesRequest deleteStackInstancesRequest)
Deletes stack instances for the specified accounts, in the specified regions.
|
default DeleteStackSetResponse |
deleteStackSet(Consumer<DeleteStackSetRequest.Builder> deleteStackSetRequest)
Deletes a stack set.
|
default DeleteStackSetResponse |
deleteStackSet(DeleteStackSetRequest deleteStackSetRequest)
Deletes a stack set.
|
default DescribeAccountLimitsResponse |
describeAccountLimits()
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in
your account.
|
default DescribeAccountLimitsResponse |
describeAccountLimits(Consumer<DescribeAccountLimitsRequest.Builder> describeAccountLimitsRequest)
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in
your account.
|
default DescribeAccountLimitsResponse |
describeAccountLimits(DescribeAccountLimitsRequest describeAccountLimitsRequest)
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in
your account.
|
default DescribeChangeSetResponse |
describeChangeSet(Consumer<DescribeChangeSetRequest.Builder> describeChangeSetRequest)
Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the
change set.
|
default DescribeChangeSetResponse |
describeChangeSet(DescribeChangeSetRequest describeChangeSetRequest)
Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the
change set.
|
default DescribeStackDriftDetectionStatusResponse |
describeStackDriftDetectionStatus(Consumer<DescribeStackDriftDetectionStatusRequest.Builder> describeStackDriftDetectionStatusRequest)
Returns information about a stack drift detection operation.
|
default DescribeStackDriftDetectionStatusResponse |
describeStackDriftDetectionStatus(DescribeStackDriftDetectionStatusRequest describeStackDriftDetectionStatusRequest)
Returns information about a stack drift detection operation.
|
default DescribeStackEventsResponse |
describeStackEvents(Consumer<DescribeStackEventsRequest.Builder> describeStackEventsRequest)
Returns all stack related events for a specified stack in reverse chronological order.
|
default DescribeStackEventsResponse |
describeStackEvents(DescribeStackEventsRequest describeStackEventsRequest)
Returns all stack related events for a specified stack in reverse chronological order.
|
default DescribeStackEventsIterable |
describeStackEventsPaginator(Consumer<DescribeStackEventsRequest.Builder> describeStackEventsRequest)
Returns all stack related events for a specified stack in reverse chronological order.
|
default DescribeStackEventsIterable |
describeStackEventsPaginator(DescribeStackEventsRequest describeStackEventsRequest)
Returns all stack related events for a specified stack in reverse chronological order.
|
default DescribeStackInstanceResponse |
describeStackInstance(Consumer<DescribeStackInstanceRequest.Builder> describeStackInstanceRequest)
Returns the stack instance that's associated with the specified stack set, AWS account, and region.
|
default DescribeStackInstanceResponse |
describeStackInstance(DescribeStackInstanceRequest describeStackInstanceRequest)
Returns the stack instance that's associated with the specified stack set, AWS account, and region.
|
default DescribeStackResourceResponse |
describeStackResource(Consumer<DescribeStackResourceRequest.Builder> describeStackResourceRequest)
Returns a description of the specified resource in the specified stack.
|
default DescribeStackResourceResponse |
describeStackResource(DescribeStackResourceRequest describeStackResourceRequest)
Returns a description of the specified resource in the specified stack.
|
default DescribeStackResourceDriftsResponse |
describeStackResourceDrifts(Consumer<DescribeStackResourceDriftsRequest.Builder> describeStackResourceDriftsRequest)
Returns drift information for the resources that have been checked for drift in the specified stack.
|
default DescribeStackResourceDriftsResponse |
describeStackResourceDrifts(DescribeStackResourceDriftsRequest describeStackResourceDriftsRequest)
Returns drift information for the resources that have been checked for drift in the specified stack.
|
default DescribeStackResourceDriftsIterable |
describeStackResourceDriftsPaginator(Consumer<DescribeStackResourceDriftsRequest.Builder> describeStackResourceDriftsRequest)
Returns drift information for the resources that have been checked for drift in the specified stack.
|
default DescribeStackResourceDriftsIterable |
describeStackResourceDriftsPaginator(DescribeStackResourceDriftsRequest describeStackResourceDriftsRequest)
Returns drift information for the resources that have been checked for drift in the specified stack.
|
default DescribeStackResourcesResponse |
describeStackResources(Consumer<DescribeStackResourcesRequest.Builder> describeStackResourcesRequest)
Returns AWS resource descriptions for running and deleted stacks.
|
default DescribeStackResourcesResponse |
describeStackResources(DescribeStackResourcesRequest describeStackResourcesRequest)
Returns AWS resource descriptions for running and deleted stacks.
|
default DescribeStacksResponse |
describeStacks()
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DescribeStacksResponse |
describeStacks(Consumer<DescribeStacksRequest.Builder> describeStacksRequest)
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DescribeStacksResponse |
describeStacks(DescribeStacksRequest describeStacksRequest)
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DescribeStackSetResponse |
describeStackSet(Consumer<DescribeStackSetRequest.Builder> describeStackSetRequest)
Returns the description of the specified stack set.
|
default DescribeStackSetResponse |
describeStackSet(DescribeStackSetRequest describeStackSetRequest)
Returns the description of the specified stack set.
|
default DescribeStackSetOperationResponse |
describeStackSetOperation(Consumer<DescribeStackSetOperationRequest.Builder> describeStackSetOperationRequest)
Returns the description of the specified stack set operation.
|
default DescribeStackSetOperationResponse |
describeStackSetOperation(DescribeStackSetOperationRequest describeStackSetOperationRequest)
Returns the description of the specified stack set operation.
|
default DescribeStacksIterable |
describeStacksPaginator()
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DescribeStacksIterable |
describeStacksPaginator(Consumer<DescribeStacksRequest.Builder> describeStacksRequest)
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DescribeStacksIterable |
describeStacksPaginator(DescribeStacksRequest describeStacksRequest)
Returns the description for the specified stack; if no stack name was specified, then it returns the description
for all the stacks created.
|
default DetectStackDriftResponse |
detectStackDrift(Consumer<DetectStackDriftRequest.Builder> detectStackDriftRequest)
Detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration,
as defined in the stack template and any values specified as template parameters.
|
default DetectStackDriftResponse |
detectStackDrift(DetectStackDriftRequest detectStackDriftRequest)
Detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration,
as defined in the stack template and any values specified as template parameters.
|
default DetectStackResourceDriftResponse |
detectStackResourceDrift(Consumer<DetectStackResourceDriftRequest.Builder> detectStackResourceDriftRequest)
Returns information about whether a resource's actual configuration differs, or has drifted, from it's
expected configuration, as defined in the stack template and any values specified as template parameters.
|
default DetectStackResourceDriftResponse |
detectStackResourceDrift(DetectStackResourceDriftRequest detectStackResourceDriftRequest)
Returns information about whether a resource's actual configuration differs, or has drifted, from it's
expected configuration, as defined in the stack template and any values specified as template parameters.
|
default EstimateTemplateCostResponse |
estimateTemplateCost(Consumer<EstimateTemplateCostRequest.Builder> estimateTemplateCostRequest)
Returns the estimated monthly cost of a template.
|
default EstimateTemplateCostResponse |
estimateTemplateCost(EstimateTemplateCostRequest estimateTemplateCostRequest)
Returns the estimated monthly cost of a template.
|
default ExecuteChangeSetResponse |
executeChangeSet(Consumer<ExecuteChangeSetRequest.Builder> executeChangeSetRequest)
Updates a stack using the input information that was provided when the specified change set was created.
|
default ExecuteChangeSetResponse |
executeChangeSet(ExecuteChangeSetRequest executeChangeSetRequest)
Updates a stack using the input information that was provided when the specified change set was created.
|
default GetStackPolicyResponse |
getStackPolicy(Consumer<GetStackPolicyRequest.Builder> getStackPolicyRequest)
Returns the stack policy for a specified stack.
|
default GetStackPolicyResponse |
getStackPolicy(GetStackPolicyRequest getStackPolicyRequest)
Returns the stack policy for a specified stack.
|
default GetTemplateResponse |
getTemplate(Consumer<GetTemplateRequest.Builder> getTemplateRequest)
Returns the template body for a specified stack.
|
default GetTemplateResponse |
getTemplate(GetTemplateRequest getTemplateRequest)
Returns the template body for a specified stack.
|
default GetTemplateSummaryResponse |
getTemplateSummary(Consumer<GetTemplateSummaryRequest.Builder> getTemplateSummaryRequest)
Returns information about a new or existing template.
|
default GetTemplateSummaryResponse |
getTemplateSummary(GetTemplateSummaryRequest getTemplateSummaryRequest)
Returns information about a new or existing template.
|
default ListChangeSetsResponse |
listChangeSets(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest)
Returns the ID and status of each active change set for a stack.
|
default ListChangeSetsResponse |
listChangeSets(ListChangeSetsRequest listChangeSetsRequest)
Returns the ID and status of each active change set for a stack.
|
default ListExportsResponse |
listExports()
Lists all exported output values in the account and region in which you call this action.
|
default ListExportsResponse |
listExports(Consumer<ListExportsRequest.Builder> listExportsRequest)
Lists all exported output values in the account and region in which you call this action.
|
default ListExportsResponse |
listExports(ListExportsRequest listExportsRequest)
Lists all exported output values in the account and region in which you call this action.
|
default ListExportsIterable |
listExportsPaginator()
Lists all exported output values in the account and region in which you call this action.
|
default ListExportsIterable |
listExportsPaginator(Consumer<ListExportsRequest.Builder> listExportsRequest)
Lists all exported output values in the account and region in which you call this action.
|
default ListExportsIterable |
listExportsPaginator(ListExportsRequest listExportsRequest)
Lists all exported output values in the account and region in which you call this action.
|
default ListImportsResponse |
listImports(Consumer<ListImportsRequest.Builder> listImportsRequest)
Lists all stacks that are importing an exported output value.
|
default ListImportsResponse |
listImports(ListImportsRequest listImportsRequest)
Lists all stacks that are importing an exported output value.
|
default ListImportsIterable |
listImportsPaginator(Consumer<ListImportsRequest.Builder> listImportsRequest)
Lists all stacks that are importing an exported output value.
|
default ListImportsIterable |
listImportsPaginator(ListImportsRequest listImportsRequest)
Lists all stacks that are importing an exported output value.
|
default ListStackInstancesResponse |
listStackInstances(Consumer<ListStackInstancesRequest.Builder> listStackInstancesRequest)
Returns summary information about stack instances that are associated with the specified stack set.
|
default ListStackInstancesResponse |
listStackInstances(ListStackInstancesRequest listStackInstancesRequest)
Returns summary information about stack instances that are associated with the specified stack set.
|
default ListStackResourcesResponse |
listStackResources(Consumer<ListStackResourcesRequest.Builder> listStackResourcesRequest)
Returns descriptions of all resources of the specified stack.
|
default ListStackResourcesResponse |
listStackResources(ListStackResourcesRequest listStackResourcesRequest)
Returns descriptions of all resources of the specified stack.
|
default ListStackResourcesIterable |
listStackResourcesPaginator(Consumer<ListStackResourcesRequest.Builder> listStackResourcesRequest)
Returns descriptions of all resources of the specified stack.
|
default ListStackResourcesIterable |
listStackResourcesPaginator(ListStackResourcesRequest listStackResourcesRequest)
Returns descriptions of all resources of the specified stack.
|
default ListStacksResponse |
listStacks()
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
default ListStacksResponse |
listStacks(Consumer<ListStacksRequest.Builder> listStacksRequest)
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
default ListStacksResponse |
listStacks(ListStacksRequest listStacksRequest)
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
default ListStackSetOperationResultsResponse |
listStackSetOperationResults(Consumer<ListStackSetOperationResultsRequest.Builder> listStackSetOperationResultsRequest)
Returns summary information about the results of a stack set operation.
|
default ListStackSetOperationResultsResponse |
listStackSetOperationResults(ListStackSetOperationResultsRequest listStackSetOperationResultsRequest)
Returns summary information about the results of a stack set operation.
|
default ListStackSetOperationsResponse |
listStackSetOperations(Consumer<ListStackSetOperationsRequest.Builder> listStackSetOperationsRequest)
Returns summary information about operations performed on a stack set.
|
default ListStackSetOperationsResponse |
listStackSetOperations(ListStackSetOperationsRequest listStackSetOperationsRequest)
Returns summary information about operations performed on a stack set.
|
default ListStackSetsResponse |
listStackSets()
Returns summary information about stack sets that are associated with the user.
|
default ListStackSetsResponse |
listStackSets(Consumer<ListStackSetsRequest.Builder> listStackSetsRequest)
Returns summary information about stack sets that are associated with the user.
|
default ListStackSetsResponse |
listStackSets(ListStackSetsRequest listStackSetsRequest)
Returns summary information about stack sets that are associated with the user.
|
default ListStacksIterable |
listStacksPaginator()
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
default ListStacksIterable |
listStacksPaginator(Consumer<ListStacksRequest.Builder> listStacksRequest)
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
default ListStacksIterable |
listStacksPaginator(ListStacksRequest listStacksRequest)
Returns the summary information for stacks whose status matches the specified StackStatusFilter.
|
static ServiceMetadata |
serviceMetadata() |
default SetStackPolicyResponse |
setStackPolicy(Consumer<SetStackPolicyRequest.Builder> setStackPolicyRequest)
Sets a stack policy for a specified stack.
|
default SetStackPolicyResponse |
setStackPolicy(SetStackPolicyRequest setStackPolicyRequest)
Sets a stack policy for a specified stack.
|
default SignalResourceResponse |
signalResource(Consumer<SignalResourceRequest.Builder> signalResourceRequest)
Sends a signal to the specified resource with a success or failure status.
|
default SignalResourceResponse |
signalResource(SignalResourceRequest signalResourceRequest)
Sends a signal to the specified resource with a success or failure status.
|
default StopStackSetOperationResponse |
stopStackSetOperation(Consumer<StopStackSetOperationRequest.Builder> stopStackSetOperationRequest)
Stops an in-progress operation on a stack set and its associated stack instances.
|
default StopStackSetOperationResponse |
stopStackSetOperation(StopStackSetOperationRequest stopStackSetOperationRequest)
Stops an in-progress operation on a stack set and its associated stack instances.
|
default UpdateStackResponse |
updateStack(Consumer<UpdateStackRequest.Builder> updateStackRequest)
Updates a stack as specified in the template.
|
default UpdateStackResponse |
updateStack(UpdateStackRequest updateStackRequest)
Updates a stack as specified in the template.
|
default UpdateStackInstancesResponse |
updateStackInstances(Consumer<UpdateStackInstancesRequest.Builder> updateStackInstancesRequest)
Updates the parameter values for stack instances for the specified accounts, within the specified regions.
|
default UpdateStackInstancesResponse |
updateStackInstances(UpdateStackInstancesRequest updateStackInstancesRequest)
Updates the parameter values for stack instances for the specified accounts, within the specified regions.
|
default UpdateStackSetResponse |
updateStackSet(Consumer<UpdateStackSetRequest.Builder> updateStackSetRequest)
Updates the stack set, and associated stack instances in the specified accounts and regions.
|
default UpdateStackSetResponse |
updateStackSet(UpdateStackSetRequest updateStackSetRequest)
Updates the stack set, and associated stack instances in the specified accounts and regions.
|
default UpdateTerminationProtectionResponse |
updateTerminationProtection(Consumer<UpdateTerminationProtectionRequest.Builder> updateTerminationProtectionRequest)
Updates termination protection for the specified stack.
|
default UpdateTerminationProtectionResponse |
updateTerminationProtection(UpdateTerminationProtectionRequest updateTerminationProtectionRequest)
Updates termination protection for the specified stack.
|
default ValidateTemplateResponse |
validateTemplate(Consumer<ValidateTemplateRequest.Builder> validateTemplateRequest)
Validates a specified template.
|
default ValidateTemplateResponse |
validateTemplate(ValidateTemplateRequest validateTemplateRequest)
Validates a specified template.
|
serviceName
close
static final String SERVICE_NAME
static CloudFormationClient create()
CloudFormationClient
with the region loaded from the
DefaultAwsRegionProviderChain
and credentials loaded from the
DefaultCredentialsProvider
.static CloudFormationClientBuilder builder()
CloudFormationClient
.default CancelUpdateStackResponse cancelUpdateStack(CancelUpdateStackRequest cancelUpdateStackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration.
You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.
cancelUpdateStackRequest
- The input for the CancelUpdateStack action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CancelUpdateStackResponse cancelUpdateStack(Consumer<CancelUpdateStackRequest.Builder> cancelUpdateStackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Cancels an update on the specified stack. If the call completes successfully, the stack rolls back the update and reverts to the previous stack configuration.
You can cancel only stacks that are in the UPDATE_IN_PROGRESS state.
This is a convenience which creates an instance of the CancelUpdateStackRequest.Builder
avoiding the need
to create one manually via CancelUpdateStackRequest.builder()
cancelUpdateStackRequest
- A Consumer
that will call methods on CancelUpdateStackInput.Builder
to create a request.
The input for the CancelUpdateStack action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ContinueUpdateRollbackResponse continueUpdateRollback(ContinueUpdateRollbackRequest continueUpdateRollbackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
For a specified stack that is in the UPDATE_ROLLBACK_FAILED
state, continues rolling it back to the
UPDATE_ROLLBACK_COMPLETE
state. Depending on the cause of the failure, you can manually fix the error and continue the rollback. By continuing the rollback, you can return your stack to a working
state (the UPDATE_ROLLBACK_COMPLETE
state), and then try to update the stack again.
A stack goes into the UPDATE_ROLLBACK_FAILED
state when AWS CloudFormation cannot roll back all
changes after a failed stack update. For example, you might have a stack that is rolling back to an old database
instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was
deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update
rollback to fail.
continueUpdateRollbackRequest
- The input for the ContinueUpdateRollback action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ContinueUpdateRollbackResponse continueUpdateRollback(Consumer<ContinueUpdateRollbackRequest.Builder> continueUpdateRollbackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
For a specified stack that is in the UPDATE_ROLLBACK_FAILED
state, continues rolling it back to the
UPDATE_ROLLBACK_COMPLETE
state. Depending on the cause of the failure, you can manually fix the error and continue the rollback. By continuing the rollback, you can return your stack to a working
state (the UPDATE_ROLLBACK_COMPLETE
state), and then try to update the stack again.
A stack goes into the UPDATE_ROLLBACK_FAILED
state when AWS CloudFormation cannot roll back all
changes after a failed stack update. For example, you might have a stack that is rolling back to an old database
instance that was deleted outside of AWS CloudFormation. Because AWS CloudFormation doesn't know the database was
deleted, it assumes that the database instance still exists and attempts to roll back to it, causing the update
rollback to fail.
This is a convenience which creates an instance of the ContinueUpdateRollbackRequest.Builder
avoiding the
need to create one manually via ContinueUpdateRollbackRequest.builder()
continueUpdateRollbackRequest
- A Consumer
that will call methods on ContinueUpdateRollbackInput.Builder
to create a
request. The input for the ContinueUpdateRollback action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateChangeSetResponse createChangeSet(CreateChangeSetRequest createChangeSetRequest) throws AlreadyExistsException, InsufficientCapabilitiesException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates a list of changes that will be applied to a stack so that you can review the changes before executing them. You can create a change set for a stack that doesn't exist or an existing stack. If you create a change set for a stack that doesn't exist, the change set shows all of the resources that AWS CloudFormation will create. If you create a change set for an existing stack, AWS CloudFormation compares the stack's information with the information that you submit in the change set and lists the differences. Use change sets to understand which resources AWS CloudFormation will create or change, and how it will change resources in an existing stack, before you create or update a stack.
To create a change set for a stack that doesn't exist, for the ChangeSetType
parameter, specify
CREATE
. To create a change set for an existing stack, specify UPDATE
for the
ChangeSetType
parameter. After the CreateChangeSet
call successfully completes, AWS
CloudFormation starts creating the change set. To check the status of the change set or to review it, use the
DescribeChangeSet action.
When you are satisfied with the changes the change set will make, execute the change set by using the ExecuteChangeSet action. AWS CloudFormation doesn't make changes until you execute the change set.
createChangeSetRequest
- The input for the CreateChangeSet action.AlreadyExistsException
- The resource with the name requested already exists.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateChangeSetResponse createChangeSet(Consumer<CreateChangeSetRequest.Builder> createChangeSetRequest) throws AlreadyExistsException, InsufficientCapabilitiesException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates a list of changes that will be applied to a stack so that you can review the changes before executing them. You can create a change set for a stack that doesn't exist or an existing stack. If you create a change set for a stack that doesn't exist, the change set shows all of the resources that AWS CloudFormation will create. If you create a change set for an existing stack, AWS CloudFormation compares the stack's information with the information that you submit in the change set and lists the differences. Use change sets to understand which resources AWS CloudFormation will create or change, and how it will change resources in an existing stack, before you create or update a stack.
To create a change set for a stack that doesn't exist, for the ChangeSetType
parameter, specify
CREATE
. To create a change set for an existing stack, specify UPDATE
for the
ChangeSetType
parameter. After the CreateChangeSet
call successfully completes, AWS
CloudFormation starts creating the change set. To check the status of the change set or to review it, use the
DescribeChangeSet action.
When you are satisfied with the changes the change set will make, execute the change set by using the ExecuteChangeSet action. AWS CloudFormation doesn't make changes until you execute the change set.
This is a convenience which creates an instance of the CreateChangeSetRequest.Builder
avoiding the need
to create one manually via CreateChangeSetRequest.builder()
createChangeSetRequest
- A Consumer
that will call methods on CreateChangeSetInput.Builder
to create a request. The
input for the CreateChangeSet action.AlreadyExistsException
- The resource with the name requested already exists.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackResponse createStack(CreateStackRequest createStackRequest) throws LimitExceededException, AlreadyExistsException, TokenAlreadyExistsException, InsufficientCapabilitiesException, AwsServiceException, SdkClientException, CloudFormationException
Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the DescribeStacks API.
createStackRequest
- The input for CreateStack action.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
AlreadyExistsException
- The resource with the name requested already exists.TokenAlreadyExistsException
- A client request token already exists.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackResponse createStack(Consumer<CreateStackRequest.Builder> createStackRequest) throws LimitExceededException, AlreadyExistsException, TokenAlreadyExistsException, InsufficientCapabilitiesException, AwsServiceException, SdkClientException, CloudFormationException
Creates a stack as specified in the template. After the call completes successfully, the stack creation starts. You can check the status of the stack via the DescribeStacks API.
This is a convenience which creates an instance of the CreateStackRequest.Builder
avoiding the need to
create one manually via CreateStackRequest.builder()
createStackRequest
- A Consumer
that will call methods on CreateStackInput.Builder
to create a request. The
input for CreateStack action.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
AlreadyExistsException
- The resource with the name requested already exists.TokenAlreadyExistsException
- A client request token already exists.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackInstancesResponse createStackInstances(CreateStackInstancesRequest createStackInstancesRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates stack instances for the specified accounts, within the specified regions. A stack instance refers to a
stack in a specific account and region. Accounts
and Regions
are required
parameters—you must specify at least one account and one region.
createStackInstancesRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackInstancesResponse createStackInstances(Consumer<CreateStackInstancesRequest.Builder> createStackInstancesRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates stack instances for the specified accounts, within the specified regions. A stack instance refers to a
stack in a specific account and region. Accounts
and Regions
are required
parameters—you must specify at least one account and one region.
This is a convenience which creates an instance of the CreateStackInstancesRequest.Builder
avoiding the
need to create one manually via CreateStackInstancesRequest.builder()
createStackInstancesRequest
- A Consumer
that will call methods on CreateStackInstancesInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackSetResponse createStackSet(CreateStackSetRequest createStackSetRequest) throws NameAlreadyExistsException, CreatedButModifiedException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates a stack set.
createStackSetRequest
- NameAlreadyExistsException
- The specified name is already in use.CreatedButModifiedException
- The specified resource exists, but has been changed.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default CreateStackSetResponse createStackSet(Consumer<CreateStackSetRequest.Builder> createStackSetRequest) throws NameAlreadyExistsException, CreatedButModifiedException, LimitExceededException, AwsServiceException, SdkClientException, CloudFormationException
Creates a stack set.
This is a convenience which creates an instance of the CreateStackSetRequest.Builder
avoiding the need to
create one manually via CreateStackSetRequest.builder()
createStackSetRequest
- A Consumer
that will call methods on CreateStackSetInput.Builder
to create a request.NameAlreadyExistsException
- The specified name is already in use.CreatedButModifiedException
- The specified resource exists, but has been changed.LimitExceededException
- The quota for the resource has already been reached.
For information on stack set limitations, see Limitations of StackSets.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteChangeSetResponse deleteChangeSet(DeleteChangeSetRequest deleteChangeSetRequest) throws InvalidChangeSetStatusException, AwsServiceException, SdkClientException, CloudFormationException
Deletes the specified change set. Deleting change sets ensures that no one executes the wrong change set.
If the call successfully completes, AWS CloudFormation successfully deleted the change set.
deleteChangeSetRequest
- The input for the DeleteChangeSet action.InvalidChangeSetStatusException
- The specified change set can't be used to update the stack. For example, the change set status might be
CREATE_IN_PROGRESS
, or the stack status might be UPDATE_IN_PROGRESS
.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteChangeSetResponse deleteChangeSet(Consumer<DeleteChangeSetRequest.Builder> deleteChangeSetRequest) throws InvalidChangeSetStatusException, AwsServiceException, SdkClientException, CloudFormationException
Deletes the specified change set. Deleting change sets ensures that no one executes the wrong change set.
If the call successfully completes, AWS CloudFormation successfully deleted the change set.
This is a convenience which creates an instance of the DeleteChangeSetRequest.Builder
avoiding the need
to create one manually via DeleteChangeSetRequest.builder()
deleteChangeSetRequest
- A Consumer
that will call methods on DeleteChangeSetInput.Builder
to create a request. The
input for the DeleteChangeSet action.InvalidChangeSetStatusException
- The specified change set can't be used to update the stack. For example, the change set status might be
CREATE_IN_PROGRESS
, or the stack status might be UPDATE_IN_PROGRESS
.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackResponse deleteStack(DeleteStackRequest deleteStackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the DescribeStacks API if the deletion has been completed successfully.
deleteStackRequest
- The input for DeleteStack action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackResponse deleteStack(Consumer<DeleteStackRequest.Builder> deleteStackRequest) throws TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Deletes a specified stack. Once the call completes successfully, stack deletion starts. Deleted stacks do not show up in the DescribeStacks API if the deletion has been completed successfully.
This is a convenience which creates an instance of the DeleteStackRequest.Builder
avoiding the need to
create one manually via DeleteStackRequest.builder()
deleteStackRequest
- A Consumer
that will call methods on DeleteStackInput.Builder
to create a request. The
input for DeleteStack action.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackInstancesResponse deleteStackInstances(DeleteStackInstancesRequest deleteStackInstancesRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Deletes stack instances for the specified accounts, in the specified regions.
deleteStackInstancesRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackInstancesResponse deleteStackInstances(Consumer<DeleteStackInstancesRequest.Builder> deleteStackInstancesRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Deletes stack instances for the specified accounts, in the specified regions.
This is a convenience which creates an instance of the DeleteStackInstancesRequest.Builder
avoiding the
need to create one manually via DeleteStackInstancesRequest.builder()
deleteStackInstancesRequest
- A Consumer
that will call methods on DeleteStackInstancesInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackSetResponse deleteStackSet(DeleteStackSetRequest deleteStackSetRequest) throws StackSetNotEmptyException, OperationInProgressException, AwsServiceException, SdkClientException, CloudFormationException
Deletes a stack set. Before you can delete a stack set, all of its member stack instances must be deleted. For more information about how to do this, see DeleteStackInstances.
deleteStackSetRequest
- StackSetNotEmptyException
- You can't yet delete this stack set, because it still contains one or more stack instances. Delete all
stack instances from the stack set before deleting the stack set.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DeleteStackSetResponse deleteStackSet(Consumer<DeleteStackSetRequest.Builder> deleteStackSetRequest) throws StackSetNotEmptyException, OperationInProgressException, AwsServiceException, SdkClientException, CloudFormationException
Deletes a stack set. Before you can delete a stack set, all of its member stack instances must be deleted. For more information about how to do this, see DeleteStackInstances.
This is a convenience which creates an instance of the DeleteStackSetRequest.Builder
avoiding the need to
create one manually via DeleteStackSetRequest.builder()
deleteStackSetRequest
- A Consumer
that will call methods on DeleteStackSetInput.Builder
to create a request.StackSetNotEmptyException
- You can't yet delete this stack set, because it still contains one or more stack instances. Delete all
stack instances from the stack set before deleting the stack set.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeAccountLimitsResponse describeAccountLimits() throws AwsServiceException, SdkClientException, CloudFormationException
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
describeAccountLimits(DescribeAccountLimitsRequest)
,
AWS API Documentationdefault DescribeAccountLimitsResponse describeAccountLimits(DescribeAccountLimitsRequest describeAccountLimitsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.
describeAccountLimitsRequest
- The input for the DescribeAccountLimits action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeAccountLimitsResponse describeAccountLimits(Consumer<DescribeAccountLimitsRequest.Builder> describeAccountLimitsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Retrieves your account's AWS CloudFormation limits, such as the maximum number of stacks that you can create in your account.
This is a convenience which creates an instance of the DescribeAccountLimitsRequest.Builder
avoiding the
need to create one manually via DescribeAccountLimitsRequest.builder()
describeAccountLimitsRequest
- A Consumer
that will call methods on DescribeAccountLimitsInput.Builder
to create a
request. The input for the DescribeAccountLimits action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeChangeSetResponse describeChangeSet(DescribeChangeSetRequest describeChangeSetRequest) throws ChangeSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the change set. For more information, see Updating Stacks Using Change Sets in the AWS CloudFormation User Guide.
describeChangeSetRequest
- The input for the DescribeChangeSet action.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeChangeSetResponse describeChangeSet(Consumer<DescribeChangeSetRequest.Builder> describeChangeSetRequest) throws ChangeSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the inputs for the change set and a list of changes that AWS CloudFormation will make if you execute the change set. For more information, see Updating Stacks Using Change Sets in the AWS CloudFormation User Guide.
This is a convenience which creates an instance of the DescribeChangeSetRequest.Builder
avoiding the need
to create one manually via DescribeChangeSetRequest.builder()
describeChangeSetRequest
- A Consumer
that will call methods on DescribeChangeSetInput.Builder
to create a request.
The input for the DescribeChangeSet action.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackDriftDetectionStatusResponse describeStackDriftDetectionStatus(DescribeStackDriftDetectionStatusRequest describeStackDriftDetectionStatusRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns information about a stack drift detection operation. A stack drift detection operation detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. A stack is considered to have drifted if one or more of its resources have drifted. For more information on stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackDrift to initiate a stack drift detection operation. DetectStackDrift
returns
a StackDriftDetectionId
you can use to monitor the progress of the operation using
DescribeStackDriftDetectionStatus
. Once the drift detection operation has completed, use
DescribeStackResourceDrifts to return drift information about the stack and its resources.
describeStackDriftDetectionStatusRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackDriftDetectionStatusResponse describeStackDriftDetectionStatus(Consumer<DescribeStackDriftDetectionStatusRequest.Builder> describeStackDriftDetectionStatusRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns information about a stack drift detection operation. A stack drift detection operation detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. A stack is considered to have drifted if one or more of its resources have drifted. For more information on stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackDrift to initiate a stack drift detection operation. DetectStackDrift
returns
a StackDriftDetectionId
you can use to monitor the progress of the operation using
DescribeStackDriftDetectionStatus
. Once the drift detection operation has completed, use
DescribeStackResourceDrifts to return drift information about the stack and its resources.
This is a convenience which creates an instance of the DescribeStackDriftDetectionStatusRequest.Builder
avoiding the need to create one manually via DescribeStackDriftDetectionStatusRequest.builder()
describeStackDriftDetectionStatusRequest
- A Consumer
that will call methods on DescribeStackDriftDetectionStatusInput.Builder
to
create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackEventsResponse describeStackEvents(DescribeStackEventsRequest describeStackEventsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.
You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).
describeStackEventsRequest
- The input for DescribeStackEvents action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackEventsResponse describeStackEvents(Consumer<DescribeStackEventsRequest.Builder> describeStackEventsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.
You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).
This is a convenience which creates an instance of the DescribeStackEventsRequest.Builder
avoiding the
need to create one manually via DescribeStackEventsRequest.builder()
describeStackEventsRequest
- A Consumer
that will call methods on DescribeStackEventsInput.Builder
to create a request.
The input for DescribeStackEvents action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackEventsIterable describeStackEventsPaginator(DescribeStackEventsRequest describeStackEventsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.
You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).
This is a variant of
describeStackEvents(software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client.describeStackEventsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client .describeStackEventsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client.describeStackEventsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStackEvents(software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsRequest)
operation.
describeStackEventsRequest
- The input for DescribeStackEvents action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackEventsIterable describeStackEventsPaginator(Consumer<DescribeStackEventsRequest.Builder> describeStackEventsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns all stack related events for a specified stack in reverse chronological order. For more information about a stack's event history, go to Stacks in the AWS CloudFormation User Guide.
You can list events for stacks that have failed to create or have been deleted by specifying the unique stack identifier (stack ID).
This is a variant of
describeStackEvents(software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client.describeStackEventsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client .describeStackEventsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackEventsIterable responses = client.describeStackEventsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStackEvents(software.amazon.awssdk.services.cloudformation.model.DescribeStackEventsRequest)
operation.
This is a convenience which creates an instance of the DescribeStackEventsRequest.Builder
avoiding the
need to create one manually via DescribeStackEventsRequest.builder()
describeStackEventsRequest
- A Consumer
that will call methods on DescribeStackEventsInput.Builder
to create a request.
The input for DescribeStackEvents action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackInstanceResponse describeStackInstance(DescribeStackInstanceRequest describeStackInstanceRequest) throws StackSetNotFoundException, StackInstanceNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the stack instance that's associated with the specified stack set, AWS account, and region.
For a list of stack instances that are associated with a specific stack set, use ListStackInstances.
describeStackInstanceRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.StackInstanceNotFoundException
- The specified stack instance doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackInstanceResponse describeStackInstance(Consumer<DescribeStackInstanceRequest.Builder> describeStackInstanceRequest) throws StackSetNotFoundException, StackInstanceNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the stack instance that's associated with the specified stack set, AWS account, and region.
For a list of stack instances that are associated with a specific stack set, use ListStackInstances.
This is a convenience which creates an instance of the DescribeStackInstanceRequest.Builder
avoiding the
need to create one manually via DescribeStackInstanceRequest.builder()
describeStackInstanceRequest
- A Consumer
that will call methods on DescribeStackInstanceInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.StackInstanceNotFoundException
- The specified stack instance doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceResponse describeStackResource(DescribeStackResourceRequest describeStackResourceRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns a description of the specified resource in the specified stack.
For deleted stacks, DescribeStackResource returns resource information for up to 90 days after the stack has been deleted.
describeStackResourceRequest
- The input for DescribeStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceResponse describeStackResource(Consumer<DescribeStackResourceRequest.Builder> describeStackResourceRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns a description of the specified resource in the specified stack.
For deleted stacks, DescribeStackResource returns resource information for up to 90 days after the stack has been deleted.
This is a convenience which creates an instance of the DescribeStackResourceRequest.Builder
avoiding the
need to create one manually via DescribeStackResourceRequest.builder()
describeStackResourceRequest
- A Consumer
that will call methods on DescribeStackResourceInput.Builder
to create a
request. The input for DescribeStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceDriftsResponse describeStackResourceDrifts(DescribeStackResourceDriftsRequest describeStackResourceDriftsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where AWS CloudFormation detects configuration drift.
For a given stack, there will be one StackResourceDrift
for each stack resource that has been
checked for drift. Resources that have not yet been checked for drift are not included. Resources that do not
currently support drift detection are not checked, and so not included. For a list of resources that support
drift detection, see Resources that Support Drift Detection.
Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all supported resources for a given stack.
describeStackResourceDriftsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceDriftsResponse describeStackResourceDrifts(Consumer<DescribeStackResourceDriftsRequest.Builder> describeStackResourceDriftsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where AWS CloudFormation detects configuration drift.
For a given stack, there will be one StackResourceDrift
for each stack resource that has been
checked for drift. Resources that have not yet been checked for drift are not included. Resources that do not
currently support drift detection are not checked, and so not included. For a list of resources that support
drift detection, see Resources that Support Drift Detection.
Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all supported resources for a given stack.
This is a convenience which creates an instance of the DescribeStackResourceDriftsRequest.Builder
avoiding the need to create one manually via DescribeStackResourceDriftsRequest.builder()
describeStackResourceDriftsRequest
- A Consumer
that will call methods on DescribeStackResourceDriftsInput.Builder
to create a
request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceDriftsIterable describeStackResourceDriftsPaginator(DescribeStackResourceDriftsRequest describeStackResourceDriftsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where AWS CloudFormation detects configuration drift.
For a given stack, there will be one StackResourceDrift
for each stack resource that has been
checked for drift. Resources that have not yet been checked for drift are not included. Resources that do not
currently support drift detection are not checked, and so not included. For a list of resources that support
drift detection, see Resources that Support Drift Detection.
Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all supported resources for a given stack.
This is a variant of
describeStackResourceDrifts(software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client.describeStackResourceDriftsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client .describeStackResourceDriftsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client.describeStackResourceDriftsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStackResourceDrifts(software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsRequest)
operation.
describeStackResourceDriftsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourceDriftsIterable describeStackResourceDriftsPaginator(Consumer<DescribeStackResourceDriftsRequest.Builder> describeStackResourceDriftsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns drift information for the resources that have been checked for drift in the specified stack. This includes actual and expected configuration values for resources where AWS CloudFormation detects configuration drift.
For a given stack, there will be one StackResourceDrift
for each stack resource that has been
checked for drift. Resources that have not yet been checked for drift are not included. Resources that do not
currently support drift detection are not checked, and so not included. For a list of resources that support
drift detection, see Resources that Support Drift Detection.
Use DetectStackResourceDrift to detect drift on individual resources, or DetectStackDrift to detect drift on all supported resources for a given stack.
This is a variant of
describeStackResourceDrifts(software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client.describeStackResourceDriftsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client .describeStackResourceDriftsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStackResourceDriftsIterable responses = client.describeStackResourceDriftsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStackResourceDrifts(software.amazon.awssdk.services.cloudformation.model.DescribeStackResourceDriftsRequest)
operation.
This is a convenience which creates an instance of the DescribeStackResourceDriftsRequest.Builder
avoiding the need to create one manually via DescribeStackResourceDriftsRequest.builder()
describeStackResourceDriftsRequest
- A Consumer
that will call methods on DescribeStackResourceDriftsInput.Builder
to create a
request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourcesResponse describeStackResources(DescribeStackResourcesRequest describeStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns AWS resource descriptions for running and deleted stacks. If StackName
is specified, all the
associated resources that are part of the stack are returned. If PhysicalResourceId
is specified,
the associated resources of the stack that the resource belongs to are returned.
Only the first 100 resources will be returned. If your stack has more resources than this, you should use
ListStackResources
instead.
For deleted stacks, DescribeStackResources
returns resource information for up to 90 days after the
stack has been deleted.
You must specify either StackName
or PhysicalResourceId
, but not both. In addition, you
can specify LogicalResourceId
to filter the returned result. For more information about resources,
the LogicalResourceId
and PhysicalResourceId
, go to the AWS CloudFormation User Guide.
A ValidationError
is returned if you specify both StackName
and
PhysicalResourceId
in the same request.
describeStackResourcesRequest
- The input for DescribeStackResources action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackResourcesResponse describeStackResources(Consumer<DescribeStackResourcesRequest.Builder> describeStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns AWS resource descriptions for running and deleted stacks. If StackName
is specified, all the
associated resources that are part of the stack are returned. If PhysicalResourceId
is specified,
the associated resources of the stack that the resource belongs to are returned.
Only the first 100 resources will be returned. If your stack has more resources than this, you should use
ListStackResources
instead.
For deleted stacks, DescribeStackResources
returns resource information for up to 90 days after the
stack has been deleted.
You must specify either StackName
or PhysicalResourceId
, but not both. In addition, you
can specify LogicalResourceId
to filter the returned result. For more information about resources,
the LogicalResourceId
and PhysicalResourceId
, go to the AWS CloudFormation User Guide.
A ValidationError
is returned if you specify both StackName
and
PhysicalResourceId
in the same request.
This is a convenience which creates an instance of the DescribeStackResourcesRequest.Builder
avoiding the
need to create one manually via DescribeStackResourcesRequest.builder()
describeStackResourcesRequest
- A Consumer
that will call methods on DescribeStackResourcesInput.Builder
to create a
request. The input for DescribeStackResources action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackSetResponse describeStackSet(DescribeStackSetRequest describeStackSetRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the description of the specified stack set.
describeStackSetRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackSetResponse describeStackSet(Consumer<DescribeStackSetRequest.Builder> describeStackSetRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the description of the specified stack set.
This is a convenience which creates an instance of the DescribeStackSetRequest.Builder
avoiding the need
to create one manually via DescribeStackSetRequest.builder()
describeStackSetRequest
- A Consumer
that will call methods on DescribeStackSetInput.Builder
to create a request.StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackSetOperationResponse describeStackSetOperation(DescribeStackSetOperationRequest describeStackSetOperationRequest) throws StackSetNotFoundException, OperationNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the description of the specified stack set operation.
describeStackSetOperationRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStackSetOperationResponse describeStackSetOperation(Consumer<DescribeStackSetOperationRequest.Builder> describeStackSetOperationRequest) throws StackSetNotFoundException, OperationNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the description of the specified stack set operation.
This is a convenience which creates an instance of the DescribeStackSetOperationRequest.Builder
avoiding
the need to create one manually via DescribeStackSetOperationRequest.builder()
describeStackSetOperationRequest
- A Consumer
that will call methods on DescribeStackSetOperationInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStacksResponse describeStacks() throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
describeStacks(DescribeStacksRequest)
,
AWS
API Documentationdefault DescribeStacksResponse describeStacks(DescribeStacksRequest describeStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
describeStacksRequest
- The input for DescribeStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStacksResponse describeStacks(Consumer<DescribeStacksRequest.Builder> describeStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
This is a convenience which creates an instance of the DescribeStacksRequest.Builder
avoiding the need to
create one manually via DescribeStacksRequest.builder()
describeStacksRequest
- A Consumer
that will call methods on DescribeStacksInput.Builder
to create a request. The
input for DescribeStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStacksIterable describeStacksPaginator() throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
This is a variant of
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client .describeStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
describeStacksPaginator(DescribeStacksRequest)
,
AWS
API Documentationdefault DescribeStacksIterable describeStacksPaginator(DescribeStacksRequest describeStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
This is a variant of
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client .describeStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
describeStacksRequest
- The input for DescribeStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DescribeStacksIterable describeStacksPaginator(Consumer<DescribeStacksRequest.Builder> describeStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created.
If the stack does not exist, an AmazonCloudFormationException
is returned.
This is a variant of
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
The return type is a custom iterable that can be used to iterate through all the pages. SDK will internally
handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client .describeStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.DescribeStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.DescribeStacksIterable responses = client.describeStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeStacks(software.amazon.awssdk.services.cloudformation.model.DescribeStacksRequest)
operation.
This is a convenience which creates an instance of the DescribeStacksRequest.Builder
avoiding the need to
create one manually via DescribeStacksRequest.builder()
describeStacksRequest
- A Consumer
that will call methods on DescribeStacksInput.Builder
to create a request. The
input for DescribeStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DetectStackDriftResponse detectStackDrift(DetectStackDriftRequest detectStackDriftRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. For each resource in the stack that supports drift detection, AWS CloudFormation compares the actual configuration of the resource with its expected template configuration. Only resource properties explicitly defined in the stack template are checked for drift. A stack is considered to have drifted if one or more of its resources differ from their expected template configurations. For more information, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackDrift
to detect drift on all supported resources for a given stack, or
DetectStackResourceDrift to detect drift on individual resources.
For a list of stack resources that currently support drift detection, see Resources that Support Drift Detection.
DetectStackDrift
can take up to several minutes, depending on the number of resources contained
within the stack. Use DescribeStackDriftDetectionStatus to monitor the progress of a detect stack drift
operation. Once the drift detection operation has completed, use DescribeStackResourceDrifts to return
drift information about the stack and its resources.
When detecting drift on a stack, AWS CloudFormation does not detect drift on any nested stacks belonging to that
stack. Perform DetectStackDrift
directly on the nested stack itself.
detectStackDriftRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DetectStackDriftResponse detectStackDrift(Consumer<DetectStackDriftRequest.Builder> detectStackDriftRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Detects whether a stack's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. For each resource in the stack that supports drift detection, AWS CloudFormation compares the actual configuration of the resource with its expected template configuration. Only resource properties explicitly defined in the stack template are checked for drift. A stack is considered to have drifted if one or more of its resources differ from their expected template configurations. For more information, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackDrift
to detect drift on all supported resources for a given stack, or
DetectStackResourceDrift to detect drift on individual resources.
For a list of stack resources that currently support drift detection, see Resources that Support Drift Detection.
DetectStackDrift
can take up to several minutes, depending on the number of resources contained
within the stack. Use DescribeStackDriftDetectionStatus to monitor the progress of a detect stack drift
operation. Once the drift detection operation has completed, use DescribeStackResourceDrifts to return
drift information about the stack and its resources.
When detecting drift on a stack, AWS CloudFormation does not detect drift on any nested stacks belonging to that
stack. Perform DetectStackDrift
directly on the nested stack itself.
This is a convenience which creates an instance of the DetectStackDriftRequest.Builder
avoiding the need
to create one manually via DetectStackDriftRequest.builder()
detectStackDriftRequest
- A Consumer
that will call methods on DetectStackDriftInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DetectStackResourceDriftResponse detectStackResourceDrift(DetectStackResourceDriftRequest detectStackResourceDriftRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns information about whether a resource's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. This information includes actual and expected property values for resources in which AWS CloudFormation detects drift. Only resource properties explicitly defined in the stack template are checked for drift. For more information about stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackResourceDrift
to detect drift on individual resources, or DetectStackDrift to
detect drift on all resources in a given stack that support drift detection.
Resources that do not currently support drift detection cannot be checked. For a list of resources that support drift detection, see Resources that Support Drift Detection.
detectStackResourceDriftRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default DetectStackResourceDriftResponse detectStackResourceDrift(Consumer<DetectStackResourceDriftRequest.Builder> detectStackResourceDriftRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns information about whether a resource's actual configuration differs, or has drifted, from it's expected configuration, as defined in the stack template and any values specified as template parameters. This information includes actual and expected property values for resources in which AWS CloudFormation detects drift. Only resource properties explicitly defined in the stack template are checked for drift. For more information about stack and resource drift, see Detecting Unregulated Configuration Changes to Stacks and Resources.
Use DetectStackResourceDrift
to detect drift on individual resources, or DetectStackDrift to
detect drift on all resources in a given stack that support drift detection.
Resources that do not currently support drift detection cannot be checked. For a list of resources that support drift detection, see Resources that Support Drift Detection.
This is a convenience which creates an instance of the DetectStackResourceDriftRequest.Builder
avoiding
the need to create one manually via DetectStackResourceDriftRequest.builder()
detectStackResourceDriftRequest
- A Consumer
that will call methods on DetectStackResourceDriftInput.Builder
to create a
request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default EstimateTemplateCostResponse estimateTemplateCost(EstimateTemplateCostRequest estimateTemplateCostRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the estimated monthly cost of a template. The return value is an AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template.
estimateTemplateCostRequest
- The input for an EstimateTemplateCost action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default EstimateTemplateCostResponse estimateTemplateCost(Consumer<EstimateTemplateCostRequest.Builder> estimateTemplateCostRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the estimated monthly cost of a template. The return value is an AWS Simple Monthly Calculator URL with a query string that describes the resources required to run the template.
This is a convenience which creates an instance of the EstimateTemplateCostRequest.Builder
avoiding the
need to create one manually via EstimateTemplateCostRequest.builder()
estimateTemplateCostRequest
- A Consumer
that will call methods on EstimateTemplateCostInput.Builder
to create a
request. The input for an EstimateTemplateCost action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ExecuteChangeSetResponse executeChangeSet(ExecuteChangeSetRequest executeChangeSetRequest) throws InvalidChangeSetStatusException, ChangeSetNotFoundException, InsufficientCapabilitiesException, TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, AWS CloudFormation starts updating the stack. Use the DescribeStacks action to view the status of the update.
When you execute a change set, AWS CloudFormation deletes all other change sets associated with the stack because they aren't valid for the updated stack.
If a stack policy is associated with the stack, AWS CloudFormation enforces the policy during the update. You can't specify a temporary stack policy that overrides the current policy.
executeChangeSetRequest
- The input for the ExecuteChangeSet action.InvalidChangeSetStatusException
- The specified change set can't be used to update the stack. For example, the change set status might be
CREATE_IN_PROGRESS
, or the stack status might be UPDATE_IN_PROGRESS
.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ExecuteChangeSetResponse executeChangeSet(Consumer<ExecuteChangeSetRequest.Builder> executeChangeSetRequest) throws InvalidChangeSetStatusException, ChangeSetNotFoundException, InsufficientCapabilitiesException, TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Updates a stack using the input information that was provided when the specified change set was created. After the call successfully completes, AWS CloudFormation starts updating the stack. Use the DescribeStacks action to view the status of the update.
When you execute a change set, AWS CloudFormation deletes all other change sets associated with the stack because they aren't valid for the updated stack.
If a stack policy is associated with the stack, AWS CloudFormation enforces the policy during the update. You can't specify a temporary stack policy that overrides the current policy.
This is a convenience which creates an instance of the ExecuteChangeSetRequest.Builder
avoiding the need
to create one manually via ExecuteChangeSetRequest.builder()
executeChangeSetRequest
- A Consumer
that will call methods on ExecuteChangeSetInput.Builder
to create a request.
The input for the ExecuteChangeSet action.InvalidChangeSetStatusException
- The specified change set can't be used to update the stack. For example, the change set status might be
CREATE_IN_PROGRESS
, or the stack status might be UPDATE_IN_PROGRESS
.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetStackPolicyResponse getStackPolicy(GetStackPolicyRequest getStackPolicyRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the stack policy for a specified stack. If a stack doesn't have a policy, a null value is returned.
getStackPolicyRequest
- The input for the GetStackPolicy action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetStackPolicyResponse getStackPolicy(Consumer<GetStackPolicyRequest.Builder> getStackPolicyRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the stack policy for a specified stack. If a stack doesn't have a policy, a null value is returned.
This is a convenience which creates an instance of the GetStackPolicyRequest.Builder
avoiding the need to
create one manually via GetStackPolicyRequest.builder()
getStackPolicyRequest
- A Consumer
that will call methods on GetStackPolicyInput.Builder
to create a request. The
input for the GetStackPolicy action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetTemplateResponse getTemplate(GetTemplateRequest getTemplateRequest) throws ChangeSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the template body for a specified stack. You can get the template for running or deleted stacks.
For deleted stacks, GetTemplate returns the template for up to 90 days after the stack has been deleted.
If the template does not exist, a ValidationError
is returned.
getTemplateRequest
- The input for a GetTemplate action.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetTemplateResponse getTemplate(Consumer<GetTemplateRequest.Builder> getTemplateRequest) throws ChangeSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns the template body for a specified stack. You can get the template for running or deleted stacks.
For deleted stacks, GetTemplate returns the template for up to 90 days after the stack has been deleted.
If the template does not exist, a ValidationError
is returned.
This is a convenience which creates an instance of the GetTemplateRequest.Builder
avoiding the need to
create one manually via GetTemplateRequest.builder()
getTemplateRequest
- A Consumer
that will call methods on GetTemplateInput.Builder
to create a request. The
input for a GetTemplate action.ChangeSetNotFoundException
- The specified change set name or ID doesn't exit. To view valid change sets for a stack, use the
ListChangeSets
action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetTemplateSummaryResponse getTemplateSummary(GetTemplateSummaryRequest getTemplateSummaryRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns information about a new or existing template. The GetTemplateSummary
action is useful for
viewing parameter information, such as default parameter values and parameter types, before you create or update
a stack or stack set.
You can use the GetTemplateSummary
action when you submit a template, or you can get template
information for a stack set, or a running or deleted stack.
For deleted stacks, GetTemplateSummary
returns the template information for up to 90 days after the
stack has been deleted. If the template does not exist, a ValidationError
is returned.
getTemplateSummaryRequest
- The input for the GetTemplateSummary action.StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default GetTemplateSummaryResponse getTemplateSummary(Consumer<GetTemplateSummaryRequest.Builder> getTemplateSummaryRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns information about a new or existing template. The GetTemplateSummary
action is useful for
viewing parameter information, such as default parameter values and parameter types, before you create or update
a stack or stack set.
You can use the GetTemplateSummary
action when you submit a template, or you can get template
information for a stack set, or a running or deleted stack.
For deleted stacks, GetTemplateSummary
returns the template information for up to 90 days after the
stack has been deleted. If the template does not exist, a ValidationError
is returned.
This is a convenience which creates an instance of the GetTemplateSummaryRequest.Builder
avoiding the
need to create one manually via GetTemplateSummaryRequest.builder()
getTemplateSummaryRequest
- A Consumer
that will call methods on GetTemplateSummaryInput.Builder
to create a request.
The input for the GetTemplateSummary action.StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListChangeSetsResponse listChangeSets(ListChangeSetsRequest listChangeSetsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the ID and status of each active change set for a stack. For example, AWS CloudFormation lists change
sets that are in the CREATE_IN_PROGRESS
or CREATE_PENDING
state.
listChangeSetsRequest
- The input for the ListChangeSets action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListChangeSetsResponse listChangeSets(Consumer<ListChangeSetsRequest.Builder> listChangeSetsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the ID and status of each active change set for a stack. For example, AWS CloudFormation lists change
sets that are in the CREATE_IN_PROGRESS
or CREATE_PENDING
state.
This is a convenience which creates an instance of the ListChangeSetsRequest.Builder
avoiding the need to
create one manually via ListChangeSetsRequest.builder()
listChangeSetsRequest
- A Consumer
that will call methods on ListChangeSetsInput.Builder
to create a request. The
input for the ListChangeSets action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListExportsResponse listExports() throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listExports(ListExportsRequest)
,
AWS API
Documentationdefault ListExportsResponse listExports(ListExportsRequest listExportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
listExportsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListExportsResponse listExports(Consumer<ListExportsRequest.Builder> listExportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
This is a convenience which creates an instance of the ListExportsRequest.Builder
avoiding the need to
create one manually via ListExportsRequest.builder()
listExportsRequest
- A Consumer
that will call methods on ListExportsInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListExportsIterable listExportsPaginator() throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
This is a variant of
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client .listExportsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListExportsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listExportsPaginator(ListExportsRequest)
,
AWS API
Documentationdefault ListExportsIterable listExportsPaginator(ListExportsRequest listExportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
This is a variant of
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client .listExportsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListExportsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation.
listExportsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListExportsIterable listExportsPaginator(Consumer<ListExportsRequest.Builder> listExportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all exported output values in the account and region in which you call this action. Use this action to see
the exported output values that you can import into other stacks. To import values, use the
Fn::ImportValue
function.
For more information, see AWS CloudFormation Export Stack Output Values.
This is a variant of
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client .listExportsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListExportsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListExportsIterable responses = client.listExportsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listExports(software.amazon.awssdk.services.cloudformation.model.ListExportsRequest)
operation.
This is a convenience which creates an instance of the ListExportsRequest.Builder
avoiding the need to
create one manually via ListExportsRequest.builder()
listExportsRequest
- A Consumer
that will call methods on ListExportsInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListImportsResponse listImports(ListImportsRequest listImportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.
For more information about importing an exported output value, see the
Fn::ImportValue
function.
listImportsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListImportsResponse listImports(Consumer<ListImportsRequest.Builder> listImportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.
For more information about importing an exported output value, see the
Fn::ImportValue
function.
This is a convenience which creates an instance of the ListImportsRequest.Builder
avoiding the need to
create one manually via ListImportsRequest.builder()
listImportsRequest
- A Consumer
that will call methods on ListImportsInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListImportsIterable listImportsPaginator(ListImportsRequest listImportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.
For more information about importing an exported output value, see the
Fn::ImportValue
function.
This is a variant of
listImports(software.amazon.awssdk.services.cloudformation.model.ListImportsRequest)
operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client.listImportsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client .listImportsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListImportsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client.listImportsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listImports(software.amazon.awssdk.services.cloudformation.model.ListImportsRequest)
operation.
listImportsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListImportsIterable listImportsPaginator(Consumer<ListImportsRequest.Builder> listImportsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Lists all stacks that are importing an exported output value. To modify or remove an exported output value, first use this action to see which stacks are using it. To see the exported output values in your account, see ListExports.
For more information about importing an exported output value, see the
Fn::ImportValue
function.
This is a variant of
listImports(software.amazon.awssdk.services.cloudformation.model.ListImportsRequest)
operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client.listImportsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client .listImportsPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListImportsResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListImportsIterable responses = client.listImportsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listImports(software.amazon.awssdk.services.cloudformation.model.ListImportsRequest)
operation.
This is a convenience which creates an instance of the ListImportsRequest.Builder
avoiding the need to
create one manually via ListImportsRequest.builder()
listImportsRequest
- A Consumer
that will call methods on ListImportsInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackInstancesResponse listStackInstances(ListStackInstancesRequest listStackInstancesRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about stack instances that are associated with the specified stack set. You can filter for stack instances that are associated with a specific AWS account name or region.
listStackInstancesRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackInstancesResponse listStackInstances(Consumer<ListStackInstancesRequest.Builder> listStackInstancesRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about stack instances that are associated with the specified stack set. You can filter for stack instances that are associated with a specific AWS account name or region.
This is a convenience which creates an instance of the ListStackInstancesRequest.Builder
avoiding the
need to create one manually via ListStackInstancesRequest.builder()
listStackInstancesRequest
- A Consumer
that will call methods on ListStackInstancesInput.Builder
to create a request.StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackResourcesResponse listStackResources(ListStackResourcesRequest listStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns descriptions of all resources of the specified stack.
For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted.
listStackResourcesRequest
- The input for the ListStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackResourcesResponse listStackResources(Consumer<ListStackResourcesRequest.Builder> listStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns descriptions of all resources of the specified stack.
For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted.
This is a convenience which creates an instance of the ListStackResourcesRequest.Builder
avoiding the
need to create one manually via ListStackResourcesRequest.builder()
listStackResourcesRequest
- A Consumer
that will call methods on ListStackResourcesInput.Builder
to create a request.
The input for the ListStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackResourcesIterable listStackResourcesPaginator(ListStackResourcesRequest listStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns descriptions of all resources of the specified stack.
For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted.
This is a variant of
listStackResources(software.amazon.awssdk.services.cloudformation.model.ListStackResourcesRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client.listStackResourcesPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client .listStackResourcesPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListStackResourcesResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client.listStackResourcesPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listStackResources(software.amazon.awssdk.services.cloudformation.model.ListStackResourcesRequest)
operation.
listStackResourcesRequest
- The input for the ListStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackResourcesIterable listStackResourcesPaginator(Consumer<ListStackResourcesRequest.Builder> listStackResourcesRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns descriptions of all resources of the specified stack.
For deleted stacks, ListStackResources returns resource information for up to 90 days after the stack has been deleted.
This is a variant of
listStackResources(software.amazon.awssdk.services.cloudformation.model.ListStackResourcesRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client.listStackResourcesPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client .listStackResourcesPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListStackResourcesResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListStackResourcesIterable responses = client.listStackResourcesPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listStackResources(software.amazon.awssdk.services.cloudformation.model.ListStackResourcesRequest)
operation.
This is a convenience which creates an instance of the ListStackResourcesRequest.Builder
avoiding the
need to create one manually via ListStackResourcesRequest.builder()
listStackResourcesRequest
- A Consumer
that will call methods on ListStackResourcesInput.Builder
to create a request.
The input for the ListStackResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetOperationResultsResponse listStackSetOperationResults(ListStackSetOperationResultsRequest listStackSetOperationResultsRequest) throws StackSetNotFoundException, OperationNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about the results of a stack set operation.
listStackSetOperationResultsRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetOperationResultsResponse listStackSetOperationResults(Consumer<ListStackSetOperationResultsRequest.Builder> listStackSetOperationResultsRequest) throws StackSetNotFoundException, OperationNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about the results of a stack set operation.
This is a convenience which creates an instance of the ListStackSetOperationResultsRequest.Builder
avoiding the need to create one manually via ListStackSetOperationResultsRequest.builder()
listStackSetOperationResultsRequest
- A Consumer
that will call methods on ListStackSetOperationResultsInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetOperationsResponse listStackSetOperations(ListStackSetOperationsRequest listStackSetOperationsRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about operations performed on a stack set.
listStackSetOperationsRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetOperationsResponse listStackSetOperations(Consumer<ListStackSetOperationsRequest.Builder> listStackSetOperationsRequest) throws StackSetNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about operations performed on a stack set.
This is a convenience which creates an instance of the ListStackSetOperationsRequest.Builder
avoiding the
need to create one manually via ListStackSetOperationsRequest.builder()
listStackSetOperationsRequest
- A Consumer
that will call methods on ListStackSetOperationsInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetsResponse listStackSets() throws AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about stack sets that are associated with the user.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listStackSets(ListStackSetsRequest)
,
AWS
API Documentationdefault ListStackSetsResponse listStackSets(ListStackSetsRequest listStackSetsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about stack sets that are associated with the user.
listStackSetsRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStackSetsResponse listStackSets(Consumer<ListStackSetsRequest.Builder> listStackSetsRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns summary information about stack sets that are associated with the user.
This is a convenience which creates an instance of the ListStackSetsRequest.Builder
avoiding the need to
create one manually via ListStackSetsRequest.builder()
listStackSetsRequest
- A Consumer
that will call methods on ListStackSetsInput.Builder
to create a request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStacksResponse listStacks() throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listStacks(ListStacksRequest)
,
AWS API
Documentationdefault ListStacksResponse listStacks(ListStacksRequest listStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
listStacksRequest
- The input for ListStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStacksResponse listStacks(Consumer<ListStacksRequest.Builder> listStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
This is a convenience which creates an instance of the ListStacksRequest.Builder
avoiding the need to
create one manually via ListStacksRequest.builder()
listStacksRequest
- A Consumer
that will call methods on ListStacksInput.Builder
to create a request. The
input for ListStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStacksIterable listStacksPaginator() throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
This is a variant of listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation.
SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
listStacksPaginator(ListStacksRequest)
,
AWS API
Documentationdefault ListStacksIterable listStacksPaginator(ListStacksRequest listStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
This is a variant of listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation.
listStacksRequest
- The input for ListStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ListStacksIterable listStacksPaginator(Consumer<ListStacksRequest.Builder> listStacksRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Returns the summary information for stacks whose status matches the specified StackStatusFilter. Summary information for stacks that have been deleted is kept for 90 days after the stack is deleted. If no StackStatusFilter is specified, summary information for all stacks is returned (including existing stacks and stacks that have been deleted).
This is a variant of listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{ @code software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request); for (software.amazon.awssdk.services.cloudformation.model.ListStacksResponse response : responses) { // do something; } }3) Use iterator directly
software.amazon.awssdk.services.cloudformation.paginators.ListStacksIterable responses = client.listStacksPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listStacks(software.amazon.awssdk.services.cloudformation.model.ListStacksRequest)
operation.
This is a convenience which creates an instance of the ListStacksRequest.Builder
avoiding the need to
create one manually via ListStacksRequest.builder()
listStacksRequest
- A Consumer
that will call methods on ListStacksInput.Builder
to create a request. The
input for ListStacks action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default SetStackPolicyResponse setStackPolicy(SetStackPolicyRequest setStackPolicyRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Sets a stack policy for a specified stack.
setStackPolicyRequest
- The input for the SetStackPolicy action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default SetStackPolicyResponse setStackPolicy(Consumer<SetStackPolicyRequest.Builder> setStackPolicyRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Sets a stack policy for a specified stack.
This is a convenience which creates an instance of the SetStackPolicyRequest.Builder
avoiding the need to
create one manually via SetStackPolicyRequest.builder()
setStackPolicyRequest
- A Consumer
that will call methods on SetStackPolicyInput.Builder
to create a request. The
input for the SetStackPolicy action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default SignalResourceResponse signalResource(SignalResourceRequest signalResourceRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Sends a signal to the specified resource with a success or failure status. You can use the SignalResource API in conjunction with a creation policy or update policy. AWS CloudFormation doesn't proceed with a stack creation or update until resources receive the required number of signals or the timeout period is exceeded. The SignalResource API is useful in cases where you want to send signals from anywhere other than an Amazon EC2 instance.
signalResourceRequest
- The input for the SignalResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default SignalResourceResponse signalResource(Consumer<SignalResourceRequest.Builder> signalResourceRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Sends a signal to the specified resource with a success or failure status. You can use the SignalResource API in conjunction with a creation policy or update policy. AWS CloudFormation doesn't proceed with a stack creation or update until resources receive the required number of signals or the timeout period is exceeded. The SignalResource API is useful in cases where you want to send signals from anywhere other than an Amazon EC2 instance.
This is a convenience which creates an instance of the SignalResourceRequest.Builder
avoiding the need to
create one manually via SignalResourceRequest.builder()
signalResourceRequest
- A Consumer
that will call methods on SignalResourceInput.Builder
to create a request. The
input for the SignalResource action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default StopStackSetOperationResponse stopStackSetOperation(StopStackSetOperationRequest stopStackSetOperationRequest) throws StackSetNotFoundException, OperationNotFoundException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Stops an in-progress operation on a stack set and its associated stack instances.
stopStackSetOperationRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default StopStackSetOperationResponse stopStackSetOperation(Consumer<StopStackSetOperationRequest.Builder> stopStackSetOperationRequest) throws StackSetNotFoundException, OperationNotFoundException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Stops an in-progress operation on a stack set and its associated stack instances.
This is a convenience which creates an instance of the StopStackSetOperationRequest.Builder
avoiding the
need to create one manually via StopStackSetOperationRequest.builder()
stopStackSetOperationRequest
- A Consumer
that will call methods on StopStackSetOperationInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationNotFoundException
- The specified ID refers to an operation that doesn't exist.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackResponse updateStack(UpdateStackRequest updateStackRequest) throws InsufficientCapabilitiesException, TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Updates a stack as specified in the template. After the call completes successfully, the stack update starts. You can check the status of the stack via the DescribeStacks action.
To get a copy of the template for an existing stack, you can use the GetTemplate action.
For more information about creating an update template, updating a stack, and monitoring the progress of the update, see Updating a Stack.
updateStackRequest
- The input for an UpdateStack action.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackResponse updateStack(Consumer<UpdateStackRequest.Builder> updateStackRequest) throws InsufficientCapabilitiesException, TokenAlreadyExistsException, AwsServiceException, SdkClientException, CloudFormationException
Updates a stack as specified in the template. After the call completes successfully, the stack update starts. You can check the status of the stack via the DescribeStacks action.
To get a copy of the template for an existing stack, you can use the GetTemplate action.
For more information about creating an update template, updating a stack, and monitoring the progress of the update, see Updating a Stack.
This is a convenience which creates an instance of the UpdateStackRequest.Builder
avoiding the need to
create one manually via UpdateStackRequest.builder()
updateStackRequest
- A Consumer
that will call methods on UpdateStackInput.Builder
to create a request. The
input for an UpdateStack action.InsufficientCapabilitiesException
- The template contains resources with capabilities that weren't specified in the Capabilities parameter.TokenAlreadyExistsException
- A client request token already exists.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackInstancesResponse updateStackInstances(UpdateStackInstancesRequest updateStackInstancesRequest) throws StackSetNotFoundException, StackInstanceNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Updates the parameter values for stack instances for the specified accounts, within the specified regions. A stack instance refers to a stack in a specific account and region.
You can only update stack instances in regions and accounts where they already exist; to create additional stack instances, use CreateStackInstances.
During stack set updates, any parameters overridden for a stack instance are not updated, but retain their overridden value.
You can only update the parameter values that are specified in the stack set; to add or delete a parameter
itself, use UpdateStackSet
to update the stack set template. If you add a parameter to a template, before you can override the
parameter value specified in the stack set you must first use UpdateStackSet to update all stack instances with the updated template and parameter value specified in the
stack set. Once a stack instance has been updated with the new parameter, you can then override the parameter
value using UpdateStackInstances
.
updateStackInstancesRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.StackInstanceNotFoundException
- The specified stack instance doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackInstancesResponse updateStackInstances(Consumer<UpdateStackInstancesRequest.Builder> updateStackInstancesRequest) throws StackSetNotFoundException, StackInstanceNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, AwsServiceException, SdkClientException, CloudFormationException
Updates the parameter values for stack instances for the specified accounts, within the specified regions. A stack instance refers to a stack in a specific account and region.
You can only update stack instances in regions and accounts where they already exist; to create additional stack instances, use CreateStackInstances.
During stack set updates, any parameters overridden for a stack instance are not updated, but retain their overridden value.
You can only update the parameter values that are specified in the stack set; to add or delete a parameter
itself, use UpdateStackSet
to update the stack set template. If you add a parameter to a template, before you can override the
parameter value specified in the stack set you must first use UpdateStackSet to update all stack instances with the updated template and parameter value specified in the
stack set. Once a stack instance has been updated with the new parameter, you can then override the parameter
value using UpdateStackInstances
.
This is a convenience which creates an instance of the UpdateStackInstancesRequest.Builder
avoiding the
need to create one manually via UpdateStackInstancesRequest.builder()
updateStackInstancesRequest
- A Consumer
that will call methods on UpdateStackInstancesInput.Builder
to create a
request.StackSetNotFoundException
- The specified stack set doesn't exist.StackInstanceNotFoundException
- The specified stack instance doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackSetResponse updateStackSet(UpdateStackSetRequest updateStackSetRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, StackInstanceNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Updates the stack set, and associated stack instances in the specified accounts and regions.
Even if the stack set operation created by updating the stack set fails (completely or partially, below or above a specified failure tolerance), the stack set is updated with your changes. Subsequent CreateStackInstances calls on the specified stack set use the updated stack set.
updateStackSetRequest
- StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.StackInstanceNotFoundException
- The specified stack instance doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateStackSetResponse updateStackSet(Consumer<UpdateStackSetRequest.Builder> updateStackSetRequest) throws StackSetNotFoundException, OperationInProgressException, OperationIdAlreadyExistsException, StaleRequestException, InvalidOperationException, StackInstanceNotFoundException, AwsServiceException, SdkClientException, CloudFormationException
Updates the stack set, and associated stack instances in the specified accounts and regions.
Even if the stack set operation created by updating the stack set fails (completely or partially, below or above a specified failure tolerance), the stack set is updated with your changes. Subsequent CreateStackInstances calls on the specified stack set use the updated stack set.
This is a convenience which creates an instance of the UpdateStackSetRequest.Builder
avoiding the need to
create one manually via UpdateStackSetRequest.builder()
updateStackSetRequest
- A Consumer
that will call methods on UpdateStackSetInput.Builder
to create a request.StackSetNotFoundException
- The specified stack set doesn't exist.OperationInProgressException
- Another operation is currently in progress for this stack set. Only one operation can be performed for a
stack set at a given time.OperationIdAlreadyExistsException
- The specified operation ID already exists.StaleRequestException
- Another operation has been performed on this stack set since the specified operation was performed.InvalidOperationException
- The specified operation isn't valid.StackInstanceNotFoundException
- The specified stack instance doesn't exist.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateTerminationProtectionResponse updateTerminationProtection(UpdateTerminationProtectionRequest updateTerminationProtectionRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Updates termination protection for the specified stack. If a user attempts to delete a stack with termination protection enabled, the operation fails and the stack remains unchanged. For more information, see Protecting a Stack From Being Deleted in the AWS CloudFormation User Guide.
For nested stacks, termination protection is set on the root stack and cannot be changed directly on the nested stack.
updateTerminationProtectionRequest
- SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default UpdateTerminationProtectionResponse updateTerminationProtection(Consumer<UpdateTerminationProtectionRequest.Builder> updateTerminationProtectionRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Updates termination protection for the specified stack. If a user attempts to delete a stack with termination protection enabled, the operation fails and the stack remains unchanged. For more information, see Protecting a Stack From Being Deleted in the AWS CloudFormation User Guide.
For nested stacks, termination protection is set on the root stack and cannot be changed directly on the nested stack.
This is a convenience which creates an instance of the UpdateTerminationProtectionRequest.Builder
avoiding the need to create one manually via UpdateTerminationProtectionRequest.builder()
updateTerminationProtectionRequest
- A Consumer
that will call methods on UpdateTerminationProtectionInput.Builder
to create a
request.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ValidateTemplateResponse validateTemplate(ValidateTemplateRequest validateTemplateRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Validates a specified template. AWS CloudFormation first checks if the template is valid JSON. If it isn't, AWS CloudFormation checks if the template is valid YAML. If both these checks fail, AWS CloudFormation returns a template validation error.
validateTemplateRequest
- The input for ValidateTemplate action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
default ValidateTemplateResponse validateTemplate(Consumer<ValidateTemplateRequest.Builder> validateTemplateRequest) throws AwsServiceException, SdkClientException, CloudFormationException
Validates a specified template. AWS CloudFormation first checks if the template is valid JSON. If it isn't, AWS CloudFormation checks if the template is valid YAML. If both these checks fail, AWS CloudFormation returns a template validation error.
This is a convenience which creates an instance of the ValidateTemplateRequest.Builder
avoiding the need
to create one manually via ValidateTemplateRequest.builder()
validateTemplateRequest
- A Consumer
that will call methods on ValidateTemplateInput.Builder
to create a request.
The input for ValidateTemplate action.SdkException
- Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException
- If any client side error occurs such as an IO related failure, failure to get credentials, etc.CloudFormationException
- Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceException
static ServiceMetadata serviceMetadata()
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.