For samples that show how to call instances.retrieveInstance, see Retrieve an instance.
HTTP request
GET https://healthcare.googleapis.com/v1beta1/{parent=projects/*/locations/*/datasets/*/dicomStores/*}/dicomWeb/{dicomWebPath=studies/*/series/*/instances/*}
Required. The name of the DICOM store that is being accessed. For example, projects/{projectId}/locations/{locationId}/datasets/{datasetId}/dicomStores/{dicomStoreId}.
Authorization requires the following IAM permission on the specified resource parent:
healthcare.dicomStores.dicomWebRead
dicomWebPath
string
Required. The path of the instances.retrieveInstance DICOMweb request. For example, studies/{studyUid}/series/{seriesUid}/instances/{instanceUid}.
Request body
The request body must be empty.
Response body
If successful, the response is a generic HTTP response whose format is defined by the method.
[[["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-01-28 UTC."],[[["`instances.retrieveInstance` allows the retrieval of a specific DICOM instance using its associated study, series, and SOP Instance UID."],["The method uses a `GET` request to a specific URL endpoint that includes path parameters for the DICOM store and the DICOMweb path (study, series, and instance UIDs)."],["The request requires the `healthcare.dicomStores.dicomWebRead` IAM permission on the specified DICOM store resource, and the request body must be empty."],["Successful responses follow a generic HTTP format defined by the method, and authorization requires either the `https://www.googleapis.com/auth/cloud-healthcare` or `https://www.googleapis.com/auth/cloud-platform` OAuth scope."]]],[]]