Navigation

Table Of Contents

  1. Docs
  2. Available services
  3. HealthLake

HealthLake

Table of Contents

Client

class HealthLake.Client

A low-level client representing Amazon HealthLake

Amazon HealthLake is a HIPAA eligibile service that allows customers to store, transform, query, and analyze their data in a consistent fashion in the cloud.

import boto3

client = boto3.client('healthlake')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_fhir_datastore(**kwargs)

Creates a datastore that can ingest and export FHIR data.

See also: AWS API Documentation

Request Syntax

response = client.create_fhir_datastore(
    DatastoreName='string',
    DatastoreTypeVersion='R4',
    PreloadDataConfig={
        'PreloadDataType': 'SYNTHEA'
    },
    ClientToken='string'
)
Parameters
  • DatastoreName (string) -- The user generated name for the datastore.
  • DatastoreTypeVersion (string) --

    [REQUIRED]

    The FHIR version of the datastore. The only supported version is R4.

  • PreloadDataConfig (dict) --

    Optional parameter to preload data upon creation of the datastore. Currently, the only supported preloaded data is synthetic data generated from Synthea.

    • PreloadDataType (string) -- [REQUIRED]

      The type of preloaded data. Only Synthea preloaded data is supported.

  • ClientToken (string) --

    Optional user provided token used for ensuring idempotency.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'DatastoreId': 'string',
    'DatastoreArn': 'string',
    'DatastoreStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
    'DatastoreEndpoint': 'string'
}

Response Structure

  • (dict) --

    • DatastoreId (string) --

      The AWS-generated datastore id. This id is in the output from the initial datastore creation call.

    • DatastoreArn (string) --

      The datastore ARN is generated during the creation of the datastore and can be found in the output from the initial datastore creation call.

    • DatastoreStatus (string) --

      The status of the FHIR datastore. Possible statuses are ‘CREATING’, ‘ACTIVE’, ‘DELETING’, ‘DELETED’.

    • DatastoreEndpoint (string) --

      The AWS endpoint for the created datastore. For preview, only US-east-1 endpoints are supported.

Exceptions

  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.InternalServerException
delete_fhir_datastore(**kwargs)

Deletes a datastore.

See also: AWS API Documentation

Request Syntax

response = client.delete_fhir_datastore(
    DatastoreId='string'
)
Parameters
DatastoreId (string) -- The AWS-generated ID for the datastore to be deleted.
Return type
dict
Returns
Response Syntax
{
    'DatastoreId': 'string',
    'DatastoreArn': 'string',
    'DatastoreStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
    'DatastoreEndpoint': 'string'
}

Response Structure

  • (dict) --
    • DatastoreId (string) --

      The AWS-generated ID for the datastore to be deleted.

    • DatastoreArn (string) --

      The Amazon Resource Name (ARN) that gives Amazon HealthLake access permission.

    • DatastoreStatus (string) --

      The status of the datastore that the user has requested to be deleted.

    • DatastoreEndpoint (string) --

      The AWS endpoint for the datastore the user has requested to be deleted.

Exceptions

  • HealthLake.Client.exceptions.AccessDeniedException
  • HealthLake.Client.exceptions.ConflictException
  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ResourceNotFoundException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.InternalServerException
describe_fhir_datastore(**kwargs)

Gets the properties associated with the FHIR datastore, including the datastore ID, datastore ARN, datastore name, datastore status, created at, datastore type version, and datastore endpoint.

See also: AWS API Documentation

Request Syntax

response = client.describe_fhir_datastore(
    DatastoreId='string'
)
Parameters
DatastoreId (string) -- The AWS-generated datastore id. This is part of the ‘CreateFHIRDatastore’ output.
Return type
dict
Returns
Response Syntax
{
    'DatastoreProperties': {
        'DatastoreId': 'string',
        'DatastoreArn': 'string',
        'DatastoreName': 'string',
        'DatastoreStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
        'CreatedAt': datetime(2015, 1, 1),
        'DatastoreTypeVersion': 'R4',
        'DatastoreEndpoint': 'string',
        'PreloadDataConfig': {
            'PreloadDataType': 'SYNTHEA'
        }
    }
}

Response Structure

  • (dict) --
    • DatastoreProperties (dict) --

      All properties associated with a datastore, including the datastore ID, datastore ARN, datastore name, datastore status, created at, datastore type version, and datastore endpoint.

      • DatastoreId (string) --

        The AWS-generated ID number for the datastore.

      • DatastoreArn (string) --

        The Amazon Resource Name used in the creation of the datastore.

      • DatastoreName (string) --

        The user-generated name for the datastore.

      • DatastoreStatus (string) --

        The status of the datastore. Possible statuses are 'CREATING', 'ACTIVE', 'DELETING', or 'DELETED'.

      • CreatedAt (datetime) --

        The time that a datastore was created.

      • DatastoreTypeVersion (string) --

        The FHIR version. Only R4 version data is supported.

      • DatastoreEndpoint (string) --

        The AWS endpoint for the datastore. Each datastore will have it's own endpoint with datastore ID in the endpoint URL.

      • PreloadDataConfig (dict) --

        The preloaded data configuration for the datastore. Only data preloaded from Synthea is supported.

        • PreloadDataType (string) --

          The type of preloaded data. Only Synthea preloaded data is supported.

Exceptions

  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ResourceNotFoundException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.InternalServerException
describe_fhir_import_job(**kwargs)

Displays the properties of a FHIR import job, including the ID, ARN, name, and the status of the datastore.

See also: AWS API Documentation

Request Syntax

response = client.describe_fhir_import_job(
    DatastoreId='string',
    JobId='string'
)
Parameters
  • DatastoreId (string) --

    [REQUIRED]

    The AWS-generated ID of the datastore.

  • JobId (string) --

    [REQUIRED]

    The AWS-generated job ID.

