Updating a FHIR resource - AWS HealthLake
Conditional update

Updating a FHIR resource

The FHIR update interaction creates a new current version for an existing resource or creates an initial version if no resource already exists for the given id. For additional information, see update in the FHIR R4 RESTful API documentation.

To update a FHIR resource

  1. Collect HealthLake region and datastoreId values. For more information, see Getting data store properties.

  2. Determine the type of FHIR Resource to update and collect the associated id value. For more information, see Resource types.

  3. Construct a URL for the request using the collected values for HealthLake region and datastoreId. Also include the FHIR Resource type and its associated id. To view the entire URL path in the following example, scroll over the Copy button.

    PUT https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/id

  4. Construct a JSON body for the request, specifying the FHIR data updates to be made. For the purpose of this procedure, save the file as update-patient.json.

    {
    "id": "2de04858-ba65-44c1-8af1-f2fe69a977d9",
    "resourceType": "Patient",
    "active": true,
    "name": [
        {
            "use": "official",
            "family": "Doe",
            "given": [
                "Jane"
            ]
        },
        {
            "use": "usual",
            "given": [
                "Jane"
            ]
        }
    ],
    "gender": "female",
    "birthDate": "1985-12-31"
}

  5. Send the request. The FHIR update interaction uses a PUT request with either AWS Signature Version 4 or SMART on FHIR authorization. The following curl example updates a Patient resource in HealthLake. To view the entire example, scroll over the Copy button.

    curl

    SigV4 authorization

    curl --request PUT \
  'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient/id \
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
  --header 'Accept: application/json' \
  --data @update-patient.json

    Your request will return a 200 HTTP status code if an existing resource is updated or a 201 HTTP status code if a new resource is created.

    AWS Console

    1. Sign in to the Run query page on the HealthLake Console.

    2. Under the Query settings section, make the following selections.

    • Data Store ID — choose a data store ID to generate a query string.

    • Query type — choose Update (PUT).

    • Resource type — choose the FHIR resource type to update or create.

    • Request body — construct a JSON body for the request, specifying the FHIR data to update the resource with.

    3. Choose Run query.

Updating FHIR resources based on conditions

Conditional update allows you to update an existing resource based on some identification search criteria, rather than by logical FHIR id. When the server processes the update, it performs a search using its standard search capabilities for the resource type, with the goal of resolving a single logical id for the request.

The action the server takes depends on how many matches it finds:

  • No matches, no id provided in the request body: The server creates the FHIR resource.

  • No matches, id provided and resource doesn't already exist with the id: The server treats the interaction as an Update as Create interaction.

  • No matches, id provided and already exist: The server rejects the update with a 409 Conflict error.

  • One Match, no resource id provided OR (resource id provided and it matches the found resource): The server performs the update against the matching resource as above where, if the resource was updated, the server SHALL return a 200 OK.

  • One Match, resource id provided but does not match resource found: The server returns a 409 Conflict error indicating the client id specification was a problem preferably with an OperationOutcome

  • Multiple matches: The server returns a 412 Precondition Failed error indicating the client's criteria were not selective enough preferably with an OperationOutcome

The following example updates a Patient resource whose name is peter, birthdate is 1st Jan 2000, and phone number is 1234567890.

PUT https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?name=peter&birthdate=2000-01-01&phone=1234567890