Skip to content

describe_stack_instance

Operation

describe_stack_instance

describe_stack_instance(request: DescribeStackInstanceInput | DescribeStackInstanceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[DescribeStackInstanceInputDict]) -> DescribeStackInstanceOutput

Returns the stack instance that's associated with the specified StackSet, Amazon Web Services account, and Amazon Web Services Region.

For a list of stack instances that are associated with a specific StackSet, use ListStackInstances.

Parameters:

Name Type Description Default
request DescribeStackInstanceInput | DescribeStackInstanceInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[DescribeStackInstanceInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
DescribeStackInstanceOutput

An instance of DescribeStackInstanceOutput.

describe_stack_instance async

describe_stack_instance(request: DescribeStackInstanceInput | DescribeStackInstanceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[DescribeStackInstanceInputDict]) -> DescribeStackInstanceOutput

Returns the stack instance that's associated with the specified StackSet, Amazon Web Services account, and Amazon Web Services Region.

For a list of stack instances that are associated with a specific StackSet, use ListStackInstances.

Parameters:

Name Type Description Default
request DescribeStackInstanceInput | DescribeStackInstanceInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[DescribeStackInstanceInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
DescribeStackInstanceOutput

An instance of DescribeStackInstanceOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

DescribeStackInstanceInputDict

Bases: TypedDict

Dictionary form of DescribeStackInstanceInput.

Attributes

call_as instance-attribute
call_as: str | None

[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

By default, SELF is specified. Use SELF for StackSets with self-managed permissions.

  • If you are signed in to the management account, specify SELF.

  • If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.

Your Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the CloudFormation User Guide.

stack_instance_account instance-attribute
stack_instance_account: Required[str]

The ID of an Amazon Web Services account that's associated with this stack instance.

stack_instance_region instance-attribute
stack_instance_region: Required[str]

The name of a Region that's associated with this stack instance.

stack_set_name instance-attribute
stack_set_name: Required[str]

The name or the unique stack ID of the StackSet that you want to get stack instance information for.

DescribeStackInstanceInput dataclass

Bases: _SerdeShape

Dataclass for DescribeStackInstanceInput structure.

Attributes

call_as class-attribute instance-attribute
call_as: str | None = ...

[Service-managed permissions] Specifies whether you are acting as an account administrator in the organization's management account or as a delegated administrator in a member account.

By default, SELF is specified. Use SELF for StackSets with self-managed permissions.

  • If you are signed in to the management account, specify SELF.

  • If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.

Your Amazon Web Services account must be registered as a delegated administrator in the management account. For more information, see Register a delegated administrator in the CloudFormation User Guide.

stack_instance_account class-attribute instance-attribute
stack_instance_account: str | None = ...

The ID of an Amazon Web Services account that's associated with this stack instance.

stack_instance_region class-attribute instance-attribute
stack_instance_region: str | None = ...

The name of a Region that's associated with this stack instance.

stack_set_name class-attribute instance-attribute
stack_set_name: str | None = ...

The name or the unique stack ID of the StackSet that you want to get stack instance information for.

Output

DescribeStackInstanceOutput dataclass

Bases: _SerdeShape

Dataclass for DescribeStackInstanceOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

stack_instance class-attribute instance-attribute
stack_instance: StackInstance | None = ...

The stack instance that matches the specified request parameters.