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

************
list_imports
************



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

  

  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 <https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-importvalue.html>`__ function.

  

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


  **Request Syntax**
  ::

    response = client.list_imports(
        ExportName='string',
        NextToken='string'
    )
    
  :type ExportName: string
  :param ExportName: **[REQUIRED]** 

    The name of the exported output value. CloudFormation returns the stack names that are importing this value.

    

  
  :type NextToken: string
  :param NextToken: 

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

    

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

    
    ::

      {
          'Imports': [
              'string',
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Imports** *(list) --* 

        A list of stack names that are importing the specified exported output value.

        
        

        - *(string) --* 
    
      

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

        A string that identifies the next page of exports. If there is no additional page, this value is null.

        
  