:doc:`CloudFormation <../../cloudformation>` / Resource / StackResource

=============
StackResource
=============



.. note::

  Before using anything on this page, please refer to the resources :doc:`user guide <../../../../guide/resources>` for the most recent guidance on using resources.



.. py:class:: CloudFormation.StackResource(stack_name,logical_id)

  A resource representing an AWS CloudFormation StackResource::

    
    import boto3
    
    cloudformation = boto3.resource('cloudformation')
    stack_resource = cloudformation.StackResource('stack_name','logical_id')

  :type stack_name: string
  :param stack_name: The StackResource's stack_name identifier. This **must** be set.
  :type logical_id: string
  :param logical_id: The StackResource's logical_id identifier. This **must** be set.
  




-----------
Identifiers
-----------



Identifiers are properties of a resource that are set upon instantiation of the resource.
For more information about identifiers refer to the :ref:`Resources Introduction Guide<identifiers_attributes_intro>`.

These are the resource's available identifiers:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  stack_name
  logical_id



----------
Attributes
----------



Attributes provide access to the properties of a resource. Attributes are lazy-loaded the first time one is accessed via the :py:meth:`load` method.
For more information about attributes refer to the :ref:`Resources Introduction Guide<identifiers_attributes_intro>`.

These are the resource's available attributes:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  description
  drift_information
  last_updated_timestamp
  logical_resource_id
  metadata
  module_info
  physical_resource_id
  resource_status
  resource_status_reason
  resource_type
  stack_id



-------------
Sub-resources
-------------



Sub-resources are methods that create a new instance of a child resource. This resource's identifiers get passed along to the child.
For more information about sub-resources refer to the :ref:`Resources Introduction Guide<subresources_intro>`.

These are the resource's available sub-resources:

.. toctree::
  :maxdepth: 1
  :titlesonly:

  Stack
