Spectra Logic

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

Eject Storage Domain

Description

Ejects all eligible tapes within the specified storage domain. Tapes are not eligible for ejection if mediaEjectionAllowed=FALSE for the storage domain (see media_ejection_ allowed). 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 tapes.	no
eject_location	Enter information to describe where the ejected tapes can be located.	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