:doc:`CloudFormation <../../cloudformation>` / Client / list_stack_instance_resource_drifts

***********************************
list_stack_instance_resource_drifts
***********************************



.. py:method:: CloudFormation.Client.list_stack_instance_resource_drifts(**kwargs)

  

  Returns drift information for resources in a stack instance.

   

  .. note::

    

    ``ListStackInstanceResourceDrifts`` returns drift information for the most recent drift detection operation. If an operation is in progress, it may only return partial results.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackInstanceResourceDrifts>`_  


  **Request Syntax**
  ::

    response = client.list_stack_instance_resource_drifts(
        StackSetName='string',
        NextToken='string',
        MaxResults=123,
        StackInstanceResourceDriftStatuses=[
            'IN_SYNC'|'MODIFIED'|'DELETED'|'NOT_CHECKED'|'UNKNOWN'|'UNSUPPORTED',
        ],
        StackInstanceAccount='string',
        StackInstanceRegion='string',
        OperationId='string',
        CallAs='SELF'|'DELEGATED_ADMIN'
    )
    
  :type StackSetName: string
  :param StackSetName: **[REQUIRED]** 

    The name or unique ID of the StackSet that you want to list drifted resources for.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for the next set of items to return. (You received this token from a previous call.)

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to be returned with a single call. If the number of available results exceeds this maximum, the response includes a ``NextToken`` value that you can assign to the ``NextToken`` request parameter to get the next set of results.

    

  
  :type StackInstanceResourceDriftStatuses: list
  :param StackInstanceResourceDriftStatuses: 

    The resource drift status of the stack instance.

     

    
    * ``DELETED``: The resource differs from its expected template configuration in that the resource has been deleted.
     
    * ``MODIFIED``: One or more resource properties differ from their expected template values.
     
    * ``IN_SYNC``: The resource's actual configuration matches its expected template configuration.
     
    * ``NOT_CHECKED``: CloudFormation doesn't currently return this value.
    

    

  
    - *(string) --* 

    

  :type StackInstanceAccount: string
  :param StackInstanceAccount: **[REQUIRED]** 

    The name of the Amazon Web Services account that you want to list resource drifts for.

    

  
  :type StackInstanceRegion: string
  :param StackInstanceRegion: **[REQUIRED]** 

    The name of the Region where you want to list resource drifts.

    

  
  :type OperationId: string
  :param OperationId: **[REQUIRED]** 

    The unique ID of the drift operation.

    

  
  :type CallAs: string
  :param CallAs: 

    [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 <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`__ in the *CloudFormation User Guide*.
    

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Summaries': [
              {
                  'StackId': 'string',
                  'LogicalResourceId': 'string',
                  'PhysicalResourceId': 'string',
                  'PhysicalResourceIdContext': [
                      {
                          'Key': 'string',
                          'Value': 'string'
                      },
                  ],
                  'ResourceType': 'string',
                  'PropertyDifferences': [
                      {
                          'PropertyPath': 'string',
                          'ExpectedValue': 'string',
                          'ActualValue': 'string',
                          'DifferenceType': 'ADD'|'REMOVE'|'NOT_EQUAL'
                      },
                  ],
                  'StackResourceDriftStatus': 'IN_SYNC'|'MODIFIED'|'DELETED'|'NOT_CHECKED'|'UNKNOWN'|'UNSUPPORTED',
                  'Timestamp': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Summaries** *(list) --* 

        A list of ``StackInstanceResourceDriftsSummary`` structures that contain information about the specified stack instances.

        
        

        - *(dict) --* 

          The structure containing summary information about resource drifts for a stack instance.

          
          

          - **StackId** *(string) --* 

            The ID of the stack instance.

            
          

          - **LogicalResourceId** *(string) --* 

            The logical name of the resource specified in the template.

            
          

          - **PhysicalResourceId** *(string) --* 

            The name or unique identifier that corresponds to a physical instance ID of a resource supported by CloudFormation.

            
          

          - **PhysicalResourceIdContext** *(list) --* 

            Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses context key-value pairs in cases where a resource's logical and physical IDs aren't enough to uniquely identify that resource. Each context key-value pair specifies a unique resource that contains the targeted resource.

            
            

            - *(dict) --* 

              Context information that enables CloudFormation to uniquely identify a resource. CloudFormation uses context key-value pairs in cases where a resource's logical and physical IDs aren't enough to uniquely identify that resource. Each context key-value pair specifies a resource that contains the targeted resource.

              
              

              - **Key** *(string) --* 

                The resource context key.

                
              

              - **Value** *(string) --* 

                The resource context value.

                
          
        
          

          - **ResourceType** *(string) --* 

            Type of resource. For more information, see `Amazon Web Services resource and property types reference <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html>`__ in the *CloudFormation User Guide*.

            
          

          - **PropertyDifferences** *(list) --* 

            Status of the actual configuration of the resource compared to its expected configuration. These will be present only for resources whose ``StackInstanceResourceDriftStatus`` is ``MODIFIED``.

            
            

            - *(dict) --* 

              Information about a resource property whose actual value differs from its expected value, as defined in the stack template and any values specified as template parameters. These will be present only for resources whose ``StackResourceDriftStatus`` is ``MODIFIED``. For more information, see `Detect unmanaged configuration changes to stacks and resources with drift detection <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-stack-drift.html>`__.

              
              

              - **PropertyPath** *(string) --* 

                The fully-qualified path to the resource property.

                
              

              - **ExpectedValue** *(string) --* 

                The expected property value of the resource property, as defined in the stack template and any values specified as template parameters.

                
              

              - **ActualValue** *(string) --* 

                The actual property value of the resource property.

                
              

              - **DifferenceType** *(string) --* 

                The type of property difference.

                 

                
                * ``ADD``: A value has been added to a resource property that's an array or list data type.
                 
                * ``REMOVE``: The property has been removed from the current resource configuration.
                 
                * ``NOT_EQUAL``: The current property value differs from its expected value (as defined in the stack template and any values specified as template parameters).
                

                
          
        
          

          - **StackResourceDriftStatus** *(string) --* 

            The drift status of the resource in a stack instance.

             

            
            * ``DELETED``: The resource differs from its expected template configuration in that the resource has been deleted.
             
            * ``MODIFIED``: One or more resource properties differ from their expected template values.
             
            * ``IN_SYNC``: The resource's actual configuration matches its expected template configuration.
             
            * ``NOT_CHECKED``: CloudFormation doesn't currently return this value.
            

            
          

          - **Timestamp** *(datetime) --* 

            Time at which the stack instance drift detection operation was initiated.

            
      
    
      

      - **NextToken** *(string) --* 

        If the previous paginated request didn't return all of the remaining results, the response object's ``NextToken`` parameter value is set to a token. To retrieve the next set of results, call this action again and assign that token to the request object's ``NextToken`` parameter. If there are no remaining results, the previous response object's ``NextToken`` parameter is set to ``null``.

        
  
  **Exceptions**
  
  *   :py:class:`CloudFormation.Client.exceptions.StackSetNotFoundException`

  
  *   :py:class:`CloudFormation.Client.exceptions.StackInstanceNotFoundException`

  
  *   :py:class:`CloudFormation.Client.exceptions.OperationNotFoundException`

  