:doc:`imagebuilder <../../imagebuilder>` / Client / list_workflows

**************
list_workflows
**************



.. py:method:: imagebuilder.Client.list_workflows(**kwargs)

  

  Lists workflow build versions based on filtering parameters.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/imagebuilder-2019-12-02/ListWorkflows>`_  


  **Request Syntax**
  ::

    response = client.list_workflows(
        owner='Self'|'Shared'|'Amazon'|'ThirdParty'|'AWSMarketplace',
        filters=[
            {
                'name': 'string',
                'values': [
                    'string',
                ]
            },
        ],
        byName=True|False,
        maxResults=123,
        nextToken='string'
    )
    
  :type owner: string
  :param owner: 

    Used to get a list of workflow build version filtered by the identity of the creator.

    

  
  :type filters: list
  :param filters: 

    Used to streamline search results.

    

  
    - *(dict) --* 

      A filter name and value pair that is used to return a more specific list of results from a list operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

      

    
      - **name** *(string) --* 

        The name of the filter. Filter names are case-sensitive.

        

      
      - **values** *(list) --* 

        The filter values. Filter values are case-sensitive.

        

      
        - *(string) --* 

        
    
    

  :type byName: boolean
  :param byName: 

    Specify all or part of the workflow name to streamline results.

    

  
  :type maxResults: integer
  :param maxResults: 

    Specify the maximum number of items to return in a request.

    

  
  :type nextToken: string
  :param nextToken: 

    A token to specify where to start paginating. This is the nextToken from a previously truncated response.

    

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

    
    ::

      {
          'workflowVersionList': [
              {
                  'arn': 'string',
                  'name': 'string',
                  'version': 'string',
                  'description': 'string',
                  'type': 'BUILD'|'TEST'|'DISTRIBUTION',
                  'owner': 'string',
                  'dateCreated': 'string'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **workflowVersionList** *(list) --* 

        A list of workflow build versions that match the request criteria.

        
        

        - *(dict) --* 

          Contains details about this version of the workflow.

          
          

          - **arn** *(string) --* 

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

            
          

          - **name** *(string) --* 

            The name of the workflow.

            
          

          - **version** *(string) --* 

            The semantic version of the workflow resource. The format includes three nodes: <major>.<minor>.<patch>.

            
          

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

            Describes the workflow.

            
          

          - **type** *(string) --* 

            The image creation stage that this workflow applies to. Image Builder currently supports build and test stage workflows.

            
          

          - **owner** *(string) --* 

            The owner of the workflow resource.

            
          

          - **dateCreated** *(string) --* 

            The timestamp when Image Builder created the workflow version.

            
      
    
      

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

        The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

        
  
  **Exceptions**
  
  *   :py:class:`imagebuilder.Client.exceptions.ServiceException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ClientException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`imagebuilder.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`imagebuilder.Client.exceptions.InvalidPaginationTokenException`

  
  *   :py:class:`imagebuilder.Client.exceptions.ForbiddenException`

  
  *   :py:class:`imagebuilder.Client.exceptions.CallRateLimitExceededException`

  