Checking the existence of an object or multiple versions of an object request-specific response headers

The table below describes request-specific response headers returned for this operation. For information on all HCP-specific response headers, seeHCP-specific HTTP response headers.

Header Description

ChangeTimeString

The change time for the object in this format:

DDD, ddmmmyyyyhh:mm:ss GMT

For example, Fri, 14 Dec 2012 21:02:13 GMT.

This header contains the same datetime value as the X-HCP-ChangeTimeMilliseconds and X-HCP-ChangeTimeString headers, but in a format that can be used directly in If-Modified-Since and If-Unmodified-Since request headers.

ETag

The ETag of the object or version enclosed in double quotation marks ("). This header is returned only if the object has an ETag.

X-HCP-ACL

A true or false value indicating whether the object has an ACL.

X-HCP- ChangeTimeMilliseconds

The change time for the object, in milliseconds since January 1, 1970, at 00:00:00 UTC, followed by an integer that’s unique for the change time (for example, 1336483100178.00).

For information on object change times, see Object ingest time and change time.

X-HCP-ChangeTimeString

The change time for the object in this format:

yyyy-MM-ddThh:mm:ssZ

In this format, Z represents the offset from UTC and is specified as:

(+|-)hhmm

For example, 2012-05-08T09:18:20-0400 represents the start of the 20th second into 9:18 AM, May 8, 2012, EDT.

X-HCP-
CurrentStorageNode

The IP address of a node on which object data is stored. You may get better performance retrieving an object if you use this IP address in the GET request for the object instead of using a hostname in the request URL. For moe information on this header, see Retrieving an object or multiple versions of an object.

HCP returns this header only if configured to do so.

X-HCP-Custom-Metadata

A true or false value indicating whether the object has any annotations.

X-HCP-CustomMetadata
Annotations

A comma-and-space-separated list containing the names and sizes of all object annotations. Each entry in the list consists of the annotation name, a semicolon (;) and the annotation size in bytes, like this: report_data; 12908.

This header is returned only if X-HCP-Custom-Metadata is true.

X-HCP-Domain

The Active Directory domain that contains the user identified by the X-HCP-Owner header.

This value is an empty string if the X-HCP-Owner header identifies a user account defined in HCP or if the object has no owner.

If the X-HCP-Owner header returns a user account ID or nobody, the value of the X-HCP-Domain header is one of several invalid domains that begin with the percent sign (%). These values have meanings internal to the HCP system.

X-HCP-DPL

The data protection level for the object.

X-HCP-GID

The POSIX group ID for the object.

For objects added through the NFS protocol, this value is determined by the NFS client.

This value is an empty string if either of these are true:

The object was added through a protocol other than NFS and neither the UID nor the GID for the object has been changed.

The HCP-specific owner of the object was changed.

X-HCP-Hash

The cryptographic hash algorithm HCP uses, along with the cryptographic hash value stored for the object, in this format:

X-HCP-Hash: hash-algorithmhash-value

You can use the returned hash value to verify that the stored data is the same as the data you sent. To do this, compare this value with a hash value that you generate from the original data.

X-HCP-Index

A true or false value indicating whether the object is marked for indexing.

X-HCP-IngestProtocol

The namespace access protocol through which the object was added to the namespace. Possible values are:

CIFS_NFS

HTTP

SMTP

WebDAV

If HCP cannot determine the protocol through which the object was added, this value is UNKNOWN.

X-HCP-IngestTime

The time when HCP stored the object, in seconds since January 1, 1970, at 00:00:00 UTC.

X-HCP-LastVersionId The version ID of the last returned object version.

X-HCP-Owner

The user that owns the object.

This value is an empty string if the object has no owner.

This value is nobody for objects that were stored by an authenticated user before the HCP system was upgraded from a release earlier than 5.0. These objects effectively have no owner.

This value is a user account ID if HCP can no longer identify the object owner by username. For example, you would see a user account ID if the HCP user account has been deleted.

X-HCP-Replicated

A true or false value indicating whether the object has been replicated. The value is true only if the current version of the object and all its metadata, including any custom metadata and ACL, have been replicated.

X-HCP- ReplicationCollision

A true or false value indicating whether the object is flagged as a replication collision.

X-HCP-Retention

The end of the retention period for the object. Possible values are:

A time in seconds since January 1, 1970, at 00:00:00 UTC

0

-1

-2

X-HCP-RetentionClass

The name of the retention class to which the object belongs. This value is an empty string if the object is not in a retention class.

X-HCP-RetentionHold

A true or false value indicating whether the object is on hold.

X-HCP-RetentionString

The end of the retention period for the object. Possible values are:

A date and time in this format:

yyyy-MM-ddThh:mm:ssZ

In this format, Z represents the offset from UTC and is specified as:

(+|-)hhmm

For example, 2015-11-16T14:27:20-0500 represents the start of the 20th second into 2:27 PM, November 16, 2015, EST.

Deletion Allowed

Deletion Prohibited

Initial Unspecified

X-HCP-Shred

A true or false value indicating whether HCP will shred the object after the object is deleted.

X-HCP-Size

The size of the object data, in bytes.

X-HCP-SoftwareVersion

The version number of the HCP software.

X-HCP-SymlinkTarget

The path to the target object as specified when the symbolic link was created.

This header is returned only if the URL specifies a symbolic link to an object.

X-HCP-Type

The object entity type. This is always object for objects and versions of objects.

X-HCP-UID

The POSIX user ID for the object.

For objects added through the NFS protocol, this value is determined by the NFS client.

This value is an empty string if either of these are true:

The object was added through a protocol other than NFS and neither the UID nor the GID for the object has been changed.

The HCP-specific owner of the object was changed.

X-HCP-VersionId

The version ID of the object.

Trademark and LegalDisclaimer

© 2015 Hitachi Data Systems Corporation. All rights reserved.