Aquarius v0.3.7

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

/assets

get

Get all asset IDs.

Responses

200 successful action

/assets/ddo

delete

Retire metadata of all the assets.

Responses

200 successfully deleted
500 Error

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/did/v1",
"authentication": [ { "publicKey": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "type": "RsaSignatureAuthentication2018" } ],
"created": "2016-02-08T16:02:20Z",
"id": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e429",
"proof": ,
"publicKey": [ { "id": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "owner": "0x00Bd138aBD70e2F00903268F3Db08f2D25677C9e", "type": "EthereumECDSAKey" } ],
"service": [ { "service": "SecretStore", "serviceDefinitionId": "0", "serviceEndpoint": "http://localhost:12001", "type": "Authorization" }, { "purchaseEndpoint": "http://localhost:8030/api/v1/brizo/services/access/initialize", "serviceDefinitionId": "1", "serviceEndpoint": "http://localhost:8030/api/v1/brizo/services/consume", "type": "Access" }, { "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", "checksum": "0x38803b9e6f04fce3fba4b124524672592264d31847182c689095a081c9e85262", "copyrightHolder": "Met Office", "dateCreated": "2012-02-01T10:55:11Z", "datePublished": "2012-02-01T10:55:11Z", "description": "Weather information of UK including temperature and humidity", "encryptedFiles": "0x098213xzckasdf089723hjgdasfkjgasfv", "files": [ { "compression": "zip", "contentLength": 4535431, "contentType": "text/csv", "encoding": "UTF-8", "index": 0, "resourceId": "access-log2018-02-13-15-17-29-18386C502CAEA932" } ], "inLanguage": "en", "license": "CC-BY", "links": [ { "name": "Sample of Asset Data", "type": "sample", "url": "https://foo.com/sample.csv" } ], "name": "UK Weather information 2011", "price": "10", "tags": [ "weather", "uk", "2011", "temperature", "humidity" ], "type": "dataset", "workExample": "stationId,latitude,longitude,datetime, temperature,humidity/n423432fsd,51.509865,-0.118092, 2011-01-01T10:55:11+00:00,7.2,68" }, "curation": { "numVotes": 123, "rating": 0.93, "schema": "Binary Voting" } }, "serviceDefinitionId": "2", "serviceEndpoint": "http://myaquarius.org/api/v1/provider/assets/metadata/did:op :0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "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/validate

post

Validate metadata content.

Parameters

body*

Asset metadata.

{}

Responses

200 successfully request.
500 Error

/assets/ddo/{did}

delete

Retire metadata of an asset

Parameters

did*string

DID of the asset.

Responses

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

get

Get DDO of a particular asset.

Parameters

did*string

DID of the asset.

Responses

200 successful operation
404 This asset DID is not in OceanDB

put

Update DDO of an existing asset

Parameters

did*string

DID of the asset.

body*

DDO of the asset.

{
"@context": "https://w3id.org/did/v1",
"authentication": [ { "publicKey": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "type": "RsaSignatureAuthentication2018" } ],
"created": "2016-02-08T16:02:20Z",
"id": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e429",
"proof": ,
"publicKey": [ { "id": "did:op:0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "owner": "0x00Bd138aBD70e2F00903268F3Db08f2D25677C9e", "type": "EthereumECDSAKey" } ],
"service": [ { "purchaseEndpoint": "http://localhost:8030/api/v1/brizo/services/access/initialize", "serviceDefinitionId": "1", "serviceEndpoint": "http://localhost:8030/api/v1/brizo/services/consume", "type": "Access" }, { "service": "SecretStore", "serviceDefinitionId": "0", "serviceEndpoint": "http://localhost:12001", "type": "Authorization" }, { "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", "checksum": "0x38803b9e6f04fce3fba4b124524672592264d31847182c689095a081c9e85262", "copyrightHolder": "Met Office", "dateCreated": "2012-02-01T10:55:11Z", "datePublished": "2012-02-01T10:55:11Z", "description": "Weather information of UK including temperature and humidity", "encryptedFiles": "0x098213xzckasdf089723hjgdasfkjgasfv", "files": [ { "compression": "zip", "contentLength": 4535431, "contentType": "text/csv", "encoding": "UTF-8", "index": 0, "resourceId": "access-log2018-02-13-15-17-29-18386C502CAEA932" } ], "inLanguage": "en", "license": "CC-BY", "links": [ { "name": "Sample of Asset Data", "type": "sample", "url": "https://foo.com/sample.csv" } ], "name": "UK Weather information 2011", "price": "10", "tags": [ "weather", "uk", "2011", "temperature", "humidity" ], "type": "dataset", "workExample": "stationId,latitude,longitude,datetime, temperature,humidity/n423432fsd,51.509865,-0.118092, 2011-01-01T10:55:11+00:00,7.2,68" }, "curation": { "numVotes": 123, "rating": 0.93, "schema": "Binary Voting" } }, "serviceDefinitionId": "2", "serviceEndpoint": "http://myaquarius.org/api/v1/provider/assets/metadata/did:op :0c184915b07b44c888d468be85a9b28253e80070e5294b1aaed81c2f0264e430", "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/metadata/{did}

get

Get metadata of a particular asset

Parameters

did*string

DID of the asset.

Responses

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