:doc:`LexModelsV2 <../../lexv2-models>` / Client / list_slot_types

***************
list_slot_types
***************



.. py:method:: LexModelsV2.Client.list_slot_types(**kwargs)

  

  Gets a list of slot types that match the specified criteria.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListSlotTypes>`_  


  **Request Syntax**
  ::

    response = client.list_slot_types(
        botId='string',
        botVersion='string',
        localeId='string',
        sortBy={
            'attribute': 'SlotTypeName'|'LastUpdatedDateTime',
            'order': 'Ascending'|'Descending'
        },
        filters=[
            {
                'name': 'SlotTypeName'|'ExternalSourceType',
                'values': [
                    'string',
                ],
                'operator': 'CO'|'EQ'
            },
        ],
        maxResults=123,
        nextToken='string'
    )
    
  :type botId: string
  :param botId: **[REQUIRED]** 

    The unique identifier of the bot that contains the slot types.

    

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

    The version of the bot that contains the slot type.

    

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

    The identifier of the language and locale of the slot types to list. The string must match one of the supported locales. For more information, see `Supported languages <https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html>`__.

    

  
  :type sortBy: dict
  :param sortBy: 

    Determines the sort order for the response from the ``ListSlotTypes`` operation. You can choose to sort by the slot type name or last updated date in either ascending or descending order.

    

  
    - **attribute** *(string) --* **[REQUIRED]** 

      The attribute to use to sort the list of slot types.

      

    
    - **order** *(string) --* **[REQUIRED]** 

      The order to sort the list. You can say ascending or descending.

      

    
  
  :type filters: list
  :param filters: 

    Provides the specification of a filter used to limit the slot types in the response to only those that match the filter specification. You can only specify one filter and only one string to filter on.

    

  
    - *(dict) --* 

      Filters the response from the ``ListSlotTypes`` operation.

      

    
      - **name** *(string) --* **[REQUIRED]** 

        The name of the field to use for filtering.

        

      
      - **values** *(list) --* **[REQUIRED]** 

        The value to use to filter the response.

        

      
        - *(string) --* 

        
    
      - **operator** *(string) --* **[REQUIRED]** 

        The operator to use for the filter. Specify ``EQ`` when the ``ListSlotTypes`` operation should return only aliases that equal the specified value. Specify ``CO`` when the ``ListSlotTypes`` operation should return aliases that contain the specified value.

        

      
    

  :type maxResults: integer
  :param maxResults: 

    The maximum number of slot types to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

    

  
  :type nextToken: string
  :param nextToken: 

    If the response from the ``ListSlotTypes`` operation contains more results than specified in the ``maxResults`` parameter, a token is returned in the response. Use that token in the ``nextToken`` parameter to return the next page of results.

    

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

    
    ::

      {
          'botId': 'string',
          'botVersion': 'string',
          'localeId': 'string',
          'slotTypeSummaries': [
              {
                  'slotTypeId': 'string',
                  'slotTypeName': 'string',
                  'description': 'string',
                  'parentSlotTypeSignature': 'string',
                  'lastUpdatedDateTime': datetime(2015, 1, 1),
                  'slotTypeCategory': 'Custom'|'Extended'|'ExternalGrammar'|'Composite'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **botId** *(string) --* 

        The identifier of the bot that contains the slot types.

        
      

      - **botVersion** *(string) --* 

        The version of the bot that contains the slot types.

        
      

      - **localeId** *(string) --* 

        The language and local of the slot types in the list.

        
      

      - **slotTypeSummaries** *(list) --* 

        Summary information for the slot types that meet the filter criteria specified in the request. The length of the list is specified in the ``maxResults`` parameter of the request. If there are more slot types available, the ``nextToken`` field contains a token to get the next page of results.

        
        

        - *(dict) --* 

          Provides summary information about a slot type.

          
          

          - **slotTypeId** *(string) --* 

            The unique identifier assigned to the slot type.

            
          

          - **slotTypeName** *(string) --* 

            The name of the slot type.

            
          

          - **description** *(string) --* 

            The description of the slot type.

            
          

          - **parentSlotTypeSignature** *(string) --* 

            If the slot type is derived from a built-on slot type, the name of the parent slot type.

            
          

          - **lastUpdatedDateTime** *(datetime) --* 

            A timestamp of the date and time that the slot type was last updated.

            
          

          - **slotTypeCategory** *(string) --* 

            Indicates the type of the slot type.

             

            
            * ``Custom`` - A slot type that you created using custom values. For more information, see `Creating custom slot types <https://docs.aws.amazon.com/lexv2/latest/dg/custom-slot-types.html>`__.
             
            * ``Extended`` - A slot type created by extending the ``AMAZON.AlphaNumeric`` built-in slot type. For more information, see `AMAZON.AlphaNumeric <https://docs.aws.amazon.com/lexv2/latest/dg/built-in-slot-alphanumerice.html>`__.
             
            * ``ExternalGrammar`` - A slot type using a custom GRXML grammar to define values. For more information, see `Using a custom grammar slot type <https://docs.aws.amazon.com/lexv2/latest/dg/building-grxml.html>`__.
            

            
      
    
      

      - **nextToken** *(string) --* 

        A token that indicates whether there are more results to return in a response to the ``ListSlotTypes`` operation. If the ``nextToken`` field is present, you send the contents as the ``nextToken`` parameter of a ``ListSlotTypes`` operation request to get the next page of results.

        
  
  **Exceptions**
  
  *   :py:class:`LexModelsV2.Client.exceptions.ThrottlingException`

  
  *   :py:class:`LexModelsV2.Client.exceptions.ServiceQuotaExceededException`

  
  *   :py:class:`LexModelsV2.Client.exceptions.ValidationException`

  
  *   :py:class:`LexModelsV2.Client.exceptions.InternalServerException`

  