Spectra Logic

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

Eject Storage Domain

Description

Ejects all eligible tapes within the specified storage domain. If a tape is being used for a job, it is ejected once it is no longer in use.

Requests

Syntax

PUT http[s]://{datapathDNSname}/_rest_/tape/?operation=EJECT &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
storage_domain_id	The UUID or other unique attribute for the storage domain from which to eject tapes.	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.	no
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, can 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)

Example

Sample Request

This request queues all eligible tapes in the storage domain with UUID 2a48ae2c-5c0e-47c4-a800-ec54aa4f7abc to be ejected.

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

Sample Response

HTTP/1.1 204 No Content