Google Cloud Platform uses regions, subdivided into zones, to define the geographic location of physical computing resources.
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.
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:
|Region name||Region description|
||Los Angeles, USA|
|Multi-region name||Multi-region description|
||Data centers in the United States|
When you choose a location for your data, you might want to consider factors such as:
- Regulatory requirements about where to store your data
- 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:
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.
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.
Export the data from your DICOM stores to a regional or multi-regional Cloud Storage bucket.
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.
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:
- Write the contents of the HL7v2 messages in your HL7v2 stores to a file.
- 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.