Honeycode / Client / describe_table_data_import_job

describe_table_data_import_job#

Honeycode.Client.describe_table_data_import_job(**kwargs)#

The DescribeTableDataImportJob API allows you to retrieve the status and details of a table data import job.

See also: AWS API Documentation

Request Syntax

response = client.describe_table_data_import_job(
    workbookId='string',
    tableId='string',
    jobId='string'
)
Parameters:
  • workbookId (string) –

    [REQUIRED]

    The ID of the workbook into which data was imported.

    If a workbook with the specified id could not be found, this API throws ResourceNotFoundException.

  • tableId (string) –

    [REQUIRED]

    The ID of the table into which data was imported.

    If a table with the specified id could not be found, this API throws ResourceNotFoundException.

  • jobId (string) –

    [REQUIRED]

    The ID of the job that was returned by the StartTableDataImportJob request.

    If a job with the specified id could not be found, this API throws ResourceNotFoundException.

Return type:

dict

Returns:

Response Syntax

{
    'jobStatus': 'SUBMITTED'|'IN_PROGRESS'|'COMPLETED'|'FAILED',
    'message': 'string',
    'jobMetadata': {
        'submitter': {
            'email': 'string',
            'userArn': 'string'
        },
        'submitTime': datetime(2015, 1, 1),
        'importOptions': {
            'destinationOptions': {
                'columnMap': {
                    'string': {
                        'columnIndex': 123
                    }
                }
            },
            'delimitedTextOptions': {
                'delimiter': 'string',
                'hasHeaderRow': True|False,
                'ignoreEmptyRows': True|False,
                'dataCharacterEncoding': 'UTF-8'|'US-ASCII'|'ISO-8859-1'|'UTF-16BE'|'UTF-16LE'|'UTF-16'
            }
        },
        'dataSource': {
            'dataSourceConfig': {
                'dataSourceUrl': 'string'
            }
        }
    },
    'errorCode': 'ACCESS_DENIED'|'INVALID_URL_ERROR'|'INVALID_IMPORT_OPTIONS_ERROR'|'INVALID_TABLE_ID_ERROR'|'INVALID_TABLE_COLUMN_ID_ERROR'|'TABLE_NOT_FOUND_ERROR'|'FILE_EMPTY_ERROR'|'INVALID_FILE_TYPE_ERROR'|'FILE_PARSING_ERROR'|'FILE_SIZE_LIMIT_ERROR'|'FILE_NOT_FOUND_ERROR'|'UNKNOWN_ERROR'|'RESOURCE_NOT_FOUND_ERROR'|'SYSTEM_LIMIT_ERROR'
}

Response Structure

  • (dict) –

    • jobStatus (string) –

      The current status of the import job.

    • message (string) –

      A message providing more details about the current status of the import job.

    • jobMetadata (dict) –

      The metadata about the job that was submitted for import.

      • submitter (dict) –

        Details about the submitter of the import request.

        • email (string) –

          The email id of the submitter of the import job, if available.

        • userArn (string) –

          The AWS user ARN of the submitter of the import job, if available.

      • submitTime (datetime) –

        The timestamp when the job was submitted for import.

      • importOptions (dict) –

        The options that was specified at the time of submitting the import request.

        • destinationOptions (dict) –

          Options relating to the destination of the import request.

          • columnMap (dict) –

            A map of the column id to the import properties for each column.

            • (string) –

              • (dict) –

                An object that contains the properties for importing data to a specific column in a table.

                • columnIndex (integer) –

                  The index of the column in the input file.

        • delimitedTextOptions (dict) –

          Options relating to parsing delimited text. Required if dataFormat is DELIMITED_TEXT.

          • delimiter (string) –

            The delimiter to use for separating columns in a single row of the input.

          • hasHeaderRow (boolean) –

            Indicates whether the input file has a header row at the top containing the column names.

          • ignoreEmptyRows (boolean) –

            A parameter to indicate whether empty rows should be ignored or be included in the import.

          • dataCharacterEncoding (string) –

            The encoding of the data in the input file.

      • dataSource (dict) –

        The source of the data that was submitted for import.

        • dataSourceConfig (dict) –

          The configuration parameters for the data source of the import

          • dataSourceUrl (string) –

            The URL from which source data will be downloaded for the import request.

    • errorCode (string) –

      If job status is failed, error code to understand reason for the failure.

Exceptions

  • Honeycode.Client.exceptions.AccessDeniedException

  • Honeycode.Client.exceptions.InternalServerException

  • Honeycode.Client.exceptions.ResourceNotFoundException

  • Honeycode.Client.exceptions.ServiceUnavailableException

  • Honeycode.Client.exceptions.ThrottlingException

  • Honeycode.Client.exceptions.ValidationException

  • Honeycode.Client.exceptions.RequestTimeoutException