data-repository-service-schemas
data-repository-service-schemas copied to clipboard
DRS URI example in Contents definition is wrong
The Contents object is supposed to be a list of DRS URIs. The example of a DRS URI incorrectly includes most of the ga4gh REST API path:
drs_uri:
type: array
description: >-
A list of full DRS identifier URI paths
that may be used to obtain the object.
These URIs may be external to this DRS instance.
example:
drs://example.com/ga4gh/drs/v1/objects/{object_id}
items:
type: string
I will submit a PR to remove the /ga4gh/drs/v1/objects
Related to this, it seems that the sentence 'Strings of the form drs://
Similarly, the description of drs_uri in section 6.4 ContentsObject describes the element as "A list of full DRS identifier URI paths that may be used to obtain the object." when, in fact, they can be used to learn how to obtain the object.
I think this distinction is important and the text should be clarified so that readers do not get the impression that a DRS URI is like an Access URL.