:doc:`LookoutEquipment <../../lookoutequipment>` / Client / import_dataset

**************
import_dataset
**************



.. py:method:: LookoutEquipment.Client.import_dataset(**kwargs)

  

  Imports a dataset.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/lookoutequipment-2020-12-15/ImportDataset>`_  


  **Request Syntax**
  ::

    response = client.import_dataset(
        SourceDatasetArn='string',
        DatasetName='string',
        ClientToken='string',
        ServerSideKmsKeyId='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type SourceDatasetArn: string
  :param SourceDatasetArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the dataset to import.

    

  
  :type DatasetName: string
  :param DatasetName: 

    The name of the machine learning dataset to be created. If the dataset already exists, Amazon Lookout for Equipment overwrites the existing dataset. If you don't specify this field, it is filled with the name of the source dataset.

    

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

    A unique identifier for the request. If you do not set the client request token, Amazon Lookout for Equipment generates one.

    This field is autopopulated if not provided.

  
  :type ServerSideKmsKeyId: string
  :param ServerSideKmsKeyId: 

    Provides the identifier of the KMS key key used to encrypt model data by Amazon Lookout for Equipment.

    

  
  :type Tags: list
  :param Tags: 

    Any tags associated with the dataset to be created.

    

  
    - *(dict) --* 

      A tag is a key-value pair that can be added to a resource as metadata.

      

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

        The key for the specified tag.

        

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

        The value for the specified tag.

        

      
    

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

    
    ::

      {
          'DatasetName': 'string',
          'DatasetArn': 'string',
          'Status': 'CREATED'|'INGESTION_IN_PROGRESS'|'ACTIVE'|'IMPORT_IN_PROGRESS',
          'JobId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **DatasetName** *(string) --* 

        The name of the created machine learning dataset.

        
      

      - **DatasetArn** *(string) --* 

        The Amazon Resource Name (ARN) of the dataset that was imported.

        
      

      - **Status** *(string) --* 

        The status of the ``ImportDataset`` operation.

        
      

      - **JobId** *(string) --* 

        A unique identifier for the job of importing the dataset.

        
  
  **Exceptions**
  
  *   :py:class:`LookoutEquipment.Client.exceptions.ConflictException`

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

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

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

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

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

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

  