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

****************************
list_resource_scan_resources
****************************



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

  

  Lists the resources from a resource scan. The results can be filtered by resource identifier, resource type prefix, tag key, and tag value. Only resources that match all specified filters are returned. The response indicates whether each returned resource is already managed by CloudFormation.

  

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


  **Request Syntax**
  ::

    response = client.list_resource_scan_resources(
        ResourceScanId='string',
        ResourceIdentifier='string',
        ResourceTypePrefix='string',
        TagKey='string',
        TagValue='string',
        NextToken='string',
        MaxResults=123
    )
    
  :type ResourceScanId: string
  :param ResourceScanId: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the resource scan.

    

  
  :type ResourceIdentifier: string
  :param ResourceIdentifier: 

    If specified, the returned resources will have the specified resource identifier (or one of them in the case where the resource has multiple identifiers).

    

  
  :type ResourceTypePrefix: string
  :param ResourceTypePrefix: 

    If specified, the returned resources will be of any of the resource types with the specified prefix.

    

  
  :type TagKey: string
  :param TagKey: 

    If specified, the returned resources will have a matching tag key.

    

  
  :type TagValue: string
  :param TagValue: 

    If specified, the returned resources will have a matching tag value.

    

  
  :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: 

    If the number of available results exceeds this maximum, the response includes a ``NextToken`` value that you can use for the ``NextToken`` parameter to get the next set of results. By default the ``ListResourceScanResources`` API action will return at most 100 results in each response. The maximum value is 100.

    

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

    
    ::

      {
          'Resources': [
              {
                  'ResourceType': 'string',
                  'ResourceIdentifier': {
                      'string': 'string'
                  },
                  'ManagedByStack': True|False
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Resources** *(list) --* 

        List of up to ``MaxResults`` resources in the specified resource scan that match all of the specified filters.

        
        

        - *(dict) --* 

          A scanned resource returned by ``ListResourceScanResources`` or ``ListResourceScanRelatedResources``.

          
          

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

            The type of the resource, such as ``AWS::DynamoDB::Table``. For the list of supported resources, see `Resource type support for imports and drift detection <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html>`__ In the *CloudFormation User Guide*

            
          

          - **ResourceIdentifier** *(dict) --* 

            A list of up to 256 key-value pairs that identifies for the scanned resource. The key is the name of one of the primary identifiers for the resource. (Primary identifiers are specified in the ``primaryIdentifier`` list in the resource schema.) The value is the value of that primary identifier. For example, for a ``AWS::DynamoDB::Table`` resource, the primary identifiers is ``TableName`` so the key-value pair could be ``"TableName": "MyDDBTable"``. For more information, see `primaryIdentifier <https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier>`__ in the *CloudFormation Command Line Interface (CLI) User Guide*.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
          

          - **ManagedByStack** *(boolean) --* 

            If ``true``, the resource is managed by a CloudFormation stack.

            
      
    
      

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

        If the request doesn't return all the remaining results, ``NextToken`` is set to a token. To retrieve the next set of results, call ``ListResourceScanResources`` again and use that value for the ``NextToken`` parameter. If the request returns all results, ``NextToken`` is set to an empty string.

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

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

  