Retrieve sync replication Headers of object

Returns details about an object. This request returns the same header information as the Get Object request, but includes only the metadata, excluding the object data payload.

Use the following command to retrieve the current version of the object:

HEAD /BUCKET/OBJECT HTTP/1.1

Add the versionId subresource to the command to retrieve information for a particular version.

HEAD /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1

Table 1. Request headers
Request header	Description	Valid values	Required
`range`	The range of the object to retrieve.	Range: bytes=beginbyte-endbyte	No
`if-modified-since`	Gets only if modified since the timestamp.	Timestamp	No
`if-match`	Gets only if object ETag matches ETag.	Entity tag	No
`if-none-match`	Gets only if object ETag matches ETag.	Entity tag	No

Response headers

Table 2. HEAD response headers
Response header	Description
`x-amz-version-id`	Returns the version ID or null.
`x-rgw-replicated-from`	Returns the source zone and any intermediate zones involved in an object's replication path within a Ceph multi-zone environment. This header is included in GetObject and HeadObject responses.
`x-rgw-replicated-at`	Returns a timestamp indicating when the object was replicated to its current location. You can calculate the duration for replication to complete by using this header with Last-Modified header.

Note: As of now, x-rgw-replicated-from and x-rgw-replicated-at are supported by client tools like s3cmd or curl verify at the replicated zone. These tools can be used in addition to radosgw-admin command for verification. With radosgw-admin object stat we have a known issue [BZ-2312552] of missing header key x-rgw-replicated-from.