Return type

dict

Returns

Response Syntax

{
    'ImportJobProperties': {
        'JobId': 'string',
        'JobName': 'string',
        'JobStatus': 'SUBMITTED'|'IN_PROGRESS'|'COMPLETED'|'FAILED',
        'SubmitTime': datetime(2015, 1, 1),
        'EndTime': datetime(2015, 1, 1),
        'DatastoreId': 'string',
        'InputDataConfig': {
            'S3Uri': 'string'
        },
        'DataAccessRoleArn': 'string',
        'Message': 'string'
    }
}

Response Structure

  • (dict) --

    • ImportJobProperties (dict) --

      The properties of the Import job request, including the ID, ARN, name, and the status of the datastore.

      • 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, 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.

        • S3Uri (string) --

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

      • DataAccessRoleArn (string) --

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

      • Message (string) --

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

Exceptions

  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ResourceNotFoundException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.InternalServerException
generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_fhir_datastores(**kwargs)

Lists all FHIR datastores that are in the user’s account, regardless of datastore status.

See also: AWS API Documentation

Request Syntax

response = client.list_fhir_datastores(
    Filter={
        'DatastoreName': 'string',
        'DatastoreStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
        'CreatedBefore': datetime(2015, 1, 1),
        'CreatedAfter': datetime(2015, 1, 1)
    },
    NextToken='string',
    MaxResults=123
)
Parameters
  • Filter (dict) --

    Lists all filters associated with a FHIR datastore request.

    • DatastoreName (string) --

      Allows the user to filter datastore results by name.

    • DatastoreStatus (string) --

      Allows the user to filter datastore results by status.

    • CreatedBefore (datetime) --

      A filter that allows the user to set cutoff dates for records. All datastores created before the specified date will be included in the results.

    • CreatedAfter (datetime) --

      A filter that allows the user to set cutoff dates for records. All datastores created after the specified date will be included in the results.

  • NextToken (string) -- Fetches the next page of datastores when results are paginated.
  • MaxResults (integer) -- The maximum number of datastores returned in a single page of a ListFHIRDatastoresRequest call.
Return type

dict

Returns

Response Syntax

{
    'DatastorePropertiesList': [
        {
            'DatastoreId': 'string',
            'DatastoreArn': 'string',
            'DatastoreName': 'string',
            'DatastoreStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED',
            'CreatedAt': datetime(2015, 1, 1),
            'DatastoreTypeVersion': 'R4',
            'DatastoreEndpoint': 'string',
            'PreloadDataConfig': {
                'PreloadDataType': 'SYNTHEA'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • DatastorePropertiesList (list) --

      All properties associated with the listed datastores.

      • (dict) --

        Displays the properties of the datastore, including the ID, Arn, name, and the status of the datastore.

        • DatastoreId (string) --

          The AWS-generated ID number for the datastore.

        • DatastoreArn (string) --

          The Amazon Resource Name used in the creation of the datastore.

        • DatastoreName (string) --

          The user-generated name for the datastore.

        • DatastoreStatus (string) --

          The status of the datastore. Possible statuses are 'CREATING', 'ACTIVE', 'DELETING', or 'DELETED'.

        • CreatedAt (datetime) --

          The time that a datastore was created.

        • DatastoreTypeVersion (string) --

          The FHIR version. Only R4 version data is supported.

        • DatastoreEndpoint (string) --

          The AWS endpoint for the datastore. Each datastore will have it's own endpoint with datastore ID in the endpoint URL.

        • PreloadDataConfig (dict) --

          The preloaded data configuration for the datastore. Only data preloaded from Synthea is supported.

          • PreloadDataType (string) --

            The type of preloaded data. Only Synthea preloaded data is supported.

    • NextToken (string) --

      Pagination token that can be used to retrieve the next page of results.

Exceptions

  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.InternalServerException
start_fhir_import_job(**kwargs)

Begins a FHIR Import job.

See also: AWS API Documentation

Request Syntax

response = client.start_fhir_import_job(
    JobName='string',
    InputDataConfig={
        'S3Uri': 'string'
    },
    DatastoreId='string',
    DataAccessRoleArn='string',
    ClientToken='string'
)
Parameters
  • JobName (string) -- The name of the FHIR Import job in the StartFHIRImport job request.
  • InputDataConfig (dict) --

    [REQUIRED]

    The input properties of the FHIR Import job in the StartFHIRImport job request.

    • S3Uri (string) --

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

  • DatastoreId (string) --

    [REQUIRED]

    The AWS-generated datastore ID.

  • DataAccessRoleArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) that gives Amazon HealthLake access permission.

  • ClientToken (string) --

    [REQUIRED]

    Optional user provided token used for ensuring idempotency.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'JobId': 'string',
    'JobStatus': 'SUBMITTED'|'IN_PROGRESS'|'COMPLETED'|'FAILED',
    'DatastoreId': 'string'
}

Response Structure

  • (dict) --

    • JobId (string) --

      The AWS-generated job ID.

    • JobStatus (string) --

      The status of an import job.

    • DatastoreId (string) --

      The AWS-generated datastore ID.

Exceptions

  • HealthLake.Client.exceptions.ValidationException
  • HealthLake.Client.exceptions.ThrottlingException
  • HealthLake.Client.exceptions.AccessDeniedException
  • HealthLake.Client.exceptions.ResourceNotFoundException
  • HealthLake.Client.exceptions.InternalServerException

Paginators

The available paginators are:

Health
Honeycode

Navigation

Privacy | Site Terms | Cookie preferences | © Copyright 2020, Amazon Web Services, Inc. Created using Sphinx.