Drives

Drive API Method Specifications

API method: /drive/new

Specification

This API creates a new drive from the specified external storage service. On success, the requesting user has permissions to perform tasks associated with the external storage.

Inputs

• name string name of the drive

• cloud string (azure or aws): Drive cloud provider

• credentials

Outputs

• id string id of the created drive

Errors

• Unauthorized

  • Must supply authentication token

• InvalidInput

  • The input is not a hash

API method: /drive-xxxx/disable

Specification

This API disables a drive. The requesting user must have permissions to use the drive.

Outputs

• id string id of the disabled drive

Errors

• Unauthorized

  • Must supply authentication token

• ResourceNotFound

  • The entity drive-xxxx could not be found

API method: /drive-xxxx/update

Specification

Updates information about a drive. The requesting user must have permissions to use the drive.

Inputs

• name string (optional): New user specified name of drive

• credentials mapping (optional): New credentials associated with the drive

  • key string credential field

Outputs

• id string ID of the updated drive

Errors

• Unauthorized

  • Must supply authentication token

• InvalidInput

  • The input is not a hash

API method: /drive-xxxx/describe

Specification

• Describes a drive.

Inputs

• fields mapping (optional): Include or exclude fields from the output.

  • key string Desired output field (see the "Outputs" section below for valid values)

  • value boolean Whether to include the field

Outputs

• id string ID of the drive

• name string name of the drive

• cloud string cloud provider of the drive

Errors

• Unauthorized

  • Must supply authentication token

• InvalidInput

  • The input is not a hash