:doc:`ImportExport <../../importexport>` / Client / create_job

**********
create_job
**********



.. py:method:: ImportExport.Client.create_job(**kwargs)

  This operation initiates the process of scheduling an upload or download of your data. You include in the request a manifest that describes the data transfer specifics. The response to the request includes a job ID, which you can use in other operations, a signature that you use to identify your storage device, and the address where you should ship your storage device.

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/importexport-2010-06-01/CreateJob>`_  


  **Request Syntax**
  ::

    response = client.create_job(
        JobType='Import'|'Export',
        Manifest='string',
        ManifestAddendum='string',
        ValidateOnly=True|False,
        APIVersion='string'
    )
    
  :type JobType: string
  :param JobType: **[REQUIRED]** Specifies whether the job to initiate is an import or export job.

  
  :type Manifest: string
  :param Manifest: **[REQUIRED]** The UTF-8 encoded text of the manifest file.

  
  :type ManifestAddendum: string
  :param ManifestAddendum: For internal use only.

  
  :type ValidateOnly: boolean
  :param ValidateOnly: **[REQUIRED]** Validate the manifest and parameter values in the request but do not actually create a job.

  
  :type APIVersion: string
  :param APIVersion: Specifies the version of the client tool.

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

    
    ::

      {
          'JobId': 'string',
          'JobType': 'Import'|'Export',
          'Signature': 'string',
          'SignatureFileContents': 'string',
          'WarningMessage': 'string',
          'ArtifactList': [
              {
                  'Description': 'string',
                  'URL': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* Output structure for the CreateJob operation.
      

      - **JobId** *(string) --* A unique identifier which refers to a particular job.
      

      - **JobType** *(string) --* Specifies whether the job to initiate is an import or export job.
      

      - **Signature** *(string) --* An encrypted code used to authenticate the request and response, for example, "DV+TpDfx1/TdSE9ktyK9k/bDTVI=". Only use this value is you want to create the signature file yourself. Generally you should use the SignatureFileContents value.
      

      - **SignatureFileContents** *(string) --* The actual text of the SIGNATURE file to be written to disk.
      

      - **WarningMessage** *(string) --* An optional message notifying you of non-fatal issues with the job, such as use of an incompatible Amazon S3 bucket name.
      

      - **ArtifactList** *(list) --* A collection of artifacts.
        

        - *(dict) --* A discrete item that contains the description and URL of an artifact (such as a PDF).
          

          - **Description** *(string) --* The associated description for this object.
          

          - **URL** *(string) --* The URL for a given Artifact.
      
    
  
  **Exceptions**
  
  *   :py:class:`ImportExport.Client.exceptions.MissingParameterException`

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

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidAccessKeyIdException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidAddressException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidManifestFieldException`

  
  *   :py:class:`ImportExport.Client.exceptions.MissingManifestFieldException`

  
  *   :py:class:`ImportExport.Client.exceptions.NoSuchBucketException`

  
  *   :py:class:`ImportExport.Client.exceptions.MissingCustomsException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidCustomsException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidFileSystemException`

  
  *   :py:class:`ImportExport.Client.exceptions.MultipleRegionsException`

  
  *   :py:class:`ImportExport.Client.exceptions.BucketPermissionException`

  
  *   :py:class:`ImportExport.Client.exceptions.MalformedManifestException`

  
  *   :py:class:`ImportExport.Client.exceptions.CreateJobQuotaExceededException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidJobIdException`

  
  *   :py:class:`ImportExport.Client.exceptions.InvalidVersionException`

  