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 delete markers (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 delete marker).

The XML entry for a delete marker 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 delete markers shows delete markers 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 delete markers shows these items:

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

Entries for all versions of the maintenance object, including any delete marker 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"
/>

© 2015, 2020 Hitachi Vantara LLC. All rights reserved.