Skip to main content

SPUT: S3 PUT

Contributors netapp-pcarriga

When an S3 client issues a PUT transaction, a request is made to create a new object or bucket, or to remove a bucket/object subresource. This message is issued by the server if the transaction is successful.

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.

CMPS

Compliance Settings

The compliance settings used when creating the bucket, if present in the request (truncated to the first 1024 characters).

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.

GFID

Grid Federation Connection ID

The connection ID of the grid federation connection associated with a cross-grid replication PUT request. Only included in audit logs on the destination grid.

GFSA

Grid Federation Source Account ID

The account ID of the tenant on the source grid for a cross-grid replication PUT request. Only included in audit logs on the destination grid.

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).

x-amz-bypass-governance-retention is automatically included if it is present in the request.

LKEN

Object Lock Enabled

Value of the request header x-amz-bucket-object-lock-enabled, if present in the request.

LKLH

Object Lock Legal Hold

Value of the request header x-amz-object-lock-legal-hold, if present in the PutObject request.

LKMD

Object Lock Retention Mode

Value of the request header x-amz-object-lock-mode, if present in the PutObject request.

LKRU

Object Lock Retain Until Date

Value of the request header x-amz-object-lock-retain-until-date, if present in the PutObject request. Values are limited to within 100 years of the date the object was ingested.

MTME

Last Modified Time

The Unix timestamp, in microseconds, indicating when the object was last modified.

RSLT

Result Code

Result of the PUT 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.

SRCF

Subresource Configuration

The new subresource configuration (truncated to the first 1024 characters).

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.

ULID

Upload ID

Included only in SPUT messages for CompleteMultipartUpload operations. Indicates that all parts have been uploaded and assembled.

UUID

Universally Unique Identifier

The identifier of the object within the StorageGRID system.

VSID

Version ID

The version ID of a new object created in a versioned bucket. Operations on buckets and objects in unversioned buckets don't include this field.

VSST

Versioning State

The new versioning state of a bucket. Two states are used: "enabled" or "suspended." Operations on objects don't include this field.