Page History

Initialize Security Users

• Purpose: Allows the initialization of authorized users
• Request:
  • POST https://host:port/durastore/security^{Image Removed}
  • POST https://host:port/duraservice/security^{Image Removed}
  • POST https://host:port/duradmin/security^{Image Removed}
  • POST https://host:port/durareport/security^{Image Removed}
• Request Body: XML similar to:

  Code Block
  xml xml
  <?xml version="1.0" encoding="UTF-8"?> <dur:security-users schemaVersion="0.2" xmlns:dur="duracloud.org"> <security-user> <username>username-0</username> <password>password-0</password> <enabled>true</enabled> <accountNonExpired>true</accountNonExpired> <credentialsNonExpired>true</credentialsNonExpired> <accountNonLocked>true</accountNonLocked> <grantedAuthorities>ROLE_USER</grantedAuthorities> </security-user> <security-user> <username>username-1</username> <password>password-1</password> <enabled>false</enabled> <accountNonExpired>false</accountNonExpired> <credentialsNonExpired>false</credentialsNonExpired> <accountNonLocked>false</accountNonLocked> <grantedAuthorities>ROLE_USER ROLE_ADMIN</grantedAuthorities> </security-user> </dur:security-users>

• Response Code: 200 (on success)
• Response Body: "Initialization Successful" (on success)

Initialize Stores

• Purpose: Allows the initialization of storage provider accounts
• Request: POST https://host:port/durastore/init^{Image Removed}
• Request Body: XML similar to:

  Code Block
  xml xml
  <storageProviderAccounts> <storageAcct ownerId='0' isPrimary='true'> <id>1</id> <storageProviderType>AMAZON_S3</storageProviderType> <storageProviderCredential> <username>username</username> <password>password</password> </storageProviderCredential> </storageAcct> </storageProviderAccounts>

• Response Code: 200 (on success)
• Response Body: "Initialization Successful" (on success)

Is Initialized

• Purpose: Performs a check to determine if the DuraStore application has been initialized
• Request: GET https://host:port/durastore/init^{Image Removed}
• Response Code: 200 (if the application has been initialized), 503 (if the application has NOT been initialized)
• Response Body: Text indicating whether initialization has occurred.

Get Stores

• Purpose: Provides a listing of available storage providers accounts (without credentials)
• Request: GET https://host:port/durastore/stores^{Image Removed}
• Parameters: None
• Response Code: 200 (on success)
• Response Body: XML similar to:

  Code Block
  xml xml
  <storageProviderAccounts> <storageAcct isPrimary='true'> <id>1</id> <storageProviderType>AMAZON_S3</storageProviderType> </storageAcct> <storageAcct isPrimary="false"> <id>2</id> <storageProviderType>RACKSPACE</storageProviderType> </storageAcct> </storageProviderAccounts>

Get Spaces

• Purpose: Provides a listing of all of the spaces that a customer has created
• Request: GET https://host:port/durastore/spaces^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Body: XML similar to:

  Code Block
  <spaces> <space id="space1" /> <space id="space2" /> </spaces>

Get Space

• Purpose: Provides a listing of the contents of a space along with space properties
• Request: GET https://host:port/durastore/spaceID^{Image Removed} ? (storeID) (prefix) (maxResults) (marker)
  • storeID (optional) - ID of the content storage provider to query (default is primary store)
  • prefix (optional) - Only retrieve content ids with this prefix (default is all content ids)
  • maxResults (optional) - The maximum number of content IDs to return in the list (default is 1000)
    note: the maximum allowable value for maxResults is 1000. Any larger value will be reduced to 1000.
  • marker (optional) - The content ID marking the last item in the previous set (default is the first set of ids)
• Response Code: 200 (on success)
• Response Body: XML similar to:

  Code Block
  <space id="space1"> <item>Image 1</item> <item>Image 2</item> </space>

• Response Headers: All available space properties, example:

  Code Block
  x-dura-meta-space-count: 65 x-dura-meta-space-access: OPEN x-dura-meta-space-created: Mon, 01 Jan 2000 08:00:00 EST x-dura-meta-custom-property: Custom Property Value

Get Space Properties

• Purpose: Provides all space properties
• Request: HEAD https://host:port/durastore/spaceID^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Headers: Same as for Get space (above)

