Get the Globus collection details for a data release.
Get the Globus collection details for a data release.
Data release files are stored in a Globus collection under a directory named for the data release ID. This endpoint returns the identifiers needed to reach those files directly, without going through the Horizon API:
- collection_id: The ID of the Globus collection holding the release's files. Use it as the source or destination collection in Globus tooling, or to request the collection's HTTPS scope (https://auth.globus.org/scopes/<collection_id>/https).
- https_server: The collection's base HTTPS URL. An individual file can be requested at <https_server>/<release_id>/<file_name> (or <https_server>/<release_id>/<component_name>/<file_name> for a component file) with a Globus HTTPS access token for the collection. This is null if the collection does not support HTTPS access.
The requesting user must have write access to the data release.
.. code-block::
{
"success": true,
"message": "Request processed successfully",
"data": {
"collection_id": "<Globus collection ID>",
"https_server": "https://g-1a2b3c.data.globus.org"
}
}
:param id: The ID of the data release. :param token: A valid bearer token for the user. :returns: A :class:GetCollectionInfoResponse whose data contains the collection_id and https_server. :raises NotFoundException: If the data release does not exist (404). :raises ForbiddenException: If the user lacks write access to the data release (403).
Request
- Base URLhttps://data.usgs.gov (the document declares no server; this is the origin it was published from)
- AuthOAuth 2Authorization code: https://auth.globus.org/v2/oauth2/authorize?scope=openidToken URL: https://data.usgs.gov/datacatalog/api/auth/login
Path parameters
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.