Data Release

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).

get/datacatalog/api/data-release/{id}/files/collection-info

Request

  • Base URL
    https://data.usgs.gov (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Authorization code: https://auth.globus.org/v2/oauth2/authorize?scope=openid
    Token URL: https://data.usgs.gov/datacatalog/api/auth/login

Path parameters

idstring required

Response

Successful Response

successboolean required

A boolean (true/false) indicating if the request was successful.

Changes

No recorded changes to this operation across all 1 revision of this API.