# Cloud Healthcare API . projects . locations . datasets . dicomStores . dicomWeb . studies . series . instances . frames

## Instance Methods

RetrieveRenderedFrames returns instances associated with the given study,

RetrieveFrames returns instances associated with the given study, series,

### Method Details

`rendered(parent, dicomWebPath, x__xgafv=None)`

    RetrieveRenderedFrames returns instances associated with the given study,
    series, SOP Instance UID and frame numbers in an acceptable Rendered Media
    Type. See
    http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.

    Args:
      parent: string, The name of the DICOM store that is being accessed (e.g.,
    `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`). (required)
      dicomWebPath: string, The path of the RetrieveRenderedFrames DICOMweb request (e.g.,
    `studies/{study_id}/series/{series_id}/instances/{instance_id}/frames/{frame_list}/rendered`). (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Message that represents an arbitrary HTTP body. It should only be used for
          # payload formats that can't be represented as JSON, such as raw binary or
          # an HTML page.
          #
          #
          # This message can be used both in streaming and non-streaming API methods in
          # the request as well as the response.
          #
          # It can be used as a top-level request field, which is convenient if one
          # wants to extract parameters from either the URL or HTTP template into the
          # request fields and also want access to the raw HTTP body.
          #
          # Example:
          #
          #     message GetResourceRequest {
          #       // A unique request id.
          #       string request_id = 1;
          #
          #       // The raw HTTP body is bound to this field.
          #       google.api.HttpBody http_body = 2;
          #     }
          #
          #     service ResourceService {
          #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
          #       rpc UpdateResource(google.api.HttpBody) returns
          #       (google.protobuf.Empty);
          #     }
          #
          # Example with streaming methods:
          #
          #     service CaldavService {
          #       rpc GetCalendar(stream google.api.HttpBody)
          #         returns (stream google.api.HttpBody);
          #       rpc UpdateCalendar(stream google.api.HttpBody)
          #         returns (stream google.api.HttpBody);
          #     }
          #
          # Use of this type only changes how the request and response bodies are
          # handled, all other features will continue to work unchanged.
        "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
        "data": "A String", # The HTTP request/response body as raw binary.
        "extensions": [ # Application specific response metadata. Must be set in the first response
            # for streaming APIs.
          {
            "a_key": "", # Properties of the object. Contains field @type with type URL.
          },
        ],
      }

`retrieveFrames(parent, dicomWebPath, x__xgafv=None)`

    RetrieveFrames returns instances associated with the given study, series,
    SOP Instance UID and frame numbers. See
    http://dicom.nema.org/medical/dicom/current/output/html/part18.html#sect_10.4.

    Args:
      parent: string, The name of the DICOM store that is being accessed (e.g.,
    `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}/dicomStores/{dicom_store_id}`). (required)
      dicomWebPath: string, The path of the RetrieveFrames DICOMweb request (e.g.,
    `studies/{study_id}/series/{series_id}/instances/{instance_id}/frames/{frame_list}`). (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Message that represents an arbitrary HTTP body. It should only be used for
          # payload formats that can't be represented as JSON, such as raw binary or
          # an HTML page.
          #
          #
          # This message can be used both in streaming and non-streaming API methods in
          # the request as well as the response.
          #
          # It can be used as a top-level request field, which is convenient if one
          # wants to extract parameters from either the URL or HTTP template into the
          # request fields and also want access to the raw HTTP body.
          #
          # Example:
          #
          #     message GetResourceRequest {
          #       // A unique request id.
          #       string request_id = 1;
          #
          #       // The raw HTTP body is bound to this field.
          #       google.api.HttpBody http_body = 2;
          #     }
          #
          #     service ResourceService {
          #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
          #       rpc UpdateResource(google.api.HttpBody) returns
          #       (google.protobuf.Empty);
          #     }
          #
          # Example with streaming methods:
          #
          #     service CaldavService {
          #       rpc GetCalendar(stream google.api.HttpBody)
          #         returns (stream google.api.HttpBody);
          #       rpc UpdateCalendar(stream google.api.HttpBody)
          #         returns (stream google.api.HttpBody);
          #     }
          #
          # Use of this type only changes how the request and response bodies are
          # handled, all other features will continue to work unchanged.
        "contentType": "A String", # The HTTP Content-Type header value specifying the content type of the body.
        "data": "A String", # The HTTP request/response body as raw binary.
        "extensions": [ # Application specific response metadata. Must be set in the first response
            # for streaming APIs.
          {
            "a_key": "", # Properties of the object. Contains field @type with type URL.
          },
        ],
      }