HP StoreEver ESL G3 Tape Libraries - Manual (Page 25)

Parameters N/A
Response Code 200, 401, 404, and 500
XML Response See “URI: aml/enum/{component}/element}” (page 74) for the XML Response
code.
URI: aml/media
Method GET
Description Retrieve the media resource instances.
Media Type Request: N/A
Response: application/xml and application/json
Parameters Query parameters are partition, location, start, length, frame, rack, and have
the following values:
•
partition —partition name
•
location —storage, drive, ie, or xie
Range parameters:
•
start —0-n
•
length —1-n or -1 for all media
•
frame —0–maximum number of frames
•
rack —1 or 2
To retrieve media:
•
aml/media?start=0&length=-1 —retrieve all media in one call
(default if no range is specified).
•
aml/media?partition=TEST —retrieve all media belonging to
partition named TEST.
•
aml/media?location=ie —retrieve all media in IE stations.
•
aml/media?partition=TEST&start=0&length=50 —retrieve the
first 50 media belonging to partition TEST.
NOTE: When using the range parameters, the media are sorted by their
barcodes.
Response Code 200, 401, 403, 404, and 500
XML Response See “URI: aml/media” (page 75) for the XML Response code.
URI: aml/media/operations/moveMedium
Method POST
Description Move a media from its source coordinate to the destination element
coordinate which must be empty, and can be any element type storage,
drive, ie, or extended ie.
If you want the partition involved in the move operation taken offline
before the move and turned back online after the move (if it was
previously online) then set the mode element to 2.
It is not necessary to take the partition offline and then back online since
the host will be notified that there was an inventory change when a
media is moved to/from a partition. To keep the partition online during
the move operation, set the mode element to 0 or 1.
URI: aml/media 25