Stay organized with collections
Save and categorize content based on your preferences.
Full name: projects.locations.datasets.deidentify
Creates a new dataset containing de-identified data from the source dataset. The metadata field type is OperationMetadata. If the request is successful, the response field type is DeidentifySummary. If errors occur, error is set. The LRO result may still be successful if de-identification fails for some DICOM instances. The new de-identified dataset will not contain these failed resources. Failed resource totals are tracked in Operation.metadata. Error details are also logged to Cloud Logging. For more information, see Viewing error logs in Cloud Logging.
HTTP request
POST https://healthcare.googleapis.com/v1/{sourceDataset=projects/*/locations/*/datasets/*}:deidentify
Deidentify configuration. Only one of config and gcsConfigUri can be specified.
gcsConfigUri
string
Cloud Storage location to read the JSON cloud.healthcare.deidentify.DeidentifyConfig from, overriding the default config. Must be of the form gs://{bucket_id}/path/to/object. The Cloud Storage location must grant the Cloud IAM role roles/storage.objectViewer to the project's Cloud Healthcare Service Agent service account. Only one of config and gcsConfigUri can be specified.
Response body
If successful, the response body contains an instance of Operation.
[[["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-07-23 UTC."],[[["\u003cp\u003eThis operation creates a new dataset with de-identified data from a specified source dataset.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the source dataset's resource name and specifies a destination dataset that must be new and in the same location.\u003c/p\u003e\n"],["\u003cp\u003eDe-identification can be configured either directly in the request body or by referencing a configuration file in Google Cloud Storage.\u003c/p\u003e\n"],["\u003cp\u003eThe operation may result in some DICOM instances failing de-identification, which are not included in the new dataset and are tracked in the operation's metadata.\u003c/p\u003e\n"],["\u003cp\u003eThe response from this operation will contain an instance of \u003ccode\u003eOperation\u003c/code\u003e, and success is defined by the response field \u003ccode\u003eDeidentifySummary\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: datasets.deidentify\n\n**Full name**: projects.locations.datasets.deidentify\n\nCreates a new dataset containing de-identified data from the source dataset. The [metadata](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.metadata) field type is [OperationMetadata](/healthcare-api/docs/reference/rest/v1/OperationMetadata). If the request is successful, the [response](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.response) field type is [DeidentifySummary](/healthcare-api/docs/reference/rest/Shared.Types/DeidentifySummary). If errors occur, [error](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.error) is set. The LRO result may still be successful if de-identification fails for some DICOM instances. The new de-identified dataset will not contain these failed resources. Failed resource totals are tracked in [Operation.metadata](/healthcare-api/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.metadata). Error details are also logged to Cloud Logging. For more information, see [Viewing error logs in Cloud Logging](https://cloud.google.com/healthcare/docs/how-tos/logging).\n\n### HTTP request\n\n`POST https://healthcare.googleapis.com/v1/{sourceDataset=projects/*/locations/*/datasets/*}:deidentify`\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)."]]