:doc:`MainframeModernization <../../m2>` / Client / create_data_set_export_task

***************************
create_data_set_export_task
***************************



.. py:method:: MainframeModernization.Client.create_data_set_export_task(**kwargs)

  

  Starts a data set export task for a specific application.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/m2-2021-04-28/CreateDataSetExportTask>`_  


  **Request Syntax**
  ::

    response = client.create_data_set_export_task(
        applicationId='string',
        clientToken='string',
        exportConfig={
            'dataSets': [
                {
                    'datasetName': 'string',
                    'externalLocation': {
                        's3Location': 'string'
                    }
                },
            ],
            's3Location': 'string'
        },
        kmsKeyId='string'
    )
    
  :type applicationId: string
  :param applicationId: **[REQUIRED]** 

    The unique identifier of the application for which you want to export data sets.

    

  
  :type clientToken: string
  :param clientToken: 

    Unique, case-sensitive identifier you provide to ensure the idempotency of the request to create a data set export. The service generates the clientToken when the API call is triggered. The token expires after one hour, so if you retry the API within this timeframe with the same clientToken, you will get the same response. The service also handles deleting the clientToken after it expires.

    This field is autopopulated if not provided.

  
  :type exportConfig: dict
  :param exportConfig: **[REQUIRED]** 

    The data set export task configuration.

    .. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: ``dataSets``, ``s3Location``. 

  
    - **dataSets** *(list) --* 

      The data sets.

      

    
      - *(dict) --* 

        Identifies a specific data set to export from an external location.

        

      
        - **datasetName** *(string) --* **[REQUIRED]** 

          The data set.

          

        
        - **externalLocation** *(dict) --* **[REQUIRED]** 

          The location of the data set.

          .. note::    This is a Tagged Union structure. Only one of the     following top level keys can be set: ``s3Location``. 

        
          - **s3Location** *(string) --* 

            The URI of the Amazon S3 bucket.

            

          
        
      
  
    - **s3Location** *(string) --* 

      The Amazon S3 location of the data sets.

      

    
  
  :type kmsKeyId: string
  :param kmsKeyId: 

    The identifier of a customer managed key.

    

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

    
    ::

      {
          'taskId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **taskId** *(string) --* 

        The task identifier. This operation is asynchronous. Use this identifier with the  GetDataSetExportTask operation to obtain the status of this task.

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

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

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

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

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

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

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

  