:doc:`DataZone <../../datazone>` / Client / start_data_source_run

*********************
start_data_source_run
*********************



.. py:method:: DataZone.Client.start_data_source_run(**kwargs)

  

  Start the run of the specified data source in Amazon DataZone.

  

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


  **Request Syntax**
  ::

    response = client.start_data_source_run(
        domainIdentifier='string',
        dataSourceIdentifier='string',
        clientToken='string'
    )
    
  :type domainIdentifier: string
  :param domainIdentifier: **[REQUIRED]** 

    The identifier of the Amazon DataZone domain in which to start a data source run.

    

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

    The identifier of the data source.

    

  
  :type clientToken: string
  :param clientToken: 

    A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

    This field is autopopulated if not provided.

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

    
    ::

      {
          'domainId': 'string',
          'dataSourceId': 'string',
          'id': 'string',
          'projectId': 'string',
          'status': 'REQUESTED'|'RUNNING'|'FAILED'|'PARTIALLY_SUCCEEDED'|'SUCCESS',
          'type': 'PRIORITIZED'|'SCHEDULED',
          'dataSourceConfigurationSnapshot': 'string',
          'runStatisticsForAssets': {
              'added': 123,
              'updated': 123,
              'unchanged': 123,
              'skipped': 123,
              'failed': 123
          },
          'errorMessage': {
              'errorType': 'ACCESS_DENIED_EXCEPTION'|'CONFLICT_EXCEPTION'|'INTERNAL_SERVER_EXCEPTION'|'RESOURCE_NOT_FOUND_EXCEPTION'|'SERVICE_QUOTA_EXCEEDED_EXCEPTION'|'THROTTLING_EXCEPTION'|'VALIDATION_EXCEPTION',
              'errorDetail': 'string'
          },
          'createdAt': datetime(2015, 1, 1),
          'updatedAt': datetime(2015, 1, 1),
          'startedAt': datetime(2015, 1, 1),
          'stoppedAt': datetime(2015, 1, 1)
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **domainId** *(string) --* 

        The identifier of the Amazon DataZone domain in which to start a data source run.

        
      

      - **dataSourceId** *(string) --* 

        The identifier of the data source.

        
      

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

        The identifier of the data source run.

        
      

      - **projectId** *(string) --* 

        The identifier of the project.

        
      

      - **status** *(string) --* 

        The status of the data source run.

        
      

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

        The type of the data source run.

        
      

      - **dataSourceConfigurationSnapshot** *(string) --* 

        The configuration snapshot of the data source that is being run.

        
      

      - **runStatisticsForAssets** *(dict) --* 

        Specifies run statistics for assets.

        
        

        - **added** *(integer) --* 

          The ``added`` statistic for the data source run.

          
        

        - **updated** *(integer) --* 

          The ``updated`` statistic for the data source run.

          
        

        - **unchanged** *(integer) --* 

          The ``unchanged`` statistic for the data source run.

          
        

        - **skipped** *(integer) --* 

          The ``skipped`` statistic for the data source run.

          
        

        - **failed** *(integer) --* 

          The ``failed`` statistic for the data source run.

          
    
      

      - **errorMessage** *(dict) --* 

        Specifies the error message that is returned if the operation cannot be successfully completed.

        
        

        - **errorType** *(string) --* 

          The type of the error message that is returned if the operation cannot be successfully completed.

          
        

        - **errorDetail** *(string) --* 

          The details of the error message that is returned if the operation cannot be successfully completed.

          
    
      

      - **createdAt** *(datetime) --* 

        The timestamp of when data source run was created.

        
      

      - **updatedAt** *(datetime) --* 

        The timestamp of when the data source run was updated.

        
      

      - **startedAt** *(datetime) --* 

        The timestamp of when the data source run was started.

        
      

      - **stoppedAt** *(datetime) --* 

        The timestamp of when the data source run was stopped.

        
  
  **Exceptions**
  
  *   :py:class:`DataZone.Client.exceptions.InternalServerException`

  
  *   :py:class:`DataZone.Client.exceptions.ResourceNotFoundException`

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

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

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

  
  *   :py:class:`DataZone.Client.exceptions.ConflictException`

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

  
  *   :py:class:`DataZone.Client.exceptions.UnauthorizedException`

  