SGET: S3 GET

02/04/2024 Contributors

When an S3 client issues a GET transaction, a request is made to retrieve an object or list the objects in a bucket, or to remove a bucket/object subresource. 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.
CNCH	Consistency Control Header	The value of the Consistency-Control HTTP request header, if present in the request.
CNID	Connection Identifier	The unique system identifier for the TCP/IP connection.
CSIZ	Content Size	The size of the retrieved 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).
LITY	ListObjectsV2	A v2 format response was requested. For details, see AWS ListObjectsV2. For GET bucket operations only.
NCHD	Number of Children	Includes keys and common prefixes. For GET bucket operations only.
RANG	Range Read	For range read operations only. Indicates the range of bytes that was read by this request. The value after the slash (/) shows the size of the entire object.
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.
S3SR	S3 Subresource	The bucket or object subresource being operated on, if applicable.
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.
TRNC	Truncated or Not Truncated	Set to false if all results were returned. Set to true if more results are available to return. For GET bucket operations only.
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.

CNCH

Consistency Control Header

The value of the Consistency-Control HTTP request header, if present in the request.

CNID

Connection Identifier

The unique system identifier for the TCP/IP connection.

CSIZ

Content Size

The size of the retrieved 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).

LITY

ListObjectsV2

A v2 format response was requested. For details, see AWS ListObjectsV2. For GET bucket operations only.

NCHD

Number of Children

Includes keys and common prefixes. For GET bucket operations only.

RANG

Range Read

For range read operations only. Indicates the range of bytes that was read by this request. The value after the slash (/) shows the size of the entire object.

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.

S3SR

S3 Subresource

The bucket or object subresource being operated on, if applicable.

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.

TRNC

Truncated or Not Truncated

Set to false if all results were returned. Set to true if more results are available to return. For GET bucket operations only.

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.

SGET: S3 GET

Creating your file...