retrieveFrames method

Future<HttpBody> retrieveFrames(
  1. String parent,
  2. String dicomWebPath, {
  3. String? $fields,
})

RetrieveFrames returns instances associated with the given study, series, SOP Instance UID and frame numbers.

See [RetrieveTransaction](http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4}. For details on the implementation of RetrieveFrames, see DICOM frames in the Cloud Healthcare API conformance statement. For samples that show how to call RetrieveFrames, see Retrieve DICOM data.

Request parameters:

parent - Required. The name of the DICOM store that is being accessed. For example, projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}. Value must have pattern ^projects/\[^/\]+/locations/\[^/\]+/datasets/\[^/\]+/dicomStores/\[^/\]+$.

dicomWebPath - Required. The path of the RetrieveFrames DICOMweb request. For example, studies/{study_uid}/series/{series_uid}/instances/{instance_uid}/frames/{frame_list}. Value must have pattern ^studies/\[^/\]+/series/\[^/\]+/instances/\[^/\]+/frames/\[^/\]+$.

$fields - Selector specifying which fields to include in a partial response.

Completes with a HttpBody.

Completes with a commons.ApiRequestError if the API endpoint returned an error.

If the used http.Client completes with an error when making a REST call, this method will complete with the same error.

Implementation

async.Future<HttpBody> retrieveFrames(
  core.String parent,
  core.String dicomWebPath, {
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    if ($fields != null) 'fields': [$fields],
  };

  final url_ = 'v1/' +
      core.Uri.encodeFull('$parent') +
      '/dicomWeb/' +
      core.Uri.encodeFull('$dicomWebPath');

  final response_ = await _requester.request(
    url_,
    'GET',
    queryParams: queryParams_,
  );
  return HttpBody.fromJson(response_ as core.Map<core.String, core.dynamic>);
}