Object Storage log reference
Written by
Updated at March 19, 2025
This section describes the log fields delivered by a bucket.
Object Storage logs are stored in JSON format. A single log entry represents one request to a bucket.
For more information, see Bucket logging.
Log fields
Field | Type | Description |
---|---|---|
bucket |
String | Bucket name. |
bytes_received |
Int64 | Request size in bytes. |
bytes_send |
Int64 | Response size in bytes. |
handler |
String | Request method in this format: REST.<HTTP method>.<subject> . |
http_referer |
String | URL of the request source. |
ip |
String | User IP address. |
method |
String | HTTP request method. |
object_key |
String | Object key in URL-encoded |
protocol |
String | Data transfer protocol version. |
range |
String | HTTP header that defines the range of bytes to load from the object. |
requester |
String | User ID. |
request_args |
String | Arguments of the URL request. |
request_id |
String | Request ID. |
request_path |
String | Full path of the request. |
request_time |
Int64 | Request processing time in milliseconds. |
scheme |
String | Data transfer protocol type. The possible values are: - http : Application layer protocol.- https : Application layer protocol with encryption support. |
ssl_protocol |
String | Security protocol. |
status |
Int64 | HTTP response code. |
storage_class |
String | Storage class of the object. |
timestamp |
String | Date and time of the bucket operation in YYYY-MM-DDTHH:MM:MMZ format. |
user_agent |
String | Client application (user agent) that run the request. |
version_id |
String | Object version. |
vhost |
String | Virtual host of the request. The possible values are: – storage.yandexcloud.net – <bucket_name>.storage.yandexcloud.net .– website.yandexcloud.net – <bucket_name>.website.yandexcloud.net . |
Bucket request methods
HTTP method | Subject | Description |
---|---|---|
GET |
SERVICE |
Listing available buckets. |
GET |
LOCATION |
Getting the region where the bucket resides. |
PUT |
BUCKET |
Creating a bucket. |
HEAD |
BUCKET |
Getting bucket metadata. |
GET |
BUCKET |
Listing bucket objects (previous method version). |
GET |
BUCKET_V1EXT |
Listing bucket objects (previous extended method version). |
GET |
BUCKET_V2 |
Listing bucket objects (current method version). |
DELETE |
BUCKET |
Deleting a bucket. |
OPTIONS |
BUCKET |
Checking whether a CORS request to a bucket can be made. |
GET |
BUCKETVERSIONS |
Getting metadata for all versions of bucket objects. |
GET |
VERSIONING |
Getting the bucket versioning status. |
PUT |
VERSIONING |
Enabling or suspending bucket versioning. |
PUT |
BUCKET_ACL |
Uploading the access control list for a bucket. |
GET |
BUCKET_ACL |
Getting the access control list for a bucket. |
PUT |
BUCKET_CORS |
Uploading a CORS configuration for a bucket. |
GET |
BUCKET_CORS |
Getting a CORS configuration for a bucket. |
DELETE |
BUCKET_CORS |
Deleting a CORS configuration for a bucket. |
PUT |
BUCKET_LIFECYCLE |
Uploading a bucket object lifecycle configuration. |
GET |
BUCKET_LIFECYCLE |
Getting a bucket object lifecycle configuration. |
DELETE |
BUCKET_LIFECYCLE |
Deleting a bucket object lifecycle configuration. |
PUT |
BUCKET_ENCRYPTION |
Enabling bucket encryption. |
GET |
BUCKET_ENCRYPTION |
Getting information about bucket encryption. |
DELETE |
BUCKET_ENCRYPTION |
Disabling bucket encryption. |
PUT |
BUCKET_WEBSITES |
Uploading a static website hosting configuration for a bucket. |
GET |
BUCKET_WEBSITES |
Getting a static website hosting configuration for a bucket. |
DELETE |
BUCKET_WEBSITES |
Deleting a static website hosting configuration for a bucket. |
GET |
BUCKET_LOGGING |
Getting settings for bucket logging. |
PUT |
BUCKET_LOGGING |
Enabling and disabling bucket logging. |
PUT |
BUCKETPOLICY |
Applying a bucket policy to the specified bucket. |
GET |
BUCKETPOLICY |
Getting a bucket policy for the specified bucket. |
DELETE |
BUCKETPOLICY |
Deleting a bucket policy for the specified bucket. |
PUT |
BUCKET_TAGGING |
Setting labels for a bucket. |
GET |
BUCKET_TAGGING |
Getting bucket labels. |
DELETE |
BUCKET_TAGGING |
Deleting bucket labels. |
PUT |
OBJECT |
Uploading an object and its metadata to a bucket. |
POST |
OBJECT |
Uploading an object and its metadata to a bucket via an HTML form. |
POST |
OBJECT_RESTORE |
Restoring a bucket object from an archive; not supported by Object Storage. |
PUT |
OBJECT_COPY |
Creating a bucket object copy. |
DELETE |
OBJECT |
Deleting an object. |
DELETE |
MULTIPLE_OBJECTS |
Deleting objects based on a list of keys provided in a request. |
HEAD |
OBJECT |
Getting object metadata. |
GET |
OBJECT |
Getting an object from a bucket. |
OPTIONS |
OBJECT |
Checking whether a CORS request to an object can be made. |
GET |
OBJECT_ACL |
Getting the access control list for an object. |
PUT |
OBJECT_ACL |
Uploading the access control list for an object. |
SELECT |
OBJECT_CONTENT |
Filtering and getting the contents of an object based using an S3 Select query. |
PUT |
OBJECT_TAGGING |
Setting labels for an object. |
GET |
OBJECT_TAGGING |
Getting object labels. |
DELETE |
OBJECT_TAGGING |
Deleting object labels. |
GET |
MULTIPART |
Listing current multipart uploads. |
POST |
INIT_MULTIPART |
Getting the ID to use for further operations with an object multipart upload. |
POST |
COMPLETE_MULTIPART |
Completing an object multipart upload. |
DELETE |
ABORT_MULTIPART |
Aborting a multipart upload and deleting from a bucket all object parts that have already been saved. |
PUT |
UPLOAD_PART |
Saving an object part. |
PUT |
UPLOAD_PART_COPY |
Copying an object part. |
GET |
UPLOAD_PART |
Listing uploaded object parts for the specified multipart upload. |