:doc:`SageMaker <../../sagemaker>` / Client / list_transform_jobs

*******************
list_transform_jobs
*******************



.. py:method:: SageMaker.Client.list_transform_jobs(**kwargs)

  

  Lists transform jobs.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListTransformJobs>`_  


  **Request Syntax**
  ::

    response = client.list_transform_jobs(
        CreationTimeAfter=datetime(2015, 1, 1),
        CreationTimeBefore=datetime(2015, 1, 1),
        LastModifiedTimeAfter=datetime(2015, 1, 1),
        LastModifiedTimeBefore=datetime(2015, 1, 1),
        NameContains='string',
        StatusEquals='InProgress'|'Completed'|'Failed'|'Stopping'|'Stopped',
        SortBy='Name'|'CreationTime'|'Status',
        SortOrder='Ascending'|'Descending',
        NextToken='string',
        MaxResults=123
    )
    
  :type CreationTimeAfter: datetime
  :param CreationTimeAfter: 

    A filter that returns only transform jobs created after the specified time.

    

  
  :type CreationTimeBefore: datetime
  :param CreationTimeBefore: 

    A filter that returns only transform jobs created before the specified time.

    

  
  :type LastModifiedTimeAfter: datetime
  :param LastModifiedTimeAfter: 

    A filter that returns only transform jobs modified after the specified time.

    

  
  :type LastModifiedTimeBefore: datetime
  :param LastModifiedTimeBefore: 

    A filter that returns only transform jobs modified before the specified time.

    

  
  :type NameContains: string
  :param NameContains: 

    A string in the transform job name. This filter returns only transform jobs whose name contains the specified string.

    

  
  :type StatusEquals: string
  :param StatusEquals: 

    A filter that retrieves only transform jobs with a specific status.

    

  
  :type SortBy: string
  :param SortBy: 

    The field to sort results by. The default is ``CreationTime``.

    

  
  :type SortOrder: string
  :param SortOrder: 

    The sort order for results. The default is ``Descending``.

    

  
  :type NextToken: string
  :param NextToken: 

    If the result of the previous ``ListTransformJobs`` request was truncated, the response includes a ``NextToken``. To retrieve the next set of transform jobs, use the token in the next request.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of transform jobs to return in the response. The default value is ``10``.

    

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

    
    ::

      {
          'TransformJobSummaries': [
              {
                  'TransformJobName': 'string',
                  'TransformJobArn': 'string',
                  'CreationTime': datetime(2015, 1, 1),
                  'TransformEndTime': datetime(2015, 1, 1),
                  'LastModifiedTime': datetime(2015, 1, 1),
                  'TransformJobStatus': 'InProgress'|'Completed'|'Failed'|'Stopping'|'Stopped',
                  'FailureReason': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **TransformJobSummaries** *(list) --* 

        An array of ``TransformJobSummary`` objects.

        
        

        - *(dict) --* 

          Provides a summary of a transform job. Multiple ``TransformJobSummary`` objects are returned as a list after in response to a `ListTransformJobs <https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTransformJobs.html>`__ call.

          
          

          - **TransformJobName** *(string) --* 

            The name of the transform job.

            
          

          - **TransformJobArn** *(string) --* 

            The Amazon Resource Name (ARN) of the transform job.

            
          

          - **CreationTime** *(datetime) --* 

            A timestamp that shows when the transform Job was created.

            
          

          - **TransformEndTime** *(datetime) --* 

            Indicates when the transform job ends on compute instances. For successful jobs and stopped jobs, this is the exact time recorded after the results are uploaded. For failed jobs, this is when Amazon SageMaker detected that the job failed.

            
          

          - **LastModifiedTime** *(datetime) --* 

            Indicates when the transform job was last modified.

            
          

          - **TransformJobStatus** *(string) --* 

            The status of the transform job.

            
          

          - **FailureReason** *(string) --* 

            If the transform job failed, the reason it failed.

            
      
    
      

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

        If the response is truncated, Amazon SageMaker returns this token. To retrieve the next set of transform jobs, use it in the next request.

        
  