Regions

Google Cloud Platform uses regions, subdivided into zones, to define the geographic location of physical computing resources.

Key concepts

You specify a location for storing your Cloud Healthcare API data when you create a dataset. After you create the dataset, the location cannot be changed. Data within the dataset is stored at rest in the chosen location.

The location is tied to the dataset's identity and is a permanent part of the dataset's resource name. All data stores within the dataset are assigned to the same region as the dataset.

There are two types of locations:

  • A regional location is a specific geographic place, such as Tokyo. For more information, see Regional resources on the Geography and Regions page.

  • A multi-regional location is a large geographic area, such as the United States, that contains at least two regional locations. For more information, see Multi-regional resources on the Geography and Regions page.

Available regions

The Cloud Healthcare API supports a subset of the full list of Google Cloud Platform locations.

The Cloud Healthcare API is available in the following regions:

Regional locations

Region name Region description
North America
us-central1 Iowa, USA
us-west2 Los Angeles, USA
northamerica-northeast1 Montréal, Canada
Europe
europe-west2 London, UK
europe-west4 Netherlands
Asia
asia-southeast1 Singapore
asia-northeast1 Tokyo, Japan

Multi-regional locations

Multi-region name Multi-region description
us Data centers in the United States

Location considerations

When you choose a location for your data, you might want to consider factors such as:

  • Regulatory requirements about where to store your data
  • Latency
  • Resiliency
  • Cost
  • Colocation with other GCP services

For example, Google manages multi-regional locations to be redundant and distributed within and across regions. These services optimize availability, performance, and resource efficiency. As a result, these services require a trade-off on either latency or the consistency model.

Consider doing the following when choosing a location for your data:

  • Colocate your dataset and your external data source.

  • Colocate your dataset with your Cloud Storage buckets when importing data.

  • Colocate your dataset with your Cloud Storage buckets and BigQuery datasets when exporting data.

Moving Cloud Healthcare API data between locations

You cannot change the location of a dataset after it is created. Also, you cannot move a dataset from one location to another. If you need to move data from one location to another, complete one of the following processes:

FHIR data

  1. Export the data from your FHIR stores to a regional or multi-regional Cloud Storage bucket. When you export the data, the operation only exports the current version of each resource. The operation does not export version history; there is no bulk export operation for version history.

    Note that there are charges for exporting FHIR data to Cloud Storage. You also incur charges for storing the exported data in Cloud Storage.

  2. After you transfer the data to a Cloud Storage bucket, create a new dataset in the new location. Create any FHIR stores in the new dataset that you require for storing your data. Then, import your data from Cloud Storage into the new FHIR stores.

    Note that there are charges for importing FHIR data into the Cloud Healthcare API.

DICOM data

  1. Export the data from your DICOM stores to a regional or multi-regional Cloud Storage bucket.

    Note that there are charges for exporting DICOM data to Cloud Storage. You also incur charges for storing the exported data in Cloud Storage.

  2. After you transfer the data to a Cloud Storage bucket, create a new dataset in the new location. Create any DICOM stores in the new dataset that you require for storing your data. Then, import your data from Cloud Storage into the new DICOM stores.

    Note that there are charges for importing DICOM data into the Cloud Healthcare API.

HL7v2 data

Unlike FHIR and DICOM, there are no import and export operations available for HL7v2 data. Instead, we recommend that you get the contents of your HL7v2 messages and write them to a new HL7v2 store in the new dataset location. To do so, complete the following steps:

  1. Write the contents of the HL7v2 messages in your HL7v2 stores to a file.
  2. Create a new dataset in your new location. Create any HL7v2 stores in the new dataset that you require for storing your data. Then, create the messages one at a time from the saved file and store them in the new HL7v2 store.
Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Healthcare API