Get Space ACLs

• Purpose: Provides all space ACLs, with values of 'r' (read) and 'w' (read/write)
• Request: HEAD https://host:port/durastore/acl/spaceID^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Headers: All available space ACLs, example:

  Code Block
  x-dura-meta-acl-user0: WRITE x-dura-meta-acl-user1: WRITE x-dura-meta-acl-group-curators: READ

Create Space

• Purpose: Creates a new space
• Request: PUT https://host:port/durastore/spaceID^{Image Removed} ? (storeID)
• Request Headers: Properties about the space, example:

  Code Block
  x-dura-meta-space-access: OPEN x-dura-meta-custom-property: Custom Property Value

• Response Code: 201 (on success)
• Response Headers: Location of the new space (i.e. the URL used to create the space), example:

  Code Block
  Location: https://myhost:8080/durastore/space1

Set Space Properties

• Purpose: Updates the properties associated with a space
• Request: POST https://host:port/durastore/spaceID^{Image Removed} ? (storeID)
• Request Headers: Same as Create space (above)
• Response Code: 200 (on success)
• Response Body: "Space $spaceID updated successfully" (on success)

Set Space ACLs

• Purpose: Updates the ACLs associated with a space
• Request: POST https://host:port/durastore/acl/spaceID^{Image Removed} ? (storeID)
• Request Headers: For 'user' ACLs the header prefix must be 'x-dura-meta-acl-' and for 'groups' the header prefix must be 'x-dura-meta-acl-group-'. Allowable values for ACL headers are: 'READ' and 'WRITE'.
  Example:

  Code Block
  x-dura-meta-acl-user0: WRITE x-dura-meta-acl-user1: WRITE x-dura-meta-acl-group-curators: READ

• Response Code: 200 (on success)
• Response Body: "Space $spaceID ACLs updated successfully" (on success)

Delete Space

• Purpose: Deletes a space
• Request: DELETE https://host:port/durastore/spaceID^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Body: "Space $spaceID deleted successfully" (on success)

Get Content

• Purpose: Retrieves a piece of content along with its properties
• Request: GET https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID) (attachment)
  • if attachment param value is true, a Content-Disposition header is included with the response
• Response Code: 200 (on success)
• Response Body: The content stream
• Response Headers: All available content properties, example:

  Code Block
  Content-Type: text/plain Content-Length: 5732 Content-MD5: 3456709234785097473839202 ETag: 3456709234785097473839202 x-dura-meta-content-name: Testing Content x-dura-meta-content-owner: JSmith

Get Content Properties

• Purpose: Retrieves the properties of a piece of content without the content itself
• Request: HEAD https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Headers: Same as Get content (above)

Store Content

• Purpose: Adds a piece of content to the store
• Request: PUT https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID)
• Request Body: Content to be added
• Request Headers: Properties about the content, example:

  Code Block
  Content-Type: text/plain Content-MD5: 4cd56e137a93a1accb43c5d32f4afffb x-dura-meta-content-name: Testing Content x-dura-meta-content-owner: JSmith

• Response Code: 201 (on success)
• Response Headers:
  • MD5 checksum of stored content
  • ETag of stored content
  • Location of the new content (i.e. the URL used to create the content), example:

    Code Block
    Content-MD5: 4cd56e137a93a1accb43c5d32f4afffb ETag: 4cd56e137a93a1accb43c5d32f4afffb Location: https://myhost:8080/durastore/space1/content1

• Usage Notes
  • When the optional Content-MD5 header is included, the final checksum of the stored file is compared against the MD5 value included in the header to ensure that the file was stored correctly. If the header is not included, an MD5 checksum is computed as the file is transferred to storage, and that value is used in the final comparison.

Copy Content

• Purpose: Copies a piece of content from a source space to a destination space within a given store
• Request: PUT https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID)
• Request Body: must not exist
• Request Headers: Copy source, example:

  Code Block
  x-dura-meta-copy-source: space-id/content-id

• Optional Request Headers: Copy source store, example:

  Code Block
  x-dura-meta-copy-source-store: storeId

• Response Code: 201 (on success)
• Response Headers:
  • MD5 checksum of stored content
  • ETag of stored content
  • Location of the new content (i.e. the URL used to create the content), example:

    Code Block
    Content-MD5: 4cd56e137a93a1accb43c5d32f4afffb ETag: 4cd56e137a93a1accb43c5d32f4afffb Location: https://myhost:8080/durastore/space1/content1

