v1

latestSwagger 2.0MIT License2026-07-17191054.1 KB
jobs

Queue a new job for the store.

The body of the request contains a generic job request object The jobType field is used to define the kind of job to be created. The jobParameters field is a map of string parameter name to string value. The parameters accepted (or required) for a job vary by job type, as described in the table below.

Job TypeParameterDescription
consolidate--
createsnapshotTargetStoreNameREQUIRED: The name of the store to be created by the snapshot process.
PersistenceTypeREQUIRED: The persistence model to use for the store created by the snapshot process. Must be one of AppendOnly or Rewrite
CommitIdOPTIONAL: The unique identifier of the commit point of the source store to create the snapshot from. If not specified, the most recent commit point is used.
exportFileNameREQUIRED: The name of the file to be written by the export process.
FormatOPTIONAL: The MIME type of the output format to be used by the export. Defaults to applicaiton/x-nquads.
GraphUriOPTIONAL: The URI of the graph to be exported. If not specified, all of the graphs in the store will be exported.
importFileNameREQUIRED: The name of the file to be imported. This file must exist in the import directory of the store.
DefaultGraphUriOPTIONAL: Provides a default target graph for the data (if the data does not itself specify a target graph). Defaults to the BrightstarDB default graph.
repeattransactionJobIdREQUIRED: The unique identifier of the job to be repeated.
sparqlupdateUpdateExpressionREQUIRED: The SPARQL Update expression to be processed.
transactionPreconditionsOPTIONAL: Triples or Quads that must exist in the store before the transaction is applied.
transactionNonexistencePreconditionsOPTIONAL: Triples or Quads that must not exist in the store before the transaction is applied.
transactionDeletesOPTIONAL: Triples or Quads to be removed from the store.
transactionInsertsOPTIONAL: Triples or Quads to be added to the store.
transactionDefaultGraphUriOPTIONAL: The default target graph for the transaction, used to convert triples to quads.
updatestats--

NOTE: The Preconditions, NonExistencePreconditions, Deletes and Inserts parameters for the transaction job must use NQuads (or NTriples) syntax with a newline separating each triple or quad. The Preconditions, NonExistencePreconditions and Deletes all support the use of the "special" URI http://www.brightstardb.com/.well-known/model/wildcard for a wildcard match in the position where it is used. For more information please see http://brightstardb.readthedocs.org/en/latest/RDF_Client_API/#transactional-update

post/{storeName}/jobs

Path parameters

storeNamestring required

The name of the store

Request body

jobType'consolidate' | 'createsnapshot' | 'export' | 'import' | 'repeattransaction' | 'sparqlupdate' | 'transaction' | 'updatestats'

The type of the job.

labelstring

A user-friendly name for the job.

jobParametersobject

A dictionary mapping parameter name to value.

Response

The job request was accepted and the job has been queued.

The URL for monitoring the status of the job can be found in the Location response header.

jobIdstring GUID required

The unique identifier of the job

labelstring

A user-friendly label for the job specified when the job was queued.

jobStatus'Pending' | 'Started' | 'CompletedOk' | 'TransactionError' | 'Unknown'

The current processing state of the job.

statusMessagestring

The last progress message recorded by the server for the processing of this job.

storeNamestring

The name of the store that the job is queued on

queuedTimestring date-time

The date/time when the job was queued on the server.

startTimestring date-time

The date/time when the job started processing.

This value will not be available when the jobStatus is "Pending".

endTimestring date-time

The date/time when the job completed processing.

This value will not be available when the jobStatus is "Pending" or "Started".