:doc:`Glue <../../glue>` / Client / list_jobs

*********
list_jobs
*********



.. py:method:: Glue.Client.list_jobs(**kwargs)

  

  Retrieves the names of all job resources in this Amazon Web Services account, or the resources with the specified tag. This operation allows you to see which resources are available in your account, and their names.

   

  This operation takes the optional ``Tags`` field, which you can use as a filter on the response so that tagged resources can be retrieved as a group. If you choose to use tags filtering, only resources with the tag are retrieved.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/glue-2017-03-31/ListJobs>`_  


  **Request Syntax**
  ::

    response = client.list_jobs(
        NextToken='string',
        MaxResults=123,
        Tags={
            'string': 'string'
        }
    )
    
  :type NextToken: string
  :param NextToken: 

    A continuation token, if this is a continuation request.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum size of a list to return.

    

  
  :type Tags: dict
  :param Tags: 

    Specifies to return only these tagged resources.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


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

    
    ::

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

    

    - *(dict) --* 
      

      - **JobNames** *(list) --* 

        The names of all jobs in the account, or the jobs with the specified tags.

        
        

        - *(string) --* 
    
      

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

        A continuation token, if the returned list does not contain the last metric available.

        
  
  **Exceptions**
  
  *   :py:class:`Glue.Client.exceptions.InvalidInputException`

  
  *   :py:class:`Glue.Client.exceptions.EntityNotFoundException`

  
  *   :py:class:`Glue.Client.exceptions.InternalServiceException`

  
  *   :py:class:`Glue.Client.exceptions.OperationTimeoutException`

  