Skip to main content

GA4GH Data Object Service Schemas

Project description

Schemas for the Data Object Service (DOS) API

Build Status Swagger Validator Read the Docs badge PyPI - Python Version

View the schemas in Swagger UI

The goal of DOS is to create a generic API on top of existing object storage systems so workflow systems can access data in a single, standard way regardless of where it's stored. It's maintained by the GA4GH Cloud Workstream.

Key features

The API is split into two sections:

  • data object management, which enables the creation, updating, deletion, versioning, and unique identification of files and data bundles (flat collections of files); and
  • data object querying, which can locate data objects across different cloud environments and DOS implementations.

Getting started

Installing is as easy as:

$ pip install ga4gh-dos-schemas

This will install both a demonstration server and a Python client that will allow you to manage Data Objects in a local server. You can start the demo server using ga4gh_dos_server. This starts a Data Object Service at http://localhost:8080.

md5sum chr22.fa.gz
# 41b47ce1cc21b558409c19b892e1c0d1  chr22.fa.gz
curl -X POST -H 'Content-Type: application/json' \
    --data '{"data_object":
              {"id": "hg38-chr22",
               "name": "Human Reference Chromosome 22",
               "checksums": [{"checksum": "41b47ce1cc21b558409c19b892e1c0d1", "type": "md5"}],
               "urls": [{"url": ""}],
               "size": "12255678"}}' http://localhost:8080/ga4gh/dos/v1/dataobjects
# We can then get the newly created Data Object by id
curl http://localhost:8080/ga4gh/dos/v1/dataobjects/hg38-chr22
# Or by checksum!
curl -X GET http://localhost:8080/ga4gh/dos/v1/dataobjects -d checksum=41b47ce1cc21b558409c19b892e1c0d1

For more on getting started, check out the quickstart guide or the rest of the documentation at ReadtheDocs!

Getting involved!

The Data Object Service Schemas are Apache 2 Licensed Open Source software. Please join us in the issues or check out the contributing docs!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ga4gh-dos-schemas, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size ga4gh_dos_schemas-0.4.2.tar.gz (19.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page