Required. The name of the DICOM store resource into which the data is imported. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.
Authorization requires the following IAM permission on the specified resource name:
healthcare.dicomStores.import
Request body
The request body contains data with the following structure:
JSON representation
{"blobStorageSettings": {object(BlobStorageSettings)},// Union field source can be only one of the following:"gcsSource": {object(GcsSource)}// End of list of possible types for union field source.}
Optional. The blob storage settings for the data imported by this operation.
Union field source. Specifies the source data location and import configuration.
To enable the Cloud Healthcare API to read from resources in your project such as Cloud Storage, you must give the Cloud Healthcare API service account the proper permissions. The service account is: service-{PROJECT_NUMBER}@gcp-sa-healthcare.iam.gserviceaccount.com. The PROJECT_NUMBER identifies the project that the DICOM store resides in. To get the project number, go to the Cloud Console Dashboard. source can be only one of the following:
Specifies the configuration for importing data from Cloud Storage.
JSON representation
{"uri": string}
Fields
uri
string
Points to a Cloud Storage URI containing file(s) with content only.
The URI must be in the following format: gs://{bucket_id}/{objectId}. The URI can include wildcards in objectId and thus identify multiple files. Supported wildcards:
'*' to match 0 or more non-separator characters
'**' to match 0 or more characters (including separators). Must be used at the end of a path and with no other wildcards in the path. Can also be used with a file extension (such as .dcm), which imports all files with the extension in the specified directory and its sub-directories. For example, gs://my-bucket/my-directory/**.dcm imports all files with .dcm extensions in my-directory/ and its sub-directories.
'?' to match 1 character.
All other URI formats are invalid. Files matching the wildcard are expected to contain content only, no metadata.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis operation imports data into a specified DICOM store by copying it from a designated source, with any errors being logged to Cloud Logging.\u003c/p\u003e\n"],["\u003cp\u003eThe data source can be configured using BlobStorageSettings, with a GcsSource option available for importing data from Cloud Storage, requiring specific IAM roles.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the DICOM store's name in the format \u003ccode\u003eprojects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}\u003c/code\u003e, and appropriate authorization, such as \u003ccode\u003ehealthcare.dicomStores.import\u003c/code\u003e, is necessary.\u003c/p\u003e\n"],["\u003cp\u003eWhen using Cloud Storage as the data source (GcsSource), the URI must follow the format \u003ccode\u003egs://{bucket_id}/{objectId}\u003c/code\u003e and can include wildcards to match multiple files.\u003c/p\u003e\n"],["\u003cp\u003eThe operation returns a response body of type Operation, and requires one of the following OAuth scopes: \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-healthcare\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: dicomStores.import\n\n**Full name**: projects.locations.datasets.dicomStores.import\n\nImports data into the DICOM store by copying it from the specified source. Errors are logged to Cloud Logging. For more information, see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging). The [metadata](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.metadata) field type is [OperationMetadata](/healthcare-api/docs/reference/rest/v1/OperationMetadata).\n\n### HTTP request\n\n`POST https://healthcare.googleapis.com/v1/{name=projects/*/locations/*/datasets/*/dicomStores/*}:import`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-healthcare`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nGcsSource\n---------\n\nSpecifies the configuration for importing data from Cloud Storage."]]
