libstorage.json

{
    "id": "https://github.com/codedellemc/libstorage",
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "libStorage JSON Schema",
    "definitions": {


        "volume": {
            "title": "Volume",
            "description": "Volume provides information about a storage volume.",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string",
                    "description": "ID is a piece of information that uniquely identifies the volume on the storage platform to which the volume belongs. A volume ID is not guaranteed to be unique across multiple, configured services."
                },
                "name": {
                    "type": "string",
                    "description": "The volume name."
                },
                "type": {
                    "type": "string",
                    "description": "The volume type."
                },
                "attachments": {
                    "type": "array",
                    "description": "The volume's attachments.",
                    "items": { "$ref": "#/definitions/volumeAttachment" }
                },
                "attachmentState": {
                    "type": "number",
                    "description": "Indicates the volume's attachment state - 0=none,1=unknown,2=attached,3=available,4=unavailable. A volume is marked as attached if attached to the instance specified in the requesting API call. A volume that is attached but not to the requesting instance is marked as unavailable.",
                    "minimum": 0,
                    "maximum": 4
                },
                "availabilityZone": {
                    "type": "string",
                    "description": "The zone for which the volume is available."
                },
                "encrypted": {
                    "type": "boolean",
                    "description": "A flag indicating whether or not the volume is encrypted."
                },
                "iops": {
                    "type": "number",
                    "description": "The volume IOPs."
                },
                "networkName": {
                    "type": "string",
                    "description": "The name of the network on which the volume resides."
                },
                "size": {
                    "type": "number",
                    "description": "The volume size (GB)."
                },
                "status": {
                    "type": "string",
                    "description": "The volume status."
                },
                "fields": { "$ref": "#/definitions/fields" }
            },
            "required": [ "id", "name" ],
            "additionalProperties": false
        },


        "volumeAttachment": {
            "title": "VolumeAttachment",
            "description": " VolumeAttachment provides information about an object attached to a storage volume.",
            "type": "object",
            "properties": {
                "instanceID": { "$ref": "#/definitions/instanceID" },
                "deviceName": {
                    "type": "string",
                    "description": "The name of the device on to which the volume is mounted."
                },
                "status": {
                    "type": "string",
                    "description": "The status of the attachment."
                },
                "volumeID": {
                    "type": "string",
                    "description": "The ID of the volume to which the attachment belongs."
                },
                "mountPoint": {
                    "type": "string",
                    "description": "The file system path to which the volume is mounted."
                },
                "fields": { "$ref": "#/definitions/fields" }
            },
            "required": [ "instanceID", "deviceName", "volumeID" ],
            "additionalProperties": false
        },


        "instanceID": {
            "title": "InstanceID",
            "description": "InstanceID identifies a host to a remote storage platform.",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string",
                    "description": "The instance ID."
                },
                "driver": {
                    "type": "string",
                    "description": "The name of the driver that created the instance ID."
                },
                "service": {
                    "type": "string",
                    "description": "The name of the service for which the instance ID is valid."
                },
                "formatted": {
                    "type": "boolean",
                    "description": "A flag indicating whether or not the instance ID has been formatted by an instance inspection."
                },
                "metadata": {
                    "type": "object",
                    "description": "Extra information about the instance ID."
                }
            },
            "required": [ "id", "driver" ],
            "additionalProperties": false
        },


        "instance": {
            "title": "Instance",
            "description": "Instance is additional information about a host, generated using the InstanceID.",
            "type": "object",
            "properties": {
                "instanceID": { "$ref": "#/definitions/instanceID" },
                "name": {
                    "type": "string",
                    "description": "The name of the instance."
                },
                "providerName": {
                    "type": "string",
                    "description": "The name of the provider that owns the object."
                },
                "region": {
                    "type": "string",
                    "description": "The region from which the object originates."
                },
                "fields": { "$ref": "#/definitions/fields" }
            },
            "required": [ "id" ],
            "additionalProperties": false
        },


        "snapshot": {
            "title": "Snapshot",
            "description": "Snapshot provides information about a storage volume snapshot.",
            "type": "object",
            "properties": {
                "id": {
                    "type": "string",
                    "description": "The snapshot's ID."
                },
                "name": {
                    "type": "string",
                    "description": "The name of the snapshot."
                },
                "description": {
                    "type": "string",
                    "description": "A description of the snapshot."
                },
                "encrypted": {
                    "type": "boolean",
                    "description": "A flag indicating whether or not the snapshot is encrypted."
		},
                "startTime": {
                    "type": "number",
                    "description": "The time (epoch) at which the request to create the snapshot was submitted."
                },
                "status": {
                    "type": "string",
                    "description": "The status of the snapshot."
                },
                "volumeID": {
                    "type": "string",
                    "description": "The ID of the volume to which the snapshot belongs."
                },
                "volumeSize": {
                    "type": "number",
                    "description": "The size of the volume to which the snapshot belongs."
                },
                "fields": { "$ref": "#/definitions/fields" }
            },
            "required": [ "id" ],
            "additionalProperties": false
        },


        "task": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "number",
                    "description": "The task's unique identifier."
                },
                "name": {
                    "type": "string",
                    "description": "The name of the task."
                },
                "user": {
                    "type": "string",
                    "description": "The name of the user that created the task."
                },
                "completeTime": {
                    "type": "number",
                    "description": "The time stamp (epoch) when the task was completed."
                },
                "queueTime": {
                    "type": "number",
                    "description": "The time stamp (epoch) when the task was created."
                },
                "startTime": {
                    "type": "number",
                    "description": "The time stamp (epoch) when the task started running."
                },
                "result": {
                    "type": "object",
                    "description": "The result of the operation."
                },
                "error": {
                    "type": "object",
                    "description": "If the operation returned an error, this is it."
                },
                "fields": { "$ref": "#/definitions/fields" }
            },
            "required": [ "id", "name",  "user", "queueTime" ],
            "additionalProperties": false
        },


        "serviceInfo": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Name is the service's name."
                },
                "instance": { "$ref": "#/definitions/instance" },
                "driver": { "$ref": "#/definitions/driverInfo" }
            },
            "required": [ "name", "driver" ],
            "additionalProperties": false
        },


        "driverInfo": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Ignore is a flag that indicates whether the client logic should invoke the GetNextAvailableDeviceName function prior to submitting an AttachVolume request to the server."
                },
                "type": {
                    "type": "string",
                    "description": "Type is the type of storage the driver provides: block, nas, object."
                },
                "nextDevice": { "$ref": "#/definitions/nextDeviceInfo" }
            },
            "required": [ "name", "type" ],
            "additionalProperties": false
        },


        "nextDeviceInfo": {
            "type": "object",
            "properties": {
                "ignore": {
                    "type": "boolean",
                    "description": "Ignore is a flag that indicates whether the client logic should invoke the GetNextAvailableDeviceName function prior to submitting an AttachVolume request to the server."
                },
                "prefix": {
                    "type": "string",
                    "description": "Prefix is the first part of a device path's value after the \"/dev/\" portion. For example, the prefix in \"/dev/xvda\" is \"xvd\"."
                },
                "pattern": {
                    "type": "string",
                    "description": "Pattern is the regex to match the part of a device path after the prefix."
                }
            },
            "additionalProperties": false
        },


        "fields": {
            "type": "object",
            "description": "Fields are additional properties that can be defined for this type.",
            "patternProperties": {
                ".+": { "type": "string" }
            },
            "additionalProperties": true
        },


        "volumeMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/volume" }
            },
            "additionalProperties": false
        },


        "snapshotMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/snapshot" }
            },
            "additionalProperties": false
        },


        "taskMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/task" }
            },
            "additionalProperties": false
        },


        "serviceVolumeMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/volumeMap" }
            },
            "additionalProperties": false
        },


        "serviceSnapshotMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/snapshotMap" }
            },
            "additionalProperties": false
        },


        "serviceTaskMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/taskMap" }
            },
            "additionalProperties": false
        },


        "serviceInfoMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/serviceInfo" }
            },
            "additionalProperties": false
        },


        "driverInfoMap": {
            "type": "object",
            "patternProperties": {
                "^.+$": { "$ref": "#/definitions/driverInfo" }
            },
            "additionalProperties": false
        },


        "opts": {
            "type": "object",
            "description": "Opts are additional properties that can be defined for POST requests.",
            "patternProperties": {
                "^.+$": {
                    "anyOf": [
                        { "type": "array" },
                        { "type": "boolean" },
                        { "type": "integer" },
                        { "type": "number" },
                        { "type": "null" },
                        { "type": "string" },
                        { "$ref": "#/definitions/opts" }
                    ]
                }
            },
            "additionalProperties": true
        },


        "volumeCreateRequest": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string"
                },
                "availabilityZone": {
                    "type": "string"
                },
                "encrypted": {
                    "type": "boolean"
                },
                "encryptionKey": {
                    "type": "string"
                },
                "iops": {
                    "type": "number"
                },
                "size": {
                    "type": "number"
                },
                "type": {
                    "type": "string"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "required": [ "name" ],
            "additionalProperties": false
        },


        "volumeCopyRequest": {
            "type": "object",
            "properties": {
                "volumeName": {
                    "type": "string"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "required": [ "volumeName" ],
            "additionalProperties": false
        },


        "volumeSnapshotRequest": {
            "type": "object",
            "properties": {
                "snapshotName": {
                    "type": "string"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "required": [ "snapshotName" ],
            "additionalProperties": false
        },


        "volumeAttachRequest": {
            "type": "object",
            "properties": {
                "nextDeviceName": {
                    "type": "string"
                },
                "force": {
                    "type": "boolean"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "additionalProperties": false
        },


        "volumeAttachResponse": {
            "type": "object",
            "properties": {
                "volume": { "$ref" : "#/definitions/volume" },
                "attachToken" : { "type": "string" }
            },
            "required": [ "volume", "attachToken" ],
            "additionalProperties": false
        },


        "volumeDetachRequest": {
            "type": "object",
            "properties": {
                "force": {
                    "type": "boolean"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "additionalProperties": false
        },


        "snapshotCopyRequest": {
            "type": "object",
            "properties": {
                "snapshotName": {
                    "type": "string"
                },
                "destinationID": {
                    "type": "string"
                },
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "required": [ "snapshotName", "destinationID" ],
            "additionalProperties": false
        },


        "snapshotRemoveRequest": {
            "type": "object",
            "properties": {
                "opts": { "$ref" : "#/definitions/opts" }
            },
            "additionalProperties": false
        },


        "error": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string",
                    "pattern": "^.{10,}|.*[Ee]rror$"
                },
                "status": {
                    "type": "number",
                    "minimum": 400,
                    "maximum": 599
                },
                "error": {
                    "type": "object",
                    "additionalProperties": true
                }
            },
            "required": [ "message", "status" ],
            "additionalProperties": false
        }
    }
}