Initialize

• Purpose: Provides all information needed to initialization the Bridge Ingest App
• Request: POST https://host:port/bridge/init

• Request Body: JSON in format:

  {
   "originatorEmailAddress" : "${bridge.originatorEmailAddress}",
   "duracloudEmailAddresses" : ["${bridge.duracloudEmailAddress}"],
   "dpnEmailAddresses" : ["${bridge.dpnEmailAddress}"],
   "duracloudUsername" : "${bridge.duracloudUsername}",
   "duracloudPassword" : "${bridge.duracloudPassword}",
   "awsAccessKey" : "${aws.accessKey}",
   "awsSecretKey" : "${aws.secretKey}",
   "databaseUser" : "${bridge.database.username}",
   "databasePassword" : "${bridge.database.password}",
   "databaseURL" : "${bridge.database.url}",
   "contentDirRoot" : "${bridge.contentDirRoot}",
   "workDir" : "${bridge.workDir}",
   "clean" : "${bridge.clean}"
  }

• Response Code: 200 (on success)

• Response Body: JSON:

  {"message" : "success!"}

Version

• Purpose: Provides the current version of the Bridge App
• Request: GET https://host:port/bridge/version
• Response Code: 200 (on success)

• Response Body: JSON:

  {"version" : "1.0.0"}

Create Snapshot

• Purpose: Performs a snapshot action
• Request: PUT https://host:port/bridge/snapshot/(snapshotId)

• Request Body: JSON:

  {
   "host" : "",
   "port" : "",
   "storeId" : "",
   "spaceId" : "",
   "description" : "",
   "userEmail" : ""
  } 

  • host - DNS host of DuraCloud instance from which snapshot can be taken
  • port - Port on which DuraCloud applications are available
  • storeID - Identifier of Chronopolis staging storage provider on DuraCloud instance
  • spaceID - Identifier of space in which snapshot content resides
  • description - User-supplied description of the snapshot
  • userEmail - User's email address, for notifications
    
    
• Response Code: 200 or 201 on success (201 if snapshot request did not already exist)

• Response Body: JSON:

  {
    "snapshotId" : "",
    "status": ""
  }

List All Snapshots

• Purpose: Performs a snapshot action

• Request: GET https://host:port/bridge/snapshot

• Response Body: JSON:

  [
  	{"id":"snapshot1", "description"},
  	...,
  	...
  ]

Snapshot Status

• Purpose: Provides the status of a snapshot action
• Request: GET https://host:port/bridge/snapshot/(snapshotId)
  • snapshotID - Identifier of the snapshot
• Response Code: 200 (on success)

• Response Body: JSON:

  {"status" : "",
   "subStatus" : "",
   "details": ""
  }

  Possible values for status:

  • TRANSFERRING_TO_BRIDGE
  • WAITING_FOR_DPN_TRANSER
  • TRANSFERING_TO_DPN
  • COMPLETE

Snapshot Complete

• Purpose: Enables DPN provider to notify bridge app that a snapshot has been restored to bridge storage.
• Request: POST https://host:port/bridge/snapshot/complete/(snapshotId)
• snapshotID - Identifier of the snapshot
• Response Code: 200 (on success)
• Response Body: JSON:

Restore Snapshot

• Purpose: Enables user to initiate the restoration of a snapshot

• Request: PUT https://host:port/bridge/restore

  {
   "host" : "",
   "port" : "",
   "storeId" : "",
   "spaceId" : "",
   "snapshotId" : "",
   "userEmail" : ""
  } 

• Response Code: 200 (on success)

• Response Body: JSON:

  {"restorationId" : ""}

   

Restore Complete

• Purpose: Enables DPN provider to notify bridge app that a snapshot has been restored to bridge storage.
• Request: POST https://host:port/bridge/restore/(restoreId)/complete
• snapshotID - Identifier of the snapshot
• Response Code: 200 (on success)

• Response Body: JSON:

  {"status" : ""}

Restoration Status

• Purpose: Provides the status of a restoration action
• Request: GET https://host:port/bridge/restore/(restoreId)
• Response Code: 200 (on success)

• Response Body: JSON:

  {
   "status" : "",
   "subStatus" : "",
   "details": ""
  }

  Possible values for status:

  •     INITIALIZED
  •     WAITING_FOR_DPN
  •     DPN_TRANSFER_COMPLETE
  •     TRANSFERRING_TO_DURACLOUD
  •     VERIFYING_TRANSFERRED_CONTENT
  •     RESTORATION_COMPLETE