SHEA: S3 HEAD

04/19/2023 Contributors

When an S3 client issues a HEAD transaction, a request is made to check for the existence of an object or bucket and retrieve the metadata about an object. This message is issued by the server if the transaction is successful.

Code Field Description

Code	Field	Description
CBID	Content Block Identifier	The unique identifier of the content block requested. If the CBID is unknown, this field is set to 0. Operations on buckets don't include this field.
CNID	Connection Identifier	The unique system identifier for the TCP/IP connection.
CSIZ	Content Size	The size of the checked object in bytes. Operations on buckets don't include this field.
HTRH	HTTP Request Header	List of logged HTTP request header names and values as selected during configuration. `X-Forwarded-For` is automatically included if it is present in the request and if the `X-Forwarded-For` value is different from the request sender IP address (SAIP audit field).
RSLT	Result Code	Result of the GET transaction. Result is always: SUCS: Successful
S3AI	S3 tenant account ID (request sender)	The tenant account ID of the user who sent the request. An empty value indicates anonymous access.
S3AK	S3 Access Key ID (request sender)	The hashed S3 access key ID for the user that sent the request. An empty value indicates anonymous access.
S3BK	S3 Bucket	The S3 bucket name.
S3KY	S3 Key	The S3 key name, not including the bucket name. Operations on buckets don't include this field.
SACC	S3 tenant account name (request sender)	The name of the tenant account for the user who sent the request. Empty for anonymous requests.
SAIP	IP address (request sender)	The IP address of the client application that made the request.
SBAC	S3 tenant account name (bucket owner)	The tenant account name for the bucket owner. Used to identify cross-account or anonymous access.
SBAI	S3 tenant account ID (bucket owner)	The tenant account ID of the owner of the target bucket. Used to identify cross-account or anonymous access.
SUSR	S3 User URN (request sender)	The tenant account ID and the user name of the user making the request. The user can either be a local user or an LDAP user. For example: `urn:sgws:identity::03393893651506583485:root` Empty for anonymous requests.
TIME	Time	Total processing time for the request in microseconds.
TLIP	Trusted Load Balancer IP Address	If the request was routed by a trusted Layer 7 load balancer, the IP address of the load balancer.
UUID	Universally Unique Identifier	The identifier of the object within the StorageGRID system.
VSID	Version ID	The version ID of the specific version of an object that was requested. Operations on buckets and objects in unversioned buckets don't include this field.

CBID

Content Block Identifier

The unique identifier of the content block requested. If the CBID is unknown, this field is set to 0. Operations on buckets don't include this field.

CNID

Connection Identifier

The unique system identifier for the TCP/IP connection.

CSIZ

Content Size

The size of the checked object in bytes. Operations on buckets don't include this field.

HTRH

HTTP Request Header

List of logged HTTP request header names and values as selected during configuration.

X-Forwarded-For is automatically included if it is present in the request and if the X-Forwarded-For value is different from the request sender IP address (SAIP audit field).

RSLT

Result Code

Result of the GET transaction. Result is always:

SUCS: Successful

S3AI

S3 tenant account ID (request sender)

The tenant account ID of the user who sent the request. An empty value indicates anonymous access.

S3AK

S3 Access Key ID (request sender)

The hashed S3 access key ID for the user that sent the request. An empty value indicates anonymous access.

S3BK

S3 Bucket

The S3 bucket name.

S3KY

S3 Key

The S3 key name, not including the bucket name. Operations on buckets don't include this field.

SACC

S3 tenant account name (request sender)

The name of the tenant account for the user who sent the request. Empty for anonymous requests.

SAIP

IP address (request sender)

The IP address of the client application that made the request.

SBAC

S3 tenant account name (bucket owner)

The tenant account name for the bucket owner. Used to identify cross-account or anonymous access.

SBAI

S3 tenant account ID (bucket owner)

The tenant account ID of the owner of the target bucket. Used to identify cross-account or anonymous access.

SUSR

S3 User URN (request sender)

The tenant account ID and the user name of the user making the request. The user can either be a local user or an LDAP user. For example: urn:sgws:identity::03393893651506583485:root

Empty for anonymous requests.

TIME

Time

Total processing time for the request in microseconds.

TLIP

Trusted Load Balancer IP Address

If the request was routed by a trusted Layer 7 load balancer, the IP address of the load balancer.

UUID

Universally Unique Identifier

The identifier of the object within the StorageGRID system.

VSID

Version ID

The version ID of the specific version of an object that was requested. Operations on buckets and objects in unversioned buckets don't include this field.

SHEA: S3 HEAD

Creating your file...