• Usage Notes
  • The properties associated with the source content item are copied to the destination content item.
  • The source and destination spaces may be the same.
  • Including the optional header indicates that the copy action should retrieve the source file from a space in the specified storage provider. This allows for copying a file from one storage provider to another.

Set Content Properties

• Purpose: Updates the properties associated with a piece of content
• Request: POST https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID)
• Request Headers: Same as Store content (above)
• Response Code: 200 (on success)
• Response Body: "Content $contentID updated successfully"

Delete Content

• Purpose: Removes a piece of content from the store
• Request: DELETE https://host:port/durastore/spaceID/contentID^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Body: "Content $contentID deleted successfully"

Get Tasks

• Purpose: Provides a listing of all of the supported tasks for a given provider. Note that if no storeID parameter is included, the task listing is provided for the primary storage provider.
• Request: GET https://host:port/durastore/task^{Image Removed} ? (storeID)
• Response Code: 200 (on success)
• Response Body: XML similar to:

  Code Block
  <list> <string>task1</string> <string>task2</string> </list>

Perform Task

• Purpose: Performs a particular task. Note that most tasks can be performed by only one storage provider type.
• Request: POST https://host:port/durastore/task/taskName^{Image Removed} ? (storeID)
• Request Body: Parameters for task. Each task will expect parameters in a specific format, see task listing for more details.
• Response Code: 200 (on success)
• Response Body: Response value for task, format varies by task.

Tasks

Initialize Services

• Purpose: Initializes the DuraService application
• Request: POST https://host:port/duraservice/init^{Image Removed}
• Request Body: XML similar to:

  Code Block
  xml xml
  <servicesConfig> <primaryServiceInstance> <host>[PRIMARY-SERVICE-INSTANCE-HOST]</host> <servicesAdminPort>[PRIMARY-SERVICES-ADMIN-PORT]</servicesAdminPort> <servicesAdminContext>[PRIMARY-SERVICES-ADMIN-CONTEXT]</servicesAdminContext> </primaryServiceInstance> <userStorage> <host>[USER-STORAGE-HOST-NAME]</host> <port>[USER-STORAGE-PORT]</port> <context>[USER-STORAGE-CONTEXT]</context> <msgBrokerUrl>[USER-STORAGE-MSG-BROKER-URL]</msgBrokerUrl> </userStorage> <serviceStorage> <host>[SERVICES-STORAGE-HOST-NAME]</host> <port>[SERVICES-STORAGE-PORT]</port> <context>[SERVICES-STORAGE-CONTEXT]</context> <spaceId>[SERVICES-STORAGE-SPACE-ID]</spaceId> </serviceStorage> <serviceCompute> <type>AMAZON_EC2</type> <imageId>[MACHINE-IMAGE-ID]</imageId> <computeProviderCredential> <username>[USERNAME]</username> <password>[PASSWORD]</password> </computeProviderCredential> </serviceCompute> </servicesConfig>

• Response Code: 200 (on success)
• Response Body: "Initialization Successful" (on success)

Is Initialized

• Purpose: Performs a check to determine if the DuraService application has been initialized
• Request: GET https://host:port/duraservice/init^{Image Removed}
• Response Code: 200 (if the application has been initialized), 503 (if the application has NOT been initialized)
• Response Body: Text indicating whether initialization has occurred.

Get Services

• Purpose: Retrieves a listing of services, along with their configuration options
• Request: GET https://host:port/duraservice/services^{Image Removed} ? (show)
  • Parameter options for show (optional)
    1. available (default) - Includes only services which have not been deployed but are available for deployment
    2. deployed - Includes only services which have been deployed and started
• Response Code: 200 (on success)
• Response Body: XML list of services (see service config xsd)

Get Service

• Purpose: Retrieves information about a particular service including description, configuration options, and all deployments
• Request: GET https://host:port/duraservice/serviceID^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML service (see service config xsd)

Get Deployed Service

• Purpose: Retrieves information about a deployed service including description, configuration options, and a single deployment indicating the configuration options in use
• Request: GET https://host:port/duraservice/serviceID/deploymentID^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML service (see service config xsd)

