:doc:`Artifact <../../artifact>` / Client / list_report_versions

********************
list_report_versions
********************



.. py:method:: Artifact.Client.list_report_versions(**kwargs)

  

  List available report versions for a given report.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/artifact-2018-05-10/ListReportVersions>`_  


  **Request Syntax**
  ::

    response = client.list_report_versions(
        reportId='string',
        maxResults=123,
        nextToken='string'
    )
    
  :type reportId: string
  :param reportId: **[REQUIRED]** 

    Unique resource ID for the report resource.

    

  
  :type maxResults: integer
  :param maxResults: 

    Maximum number of resources to return in the paginated response.

    

  
  :type nextToken: string
  :param nextToken: 

    Pagination token to request the next page of resources.

    

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

    
    ::

      {
          'reports': [
              {
                  'id': 'string',
                  'name': 'string',
                  'state': 'PUBLISHED'|'UNPUBLISHED',
                  'arn': 'string',
                  'version': 123,
                  'uploadState': 'PROCESSING'|'COMPLETE'|'FAILED'|'FAULT',
                  'description': 'string',
                  'periodStart': datetime(2015, 1, 1),
                  'periodEnd': datetime(2015, 1, 1),
                  'series': 'string',
                  'category': 'string',
                  'companyName': 'string',
                  'productName': 'string',
                  'statusMessage': 'string',
                  'acceptanceType': 'PASSTHROUGH'|'EXPLICIT'
              },
          ],
          'nextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **reports** *(list) --* 

        List of report resources.

        
        

        - *(dict) --* 

          Summary for report resource.

          
          

          - **id** *(string) --* 

            Unique resource ID for the report resource.

            
          

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

            Name for the report resource.

            
          

          - **state** *(string) --* 

            Current state of the report resource.

            
          

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

            ARN for the report resource.

            
          

          - **version** *(integer) --* 

            Version for the report resource.

            
          

          - **uploadState** *(string) --* 

            The current state of the document upload.

            
          

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

            Description for the report resource.

            
          

          - **periodStart** *(datetime) --* 

            Timestamp indicating the report resource effective start.

            
          

          - **periodEnd** *(datetime) --* 

            Timestamp indicating the report resource effective end.

            
          

          - **series** *(string) --* 

            Series for the report resource.

            
          

          - **category** *(string) --* 

            Category for the report resource.

            
          

          - **companyName** *(string) --* 

            Associated company name for the report resource.

            
          

          - **productName** *(string) --* 

            Associated product name for the report resource.

            
          

          - **statusMessage** *(string) --* 

            The message associated with the current upload state.

            
          

          - **acceptanceType** *(string) --* 

            Acceptance type for report.

            
      
    
      

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

        Pagination token to request the next page of resources.

        
  
  **Exceptions**
  
  *   :py:class:`Artifact.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Artifact.Client.exceptions.ThrottlingException`

  
  *   :py:class:`Artifact.Client.exceptions.AccessDeniedException`

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

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

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

  