IoTSiteWise / Client / describe_bulk_import_job

describe_bulk_import_job#

IoTSiteWise.Client.describe_bulk_import_job(**kwargs)#

Retrieves information about a bulk import job request. For more information, see Describe a bulk import job (CLI) in the Amazon Simple Storage Service User Guide.

See also: AWS API Documentation

Request Syntax

response = client.describe_bulk_import_job(
    jobId='string'
)
Parameters:

jobId (string) –

[REQUIRED]

The ID of the job.

Return type:

dict

Returns:

Response Syntax

{
    'jobId': 'string',
    'jobName': 'string',
    'jobStatus': 'PENDING'|'CANCELLED'|'RUNNING'|'COMPLETED'|'FAILED'|'COMPLETED_WITH_FAILURES',
    'jobRoleArn': 'string',
    'files': [
        {
            'bucket': 'string',
            'key': 'string',
            'versionId': 'string'
        },
    ],
    'errorReportLocation': {
        'bucket': 'string',
        'prefix': 'string'
    },
    'jobConfiguration': {
        'fileFormat': {
            'csv': {
                'columnNames': [
                    'ALIAS'|'ASSET_ID'|'PROPERTY_ID'|'DATA_TYPE'|'TIMESTAMP_SECONDS'|'TIMESTAMP_NANO_OFFSET'|'QUALITY'|'VALUE',
                ]
            }
        }
    },
    'jobCreationDate': datetime(2015, 1, 1),
    'jobLastUpdateDate': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • jobId (string) –

      The ID of the job.

    • jobName (string) –

      The unique name that helps identify the job request.

    • jobStatus (string) –

      The status of the bulk import job can be one of following values.

      • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.

      • CANCELLED – The bulk import job has been canceled.

      • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.

      • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.

      • FAILED – IoT SiteWise couldn’t process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

      • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

    • jobRoleArn (string) –

      The ARN of the IAM role that allows IoT SiteWise to read Amazon S3 data.

    • files (list) –

      The files in the specified Amazon S3 bucket that contain your data.

      • (dict) –

        The file in Amazon S3 where your data is saved.

        • bucket (string) –

          The name of the Amazon S3 bucket from which data is imported.

        • key (string) –

          The key of the Amazon S3 object that contains your data. Each object has a key that is a unique identifier. Each object has exactly one key.

        • versionId (string) –

          The version ID to identify a specific version of the Amazon S3 object that contains your data.

    • errorReportLocation (dict) –

      The Amazon S3 destination where errors associated with the job creation request are saved.

      • bucket (string) –

        The name of the Amazon S3 bucket to which errors associated with the bulk import job are sent.

      • prefix (string) –

        Amazon S3 uses the prefix as a folder name to organize data in the bucket. Each Amazon S3 object has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/). For more information, see Organizing objects using prefixes in the Amazon Simple Storage Service User Guide.

    • jobConfiguration (dict) –

      Contains the configuration information of a job, such as the file format used to save data in Amazon S3.

      • fileFormat (dict) –

        The file format of the data in Amazon S3.

        • csv (dict) –

          The .csv file format.

          • columnNames (list) –

            The column names specified in the .csv file.

            • (string) –

    • jobCreationDate (datetime) –

      The date the job was created, in Unix epoch TIME.

    • jobLastUpdateDate (datetime) –

      The date the job was last updated, in Unix epoch time.

Exceptions

  • IoTSiteWise.Client.exceptions.InvalidRequestException

  • IoTSiteWise.Client.exceptions.ResourceNotFoundException

  • IoTSiteWise.Client.exceptions.InternalFailureException

  • IoTSiteWise.Client.exceptions.ThrottlingException