Home > Storage > PowerScale (Isilon) > Product Documentation > Protocols > Dell PowerScale: OneFS S3 API Guide > HeadObject
This API retrieves metadata from an object without returning the object data. Table 19 shows the details about the OneFS S3 HeadObject API request parameters and request body. If not specified, OneFS silently ignores all unsupported request parameters and the request body, without returning an error code to the client.
Request parameters/body | Supported | Description |
Bucket | Yes | Required: Yes This is the bucket name containing the object. |
If-Match | Yes | This returns the object only if its ETag is the same as the one specified. Otherwise, this returns a 412 code (precondition failed). |
If-Modified-Since | Yes | This returns the object only if it has been modified since the specified time. Otherwise, this returns a 304 code (not modified). |
If-None-Match | Yes | This returns the object only if its ETag is different from the one specified. Otherwise, this returns return a 304 code (not modified). |
If-Unmodified-Since | Yes | This returns the object only if it has not been modified since the specified time. Otherwise, this returns a 412 code (precondition failed). |
Key | Yes | Required: Yes This is the key of the object to get. |
partNumber | Yes | Before OneFS 9.5.0, a 510 NotImplemented code is returned. Starting from OneFS 9.5.0, partNumber=1 is supported. |
Range | Yes | This gets the specified range bytes of an object. See article RFC2616 for more information about the HTTP Range header. |
versionId | No | N/A |
x-amz-request-payer | No | N/A |
x-amz-server-side-encryption-customer-algorithm | No | N/A |
x-amz-server-side-encryption-customer-key | No | N/A |
x-amz-server-side-encryption-customer-key-MD5 | No | N/A |