:doc:`Rekognition <../../rekognition>` / Client / distribute_dataset_entries

**************************
distribute_dataset_entries
**************************



.. py:method:: Rekognition.Client.distribute_dataset_entries(**kwargs)

  

  .. note::

    

    This operation applies only to Amazon Rekognition Custom Labels.

    

   

  Distributes the entries (images) in a training dataset across the training dataset and the test dataset for a project. ``DistributeDatasetEntries`` moves 20% of the training dataset images to the test dataset. An entry is a JSON Line that describes an image.

   

  You supply the Amazon Resource Names (ARN) of a project's training dataset and test dataset. The training dataset must contain the images that you want to split. The test dataset must be empty. The datasets must belong to the same project. To create training and test datasets for a project, call  CreateDataset.

   

  Distributing a dataset takes a while to complete. To check the status call ``DescribeDataset``. The operation is complete when the ``Status`` field for the training dataset and the test dataset is ``UPDATE_COMPLETE``. If the dataset split fails, the value of ``Status`` is ``UPDATE_FAILED``.

   

  This operation requires permissions to perform the ``rekognition:DistributeDatasetEntries`` action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/rekognition-2016-06-27/DistributeDatasetEntries>`_  


  **Request Syntax**
  ::

    response = client.distribute_dataset_entries(
        Datasets=[
            {
                'Arn': 'string'
            },
        ]
    )
    
  :type Datasets: list
  :param Datasets: **[REQUIRED]** 

    The ARNS for the training dataset and test dataset that you want to use. The datasets must belong to the same project. The test dataset must be empty.

    

  
    - *(dict) --* 

      A training dataset or a test dataset used in a dataset distribution operation. For more information, see  DistributeDatasetEntries.

      

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

        The Amazon Resource Name (ARN) of the dataset that you want to use.

        

      
    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`Rekognition.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Rekognition.Client.exceptions.InvalidParameterException`

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

  
  *   :py:class:`Rekognition.Client.exceptions.InternalServerError`

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

  
  *   :py:class:`Rekognition.Client.exceptions.ProvisionedThroughputExceededException`

  
  *   :py:class:`Rekognition.Client.exceptions.ResourceNotReadyException`

  