Get Deployed Service Properties

• Purpose: Retrieves the runtime properties of a deployed service
• Request: GET https://host:port/duraservice/serviceID/deploymentID/properties^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML service (simple xml Map serialization)

Deploy Service

• Purpose: Deploys and starts an available service
• Request: PUT https://host:port/duraservice/serviceID^{Image Removed} ? (serviceHost)
  • Parameter value for serviceHost (optional) should indicate the services host on which the service should be deployed. Default is the primary customer host.
• Request Body: XML user configuration indicating the config selections for the service (see user config portion of service config xsd)
• Response Code: 201 (on success)
• Response Header: Location header indicates the URL at which information about the deployed service can be retrieved (the URL for a get deployed service call) which includes the deploymentID

Update Service Configuration

• Purpose: Updates the configuration of a deployed service
• Request: POST https://host:port/duraservice/serviceID/deploymentID^{Image Removed}
• Request Body: Updated XML user configuration indicating the config selections for the service (see user config portion of service config xsd)
• Response Code: 200 (on success)

UnDeploy Service

• Purpose: Stops and Undeploys a deployed service
• Request: DELETE https://host:port/duraservice/serviceID/deploymentID^{Image Removed}
• Response Code: 200 (on success)

Initialize Application

• Purpose: Allows the initialization of duradmin
• Request: POST https://host:port/duradmin/init^{Image Removed}
• Request Body: XML similar to:

  Code Block
  xml xml
  <duradminConfig> <durastoreHost>[host]</durastoreHost> <durastorePort>[port]</durastorePort> <durastoreContext>durastore</durastoreContext> <duraserviceHost>[host]</duraserviceHost> <duraservicePort>[port]</duraservicePort> <duraserviceContext>duraservice</duraserviceContext> </duradminConfig>

• Response Code: 200 (on success)
• Response Body: "Initialization Successful" (on success)

Is Initialized

• Purpose: Performs a check to determine if the DurAdmin application has been initialized
• Request: GET https://host:port/duradmin/init^{Image Removed}
• Response Code: 200 (if the application has been initialized), 503 (if the application has NOT been initialized)
• Response Body: Text indicating whether initialization has occurred.

Initialize Application

• Purpose: Allows the initialization of duraboss
• Request: POST https://host:port/duraboss/init^{Image Removed}
• Request Body: XML similar to:

  Code Block
  xml xml
  <durabossConfig> <reporterEnabled>[true|false]</reporterEnabled> <executorEnabled>[true|false]</executorEnabled> <auditorEnabled>[true|false]</auditorEnabled> <durastoreHost>[host]</durastoreHost> <durastorePort>[port]</durastorePort> <durastoreContext>durastore</durastoreContext> <duraserviceHost>[host]</duraserviceHost> <duraservicePort>[port]</duraservicePort> <duraserviceContext>duraservice</duraserviceContext> <notificationConfig> <type>EMAIL</type> <username>[username for notification system]</username> <password>[password for notification system]</password> <originator>[from email address]</originator> <admin>[administrator email address]</admin> </notificationConfig> </durabossConfig>

• Response Code: 200 (on success)
• Response Body: "Initialization Successful" (on success)

Is Initialized

• Purpose: Performs a check to determine if the DuraBoss application has been initialized
• Request: GET https://host:port/duraboss/init^{Image Removed}
• Response Code: 200 (if the application has been initialized), 503 (if the application has NOT been initialized)
• Response Body: Text indicating whether initialization has occurred.

Get Latest Storage Report

• Purpose: Provides the most current storage report in XML format
• Request: GET https://host:port/duraboss/report/storage^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the storage report XSD

Get Storage Report List

• Purpose: Provides a list of all storage report IDs
• Request: GET https://host:port/duraboss/report/storage/list^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the storage report XSD

Get Storage Report

• Purpose: Provides a specific storage report based on the provided report ID
• Request: GET https://host:port/duraboss/report/storage/reportID^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the storage report XSD

Get Storage Report Info

• Purpose: Provides a information about the current status of the storage reporting system
• Request: GET https://host:port/duraboss/report/storage/info^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the storage report XSD

Start Storage Report

