Brizo v0.9.7

Brizo is the technical component executed by Publishers allowing them to provide extended data services. When running with our Docker images, it is exposed under http://localhost:8030.

/services/compute

delete

Deletes a workflow.

Parameters

signaturestring

Signature of the documentId to verify that the consumer has rights to download the asset.

serviceAgreementId*string

The ID of the service agreement.

consumerAddress*string

The consumer address.

jobIdstring

JobId.

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Invalid asset data.
500 Error

get

Get status for a specific jobid/agreementId/owner

Parameters

signaturestring

Signature of (consumerAddress+jobId+serviceAgreementId) to verify the consumer of this agreement/compute job. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

serviceAgreementId*string

The ID of the service agreement, must exist on-chain. If not provided, the status of all currently running and old compute jobs for the specified consumerAddress will be returned.

consumerAddress*string

The consumer ethereum address.

jobIdstring

The ID of the compute job. If not provided, all running compute jobs of the specified consumerAddress/serviceAgreementId are suspended

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification.
500 General server error

post

Call the execution of a workflow.

Parameters

signaturestring

Signature of (consumerAddress+jobId+serviceAgreementId) to verify the consumer of this agreement/compute job. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

serviceAgreementId*string

The ID of the service agreement, must exist on-chain. If not provided, the status of all currently running and old compute jobs for the specified consumerAddress will be returned.

consumerAddress*string

The consumer ethereum address.

algorithmDidstring

The DID of the algorithm Asset to be executed

algorithmMetajson string

json object that define the algorithm attributes and url or raw code

output*json string

json object that define the output section

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification, or Service Agreement is invalid
500 General server error

put

Stop the execution of a workflow.

Parameters

signaturestring

Signature of (consumerAddress+jobId+serviceAgreementId) to verify the consumer of this agreement/compute job. The signature uses ethereum based signing method (see https://github.com/ethereum/EIPs/pull/683)

serviceAgreementId*string

The ID of the service agreement, must exist on-chain. If not provided, all currently running compute jobs will be stopped for the specified consumerAddress

consumerAddress*string

The consumer ethereum address.

jobIdstring

The ID of the compute job. If not provided, all running compute jobs of the specified consumerAddress/serviceAgreementId are suspended

Responses

200 Call to the operator-service was successful.
400 One of the required attributes is missing.
401 Consumer signature is invalid or failed verification.
500 General server error

/services/consume

get

Allows download of asset data file.

Parameters

consumerAddress*string

The consumer address.

serviceAgreementId*string

The ID of the service agreement.

url*string

This URL is only valid if Brizo acts as a proxy. Consumer can't download using the URL if it's not through Brizo.

signature

Signature of the documentId to verify that the consumer has rights to download the asset.

index

Index of the file in the array of files.

Responses

200 Redirect to valid asset url.
400 One of the required attributes is missing.
401 Invalid asset data.
500 Error