Spectra Logic

1-800-833-1132 : 1-303-449-6400

Eject Storage Domain Blobs

Description

Ejects all tapes that are eligible to be ejected within the storage domain specified for the blob payload included. If a tape is in use, it is ejected once it is no longer in use.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/tape/?operation=EJECT&blobs &storage_domain_id={string}&bucket_id={string} [&eject_label={string}][&eject_location={string}]

Request Parameters

Parameter	Description	Required
operation	The operation to perform. For this request, the operation is eject. Value: EJECT	yes
blobs	When included, the request fails if the request payload is not also included.	yes
bucket_id	The UUID, name, or other unique attribute for a bucket from which to eject tapes. If a bucket is specified, the tapes in the storage domain which contain data for the specified bucket are ejected even if they contain data for other buckets.	yes
storage_domain_id	The UUID or other unique attribute for the storage domain from which to eject tapes.	yes
eject_label	Enter information to assist in the handling of the tape.	no
eject_location	Enter information to describe where the ejected tape can be located.	no

Request Elements

An optional XML payload, formatted as follows, must be sent to specify certain object parts to eject:

<Objects
   <Object Name="{string}" Length="{64-bit integer}"
      Offset="{64-bit integer}"/>
   ...
</Objects>

where the parameters are defined as follows:

Parameter	Description	Required
Objects	A container for the list of objects and object parts.	yes
Object	The container for information about one object or object part.	yes
Name	The name of an object to GET. All objects in the list must be in the same bucket.	yes
Length	The length in bytes to get.	no
Offset	The offset in bytes from the start of the object to start the get.	no

Responses

Response Elements

The operation returns status only.

Notable status codes:

§	204: No Content (success)

§	207: Multi-Status (with list of errors)

§	400: Bad Request (request payload not included)

Example

Sample Request

This request queues all eligible tapes in the storage domain with UUID 2a48ae2c-5c0e-47c4-a800-ec54aa4f7abc, assigned to “bucket1” and containing pieces of the object “Object1”, to be ejected.

PUT http://blackpearl-hostname/_rest_/tape/?operation=EJECT&blobs&bucket_id=bucket1&storage_domain_id=2a48ae2c-5c0e-47c4-a800-ec54aa4f7abc HTTP/1.1

<Objects
   <Object Name="Object1">
</Objects>

Sample Response

HTTP/1.1 204 No Content