• Purpose: Starts a storage report if one is not already running
• Request: POST https://host:port/duraboss/report/storage^{Image Removed}
• Response Code: 200 (on success)
• Response Body: "Report Started" (on success), or ""Report Already In Progress" (if a report is already in progress)

Cancel Storage Report

• Purpose: Cancels a running storage report
• Request: DELETE https://host:port/duraboss/report/storage^{Image Removed}
• Response Code: 200 (on success)
• Response Body: "Storage report cancelled"

Schedule Storage Report

• Purpose: Schedules a time for a storage report to be run
• Request: POST https://host:port/duraboss/report/storage/schedule^{Image Removed} ? (startTime) (frequency)
  • startTime: time (in milliseconds since the epoch) to begin the next storage report
  • frequency: time (in milliseconds) to wait between running reports (minimum value is 600000)
• Response Code: 200 (on success)
• Response Body: "Storage reports scheduled" (on success)

Cancel Storage Report Schedule

• Purpose: Cancels all entries on the storage report schedule
• Request: DELETE https://host:port/duraboss/report/storage/schedule^{Image Removed}
• Response Code: 200 (on success)
• Response Body: "Storage Reports schedule cancelled"

Get Deployed Services Report

• Purpose: Provides a listing of the services which are currently deployed
• Request: GET https://host:port/duraboss/report/service/deployed^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the service report XSDs

Get Completed Services Report

• Purpose: Provides a listing of the most recent completed services
• Request: GET https://host:port/duraboss/report/service^{Image Removed} ? (limit)
  • Parameter value for limit (optional) should indicate the maximum number of services to return in the report (default is 20, max is 1000)
• Response Code: 200 (on success)
• Response Body: XML, defined by the service report XSDs

Get Completed Services Report List

• Purpose: Provides a listing of all service report IDs
• Request: GET https://host:port/duraboss/report/service/list^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the service report XSDs

Get Services Report

• Purpose: Provides a specific services report based on the provided report ID
• Request: GET https://host:port/duraboss/report/service/reportID^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML, defined by the service report XSDs

Get Executor Status

• Purpose: Provides a status of the Executor, which is the collected status of all Action Handlers
• Request: GET https://host:port/duraboss/exec^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML serialization of status map

Get Supported Executor Actions

• Purpose: Provides a listing of the actions which the Executor can perform
• Request: GET https://host:port/duraboss/exec/action^{Image Removed}
• Response Code: 200 (on success)
• Response Body: XML serialization of the action set

Executor Actions

Perform an Executor Action

• Purpose: Performs a specific Executor action based on the provided actionName
• Request: POST https://host:port/duraboss/exec/actionName^{Image Removed}
• Response Code: 200 (on success)

Shutdown Executor

• Purpose: Requests that the Executor perform a graceful shutdown
• Request: DELETE https://host:port/duraboss/exec^{Image Removed}
• Response Code: 200 (on success)

Create Initial Audit Log

• Purpose: Requests the creation of initial audit logs, and removal of any existing audit logs
• Request: POST https://host:port/duraboss/audit^{Image Removed}
• Response Code: 202 (on acceptance)

Get Audit Logs

• Purpose: Provides a listing of the audit logs for the provided spaceId
• Request: GET https://host:port/duraboss/audit/spaceId^{Image Removed}
• Response Code: 200 (on success)
• Response Body: Plain text listing of audit log contentIds

Shutdown Auditor

• Purpose: Requests that the Auditor perform a graceful shutdown
• Request: DELETE https://host:port/duraboss/audit^{Image Removed}
• Response Code: 200 (on success)
• Response Body: Plain text of "auditor shutting down"

Get Content Manifest

• Purpose: Requests the content manifest for the provided spaceId, in the requested format, as of the provided date, and for the provided storeID
• Request: GET https://host:port/duraboss/manifest/spaceId^{Image Removed} ? (format) & (date) & (storeID)
  • Parameter options for format (optional)
    1. tsv (default) - Produces content manifest in tab-separated-value format
    2. bagit - Produces content manifest in BagIt format
  • Parameter options for date (optional, current datetime is default)
    1. Any formatted date of the form: 'yyyy-MM-dd'T'HH:mm:ss.sss' or 'yyyy-MM' or any form in between these two
  • Parameter options for storeID (optional, default is primary store)
• Response Code: 200 (on success)
• Response Body: Plain text content manifest in the requested format