Aquarius 0.1.4

Aquarius provides an off-chain database store for metadata about data assets. When running with our Docker images, it is exposed under http://localhost:5000.

Base Path

myfancyaquarius.com/api/v1/aquarius

/assets

get

Get all asset IDs.

Responses

200 successful action

/assets/ddo

get

Get DDO of all assets.

Responses

200 successful action

post

Register DDO of a new asset

Parameters

body*

DDO of the asset.

{
"@context": "https://w3id.org/future-method/v1",
"authentication": [ { "type": "RsaSignatureAuthentication2018" }, { "publicKey": "did:op:123456789abcdefghi#keys-1" } ],
"id": "did:op:123456789abcdefghi",
"publicKey": [ { "id": "did:op:123456789abcdefghi#keys-1" }, { "type": "Ed25519VerificationKey2018" }, { "owner": "did:op:123456789abcdefghi" }, { "publicKeyBase58": "H3C2AVvLMv6gmMNam3uVAjZpfkcJCwDwnZn6z3wXmqPV" } ],
"service": [ { "serviceEndpoint": "http://mybrizo.org/api/v1/brizo/services/consume?pubKey=${pubKey}&serviceId={serviceId}&url={url}", "type": "Consume" }, { "serviceEndpoint": "http://mybrizo.org/api/v1/brizo/services/compute?pubKey=${pubKey}&serviceId={serviceId}&algo={algo}&container={container}", "type": "Compute" }, { "metadata": { "additionalInformation": { "structuredMarkup": [ { "mediaType": "application/ld+json", "uri": "http://skos.um.es/unescothes/C01194/jsonld" }, { "mediaType": "text/turtle", "uri": "http://skos.um.es/unescothes/C01194/turtle" } ], "updateFrecuency": "yearly" }, "base": { "author": "Met Office", "compression": "zip", "contentType": "text/csv", "contentUrls": [ "https://testocnfiles.blob.core.windows.net/testfiles/testzkp.zip" ], "copyrightHolder": "Met Office", "dateCreated": "2012-10-10T17:00:000Z", "description": "Weather information of UK including temperature and humidity", "encoding": "UTF-8", "inLanguage": "en", "license": "CC-BY", "links": [ { "sample1": "http://data.ceda.ac.uk/badc/ukcp09/data/gridded-land-obs/gridded-land-obs-daily/" }, { "sample2": "http://data.ceda.ac.uk/badc/ukcp09/data/gridded-land-obs/gridded-land-obs-averages-25km/" }, { "fieldsDescription": "http://data.ceda.ac.uk/badc/ukcp09/" } ], "name": "UK Weather information 2011", "price": 10, "size": "3.1gb", "tags": "weather, uk, 2011, temperature, humidity", "type": "dataset", "workExample": "423432fsd,51.509865,-0.118092,2011-01-01T10:55:11+00:00,7.2,68" }, "curation": { "numVotes": 123, "rating": 0.93, "schema": "Binary Votting" } }, "serviceEndpoint": "http://myaquarius.org/api/v1/provider/assets/metadata/{did}", "type": "Metadata" } ],
}

Responses

201 Asset successfully registered.
400 One of the required attributes is missing.
404 Invalid asset data.
500 Error

/assets/ddo/query

get

Get a list of DDOs that match with the given text.

Parameters

text*string

ID of the asset.

sortobject

Key or list of keys to sort the result

offsetint

Number of records per page

pageint

Page showed

Responses

200 successful action

post

Get a list of DDOs that match with the executed query.

Parameters

body*

Asset metadata.

{
"offset": ,
"page": ,
"query": "[object Object]",
"sort": { "value": 1 },
}

Responses

200 successful action

/assets/ddo/{did}

put

Update DDO of an existing asset

Parameters

body*

DDO of the asset.

{
"@context": "https://w3id.org/future-method/v1",
"authentication": [ { "type": "RsaSignatureAuthentication2018" }, { "publicKey": "did:op:123456789abcdefghi#keys-1" } ],
"id": "did:op:123456789abcdefghi",
"publicKey": [ { "id": "did:op:123456789abcdefghi#keys-1" }, { "type": "Ed25519VerificationKey2018" }, { "owner": "did:op:123456789abcdefghi" }, { "publicKeyBase58": "H3C2AVvLMv6gmMNam3uVAjZpfkcJCwDwnZn6z3wXmqPV" } ],
"service": [ { "serviceEndpoint": "http://mybrizo.org/api/v1/brizo/services/consume?pubKey=${pubKey}&serviceId={serviceId}&url={url}", "type": "Consume" }, { "serviceEndpoint": "http://mybrizo.org/api/v1/brizo/services/compute?pubKey=${pubKey}&serviceId={serviceId}&algo={algo}&container={container}", "type": "Compute" }, { "metadata": { "additionalInformation": { "structuredMarkup": [ { "mediaType": "application/ld+json", "uri": "http://skos.um.es/unescothes/C01194/jsonld" }, { "mediaType": "text/turtle", "uri": "http://skos.um.es/unescothes/C01194/turtle" } ], "updateFrecuency": "yearly" }, "base": { "author": "Met Office", "compression": "zip", "contentType": "text/csv", "contentUrls": [ "https://testocnfiles.blob.core.windows.net/testfiles/testzkp.zip" ], "copyrightHolder": "Met Office", "dateCreated": "2012-10-10T17:00:000Z", "description": "Weather information of UK including temperature and humidity", "encoding": "UTF-8", "inLanguage": "en", "license": "CC-BY", "links": [ { "name": "Sample of Asset Data", "type": "sample", "url": "https://foo.com/sample.csv" }, { "AssetID": "4d517500da0acb0d65a716f61330969334630363ce4a6a9d39691026ac7908ea", "name": "Data Format Definition", "type": "format" } ], "name": "UK Weather information 2011", "price": 10, "size": "3.1gb", "tags": "weather, uk, 2011, temperature, humidity", "type": "dataset", "workExample": "423432fsd,51.509865,-0.118092,2011-01-01T10:55:11+00:00,7.2,68" }, "curation": { "numVotes": 123, "rating": 0.93, "schema": "Binary Voting" } }, "serviceEndpoint": "http://myaquarius.org/api/v1/aquarius/assets/metadata/{did}", "type": "Metadata" } ],
}

Responses

200 Asset successfully updated.
201 Asset successfully registered.
400 One of the required attributes is missing.
404 Invalid asset data.
500 Error

/assets/ddo/{id}

delete

Retire metadata of an asset

Parameters

id*string

ID of the asset.

Responses

200 successfully deleted
404 This asset ID is not in OceanDB
500 Error

get

Get DDO of a particular asset.

Parameters

id*string

ID of the asset.

Responses

200 successful operation
404 This asset ID is not in OceanDB

/assets/metadata/{id}

get

Get metadata of a particular asset

Parameters

id*string

ID of the asset.

Responses

200 successful operation.
404 This asset ID is not in OceanDB.