Response body (GET object versions)

The body of the HTTP response to a GET request to list object versions contains an XML document listing the versions, in this format:

<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="/static/xsl/ns-versions.xsl"?>
<versions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="/static/xsd/ns-versions.xsd"
         path="object-path"
         utf8Path="utf8-object-path"
         parentDir="parent-directory-path"
         utf8ParentDir="utf8-parent-directory-path"
         deleted="true|false"
         showDeleted="true|false"
         namespaceName="namespace-name"
         utf8NamespaceName="utf8-namespace-name">
    <entry urlname="object-name"
             utf8Name="utf8-object-name"
             type="object"
             size="size-in-bytes"
             hashScheme="hash-algorithm"
             hash="hash-value"
             retention="retention-seconds-after-1/1/1970"
             retentionString="retention-datetime-value"
             retentionClass="[retention-class-name]"
             hold="true|false"
             shred="true|false"
             dpl="dpl"
             index="true|false"
             customMetadata="true|false"
             customMetadataAnnotations="semicolon-delimited list of annotations"
             replicated="true|false"
             owner="[username|nobody]"
             domain="[active-directory-domain]"
             hasAcl="true|false"
             state="created|deleted"
             version="version-id"
             ingestTime="ingested-seconds-after-1/1/1970"
             ingestTimeString="ingested-datetime"
             changeTimeMilliseconds="change-milliseconds-after-1/1/1970.unique-
               integer
"
             changeTimeString="yyyy-MM-ddThh:mm:ssZ"
    />
    .
    .
    .
</versions>

The deleted attribute of the versions element indicates whether the object is currently deleted. The value of the showDeleted attribute indicates whether the list includes deleted versions (true) or not (false).

The state attribute of the entry for each individual version specifies whether the version contains data or is a marker indicating that the object was deleted (that is, a deleted version).

The XML entry for a deleted version differs from the entry created when the deleted object was ingested in these ways:

The state value is deleted. (The state value for a version that contains data is created.)

The version value is different.

The ingestTime, ingestTimeString, changeTimeMilliseconds, and changeTimeString values are the date and time the object was deleted.

If the directory that contains the object contained at some time a subdirectory with the same name as the object, the results of a version list request that includes deleted versions shows deleted versions for both the object and the directory.

For example, assume you do the following:

1.Create a maintenance subdirectory of the departments directory.

2.Delete the maintenance directory.

3.Save a maintenance object in the departments directory.

In this case, a version listing for the maintenance entry that includes deleted versions shows these items:

An entry, with a version ID, for the deleted maintenance directory

Entries for all versions of the maintenance object, including any deleted version entries for the object

Version list entries for deleted directories look like this:

<entry urlname="object-name"
    utf8Name="utf8-object-name"
    type="directory"
    state="deleted"
    version=version-id"
    ingestTime="ingested-seconds-after-1/1/1970"
    ingestTimeString="ingested-datetime"
    changeTimeMilliseconds="change-millseconds-after-1/1/1970.unique-integer
    changeTimeString="yyyy-MM-ddThh:mm:ssZ"
/>

Trademarks and Legal Disclaimer

© 2017 Hitachi Data Systems Corporation. All rights reserved.