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

Eject Storage Domain Blobs

Description

Ejects all tapes that are eligible to be ejected within the specified storage domain for the included blob payload. Tapes are not eligible for ejection if secure_media_allocation=true for the storage domain (see secure_media_ allocation). 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​&bucket_id={string}&storage_domain_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. 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	The name, 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 tapes.	no
eject_location	Enter information to describe where the ejected tapes can be located.	no

Request Elements

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

<Objects>
   <Object Name="{string}" Version_Id="{string}/>
</Objects>

where the parameters are defined as follows:

Parameter	Description	Required
Objects	A container for the list of objects.	yes
Object	The container for information about one object or object part.	yes
Name	The name of an object to eject. All objects in the list must be in the same bucket.	yes
Version_Id	The UUID for the version of the object.	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