Method: dicomStores.deidentify

Full name: projects.locations.datasets.dicomStores.deidentify

De-identifies data from the source store and writes it to the destination store. The metadata field type is OperationMetadata. If the request is successful, the response field type is DeidentifyDicomStoreSummary. The LRO result may still be successful if de-identification fails for some DICOM instances. The output DICOM store will not contain these failed resources. The number of resources processed are tracked in Operation.metadata. Error details are logged to Cloud Logging. For more information, see Viewing logs.

HTTP request

POST https://healthcare.googleapis.com/v1beta1/{sourceStore=projects/*/locations/*/datasets/*/dicomStores/*}:deidentify

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
sourceStore

string

Source DICOM store resource name. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.

Request body

The request body contains data with the following structure:

JSON representation
{
  "destinationStore": string,
  "config": {
    object(DeidentifyConfig)
  },
  "filterConfig": {
    object(DicomFilterConfig)
  }
}
Fields
destinationStore

string

The name of the DICOM store to create and write the redacted data to. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.

  • The destination dataset must exist.
  • The source dataset and destination dataset must both reside in the same project. De-identifying data across multiple projects is not supported.
  • The destination DICOM store must not exist.
  • The caller must have the necessary permissions to create the destination DICOM store.
config

object(DeidentifyConfig)

De-identify configuration.

filterConfig

object(DicomFilterConfig)

Filter configuration.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-healthcare
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DicomFilterConfig

Specifies the filter configuration for DICOM resources.

JSON representation
{
  "resourcePathsGcsUri": string
}
Fields
resourcePathsGcsUri

string

The Cloud Storage location of the filter configuration file. The gcsUri must be in the format gs://bucket/path/to/object. The filter configuration file must contain a list of resource paths separated by newline characters (\n or \r\n). Each resource path must be in the format "/studies/{studyUID}[/series/{seriesUID}[/instances/{instanceUID}]]"

The Cloud Healthcare API service account must have the roles/storage.objectViewer Cloud IAM role for this Cloud Storage location.