libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.CloudFormation.DescribeStacks

Description

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 ValidationError is returned.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeStacks Source #

The input for DescribeStacks action.

See: newDescribeStacks smart constructor.

Constructors

DescribeStacks' 

Fields

  • nextToken :: Maybe Text

    A string that identifies the next page of stacks that you want to retrieve.

  • stackName :: Maybe Text

    The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

    • Running stacks: You can specify either the stack's name or its unique stack ID.
    • Deleted stacks: You must specify the unique stack ID.

    Default: There is no default value.

Instances

Instances details
Eq DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Read DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Show DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Generic DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Associated Types

type Rep DescribeStacks :: Type -> Type #

NFData DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Methods

rnf :: DescribeStacks -> () #

Hashable DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

AWSPager DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

AWSRequest DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Associated Types

type AWSResponse DescribeStacks #

ToHeaders DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

ToPath DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

ToQuery DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

type Rep DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

type Rep DescribeStacks = D1 ('MetaData "DescribeStacks" "Amazonka.CloudFormation.DescribeStacks" "libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation" 'False) (C1 ('MetaCons "DescribeStacks'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "stackName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))
type AWSResponse DescribeStacks Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

newDescribeStacks :: DescribeStacks Source #

Create a value of DescribeStacks with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:nextToken:DescribeStacks', describeStacks_nextToken - A string that identifies the next page of stacks that you want to retrieve.

$sel:stackName:DescribeStacks', describeStacks_stackName - The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.
  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

Request Lenses

describeStacks_nextToken :: Lens' DescribeStacks (Maybe Text) Source #

A string that identifies the next page of stacks that you want to retrieve.

describeStacks_stackName :: Lens' DescribeStacks (Maybe Text) Source #

The name or the unique stack ID that is associated with the stack, which are not always interchangeable:

  • Running stacks: You can specify either the stack's name or its unique stack ID.
  • Deleted stacks: You must specify the unique stack ID.

Default: There is no default value.

Destructuring the Response

data DescribeStacksResponse Source #

The output for a DescribeStacks action.

See: newDescribeStacksResponse smart constructor.

Constructors

DescribeStacksResponse' 

Fields

  • nextToken :: Maybe Text

    If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null.

  • stacks :: Maybe [Stack]

    A list of stack structures.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Read DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Show DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Generic DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Associated Types

type Rep DescribeStacksResponse :: Type -> Type #

NFData DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

Methods

rnf :: DescribeStacksResponse -> () #

type Rep DescribeStacksResponse Source # 
Instance details

Defined in Amazonka.CloudFormation.DescribeStacks

type Rep DescribeStacksResponse = D1 ('MetaData "DescribeStacksResponse" "Amazonka.CloudFormation.DescribeStacks" "libZSservicesZSamazonka-cloudformationZSamazonka-cloudformation" 'False) (C1 ('MetaCons "DescribeStacksResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "stacks") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Stack])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeStacksResponse Source #

Create a value of DescribeStacksResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:nextToken:DescribeStacks', describeStacksResponse_nextToken - If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null.

$sel:stacks:DescribeStacksResponse', describeStacksResponse_stacks - A list of stack structures.

$sel:httpStatus:DescribeStacksResponse', describeStacksResponse_httpStatus - The response's http status code.

Response Lenses

describeStacksResponse_nextToken :: Lens' DescribeStacksResponse (Maybe Text) Source #

If the output exceeds 1 MB in size, a string that identifies the next page of stacks. If no additional page exists, this value is null.