:doc:`Connect <../../connect>` / Paginator / SearchResourceTags

******************
SearchResourceTags
******************



.. py:class:: Connect.Paginator.SearchResourceTags

  ::

    
    paginator = client.get_paginator('search_resource_tags')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`Connect.Client.search_resource_tags`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/SearchResourceTags>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          InstanceId='string',
          ResourceTypes=[
              'string',
          ],
          SearchCriteria={
              'TagSearchCondition': {
                  'tagKey': 'string',
                  'tagValue': 'string',
                  'tagKeyComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT',
                  'tagValueComparisonType': 'STARTS_WITH'|'CONTAINS'|'EXACT'
              }
          },
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type InstanceId: string
    :param InstanceId: **[REQUIRED]** 

      The identifier of the Amazon Connect instance. You can find the instanceId in the Amazon Resource Name (ARN) of the instance.

      

    
    :type ResourceTypes: list
    :param ResourceTypes: 

      The list of resource types to be used to search tags from. If not provided or if any empty list is provided, this API will search from all supported resource types. Note that lowercase and - are required.

       

      **Supported resource types**

       

      
      * agent
       
      * agent-state
       
      * routing-profile
       
      * standard-queue
       
      * security-profile
       
      * operating-hours
       
      * prompt
       
      * contact-flow
       
      * flow- module
       
      * transfer-destination (also known as quick connect)
      

      

    
      - *(string) --* 

      
  
    :type SearchCriteria: dict
    :param SearchCriteria: 

      The search criteria to be used to return tags.

      

    
      - **TagSearchCondition** *(dict) --* 

        The search criteria to be used to return tags.

        

      
        - **tagKey** *(string) --* 

          The tag key used in the tag search condition.

          

        
        - **tagValue** *(string) --* 

          The tag value used in the tag search condition.

          

        
        - **tagKeyComparisonType** *(string) --* 

          The type of comparison to be made when evaluating the tag key in tag search condition.

          

        
        - **tagValueComparisonType** *(string) --* 

          The type of comparison to be made when evaluating the tag value in tag search condition.

          

        
      
    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            'Tags': [
                {
                    'key': 'string',
                    'value': 'string'
                },
            ],
            
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **Tags** *(list) --* 

          A list of tags used in the Amazon Connect instance.

          
          

          - *(dict) --* 

            A tag set contains tag key and tag value.

            
            

            - **key** *(string) --* 

              The tag key in the TagSet.

              
            

            - **value** *(string) --* 

              The tag value in the tagSet.

              
        
      
    