HealthLake / Client / list_fhir_import_jobs

list_fhir_import_jobs#

HealthLake.Client.list_fhir_import_jobs(**kwargs)#

Lists all FHIR import jobs associated with an account and their statuses.

See also: AWS API Documentation

Request Syntax

response = client.list_fhir_import_jobs(
    DatastoreId='string',
    NextToken='string',
    MaxResults=123,
    JobName='string',
    JobStatus='SUBMITTED'|'IN_PROGRESS'|'COMPLETED_WITH_ERRORS'|'COMPLETED'|'FAILED'|'CANCEL_SUBMITTED'|'CANCEL_IN_PROGRESS'|'CANCEL_COMPLETED'|'CANCEL_FAILED',
    SubmittedBefore=datetime(2015, 1, 1),
    SubmittedAfter=datetime(2015, 1, 1)
)
Parameters:
  • DatastoreId (string) –

    [REQUIRED]

    This parameter limits the response to the import job with the specified data store ID.

  • NextToken (string) – A pagination token used to identify the next page of results to return for a ListFHIRImportJobs query.

  • MaxResults (integer) – This parameter limits the number of results returned for a ListFHIRImportJobs to a maximum quantity specified by the user.

  • JobName (string) – This parameter limits the response to the import job with the specified job name.

  • JobStatus (string) – This parameter limits the response to the import job with the specified job status.

  • SubmittedBefore (datetime) – This parameter limits the response to FHIR import jobs submitted before a user specified date.

  • SubmittedAfter (datetime) – This parameter limits the response to FHIR import jobs submitted after a user specified date.

Return type:

dict

Returns:

Response Syntax

{
    'ImportJobPropertiesList': [
        {
            'JobId': 'string',
            'JobName': 'string',
            'JobStatus': 'SUBMITTED'|'IN_PROGRESS'|'COMPLETED_WITH_ERRORS'|'COMPLETED'|'FAILED'|'CANCEL_SUBMITTED'|'CANCEL_IN_PROGRESS'|'CANCEL_COMPLETED'|'CANCEL_FAILED',
            'SubmitTime': datetime(2015, 1, 1),
            'EndTime': datetime(2015, 1, 1),
            'DatastoreId': 'string',
            'InputDataConfig': {
                'S3Uri': 'string'
            },
            'JobOutputDataConfig': {
                'S3Configuration': {
                    'S3Uri': 'string',
                    'KmsKeyId': 'string'
                }
            },
            'JobProgressReport': {
                'TotalNumberOfScannedFiles': 123,
                'TotalSizeOfScannedFilesInMB': 123.0,
                'TotalNumberOfImportedFiles': 123,
                'TotalNumberOfResourcesScanned': 123,
                'TotalNumberOfResourcesImported': 123,
                'TotalNumberOfResourcesWithCustomerError': 123,
                'TotalNumberOfFilesReadWithCustomerError': 123,
                'Throughput': 123.0
            },
            'DataAccessRoleArn': 'string',
            'Message': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • ImportJobPropertiesList (list) –

      The properties of a listed FHIR import jobs, including the ID, ARN, name, the status of the job, and the progress report of the job.

      • (dict) –

        Displays the properties of the import job, including the ID, Arn, Name, the status of the job, and the progress report of the job.

        • JobId (string) –

          The AWS-generated id number for the Import job.

        • JobName (string) –

          The user-generated name for an Import job.

        • JobStatus (string) –

          The job status for an Import job. Possible statuses are SUBMITTED, IN_PROGRESS, COMPLETED_WITH_ERRORS, COMPLETED, FAILED.

        • SubmitTime (datetime) –

          The time that the Import job was submitted for processing.

        • EndTime (datetime) –

          The time that the Import job was completed.

        • DatastoreId (string) –

          The datastore id used when the Import job was created.

        • InputDataConfig (dict) –

          The input data configuration that was supplied when the Import job was created.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: S3Uri. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • S3Uri (string) –

            The S3Uri is the user specified S3 location of the FHIR data to be imported into AWS HealthLake.

        • JobOutputDataConfig (dict) –

          The output data configuration that was supplied when the export job was created.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: S3Configuration. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          
          • S3Configuration (dict) –

            The output data configuration that was supplied when the export job was created.

            • S3Uri (string) –

              The S3Uri is the user specified S3 location of the FHIR data to be imported into AWS HealthLake.

            • KmsKeyId (string) –

              The KMS key ID used to access the S3 bucket.

        • JobProgressReport (dict) –

          Displays the progress of the import job, including total resources scanned, total resources ingested, and total size of data ingested.

          • TotalNumberOfScannedFiles (integer) –

            The number of files scanned from input S3 bucket.

          • TotalSizeOfScannedFilesInMB (float) –

            The size (in MB) of the files scanned from the input S3 bucket.

          • TotalNumberOfImportedFiles (integer) –

            The number of files imported so far.

          • TotalNumberOfResourcesScanned (integer) –

            The number of resources scanned from the input S3 bucket.

          • TotalNumberOfResourcesImported (integer) –

            The number of resources imported so far.

          • TotalNumberOfResourcesWithCustomerError (integer) –

            The number of resources that failed due to customer error.

          • TotalNumberOfFilesReadWithCustomerError (integer) –

            The number of files that failed to be read from the input S3 bucket due to customer error.

          • Throughput (float) –

            The throughput (in MB/sec) of the import job.

        • DataAccessRoleArn (string) –

          The Amazon Resource Name (ARN) that gives AWS HealthLake access to your input data.

        • Message (string) –

          An explanation of any errors that may have occurred during the FHIR import job.

    • NextToken (string) –

      A pagination token used to identify the next page of results to return for a ListFHIRImportJobs query.

Exceptions

  • HealthLake.Client.exceptions.ValidationException

  • HealthLake.Client.exceptions.ResourceNotFoundException

  • HealthLake.Client.exceptions.AccessDeniedException

  • HealthLake.Client.exceptions.ThrottlingException

  • HealthLake.Client.exceptions.InternalServerException