Object Storage API, gRPC: BucketService.GetStats
Returns the statistics for the specified bucket.
gRPC request
rpc GetStats (GetBucketStatsRequest) returns (BucketStats)
GetBucketStatsRequest
{
"name": "string"
}
|
Field |
Description |
|
name |
string Required field. Name of the bucket to return the statistics for. |
BucketStats
{
"name": "string",
"max_size": "google.protobuf.Int64Value",
"used_size": "int64",
"storage_class_max_sizes": [
{
"storage_class": "string",
"class_size": "google.protobuf.Int64Value"
}
],
"storage_class_used_sizes": [
{
"storage_class": "string",
"class_size": "int64"
}
],
"storage_class_counters": [
{
"storage_class": "string",
"counters": {
"simple_object_size": "int64",
"simple_object_count": "int64",
"objects_parts_size": "int64",
"objects_parts_count": "int64",
"multipart_objects_size": "int64",
"multipart_objects_count": "int64",
"active_multipart_count": "int64"
}
}
],
"default_storage_class": "google.protobuf.StringValue",
"anonymous_access_flags": {
"read": "google.protobuf.BoolValue",
"list": "google.protobuf.BoolValue",
"config_read": "google.protobuf.BoolValue"
},
"created_at": "google.protobuf.Timestamp",
"updated_at": "google.protobuf.Timestamp"
}
A bucket statistics resource.
|
Field |
Description |
|
name |
string Name of the bucket. |
|
max_size |
Maximum size of the bucket, in bytes. |
|
used_size |
int64 Size of used space in the bucket, in bytes. |
|
storage_class_max_sizes[] |
Size of available space in the bucket by storage class, in bytes. |
|
storage_class_used_sizes[] |
Size of used space in the bucket by storage class, in bytes. |
|
storage_class_counters[] |
Object-related statistics by storage class and type of upload (simple vs. multipart), in bytes. |
|
default_storage_class |
Default storage class for objects in the bucket. Supported classes are standard storage ( |
|
anonymous_access_flags |
Flags for configuring public (anonymous) access to the bucket's content and settings. |
|
created_at |
Bucket creation timestamp. |
|
updated_at |
Bucket latest update timestamp. |
OptionalSizeByClass
A resource for size of available space in a bucket for a storage class.
|
Field |
Description |
|
storage_class |
string Storage class. Supported classes are standard storage ( |
|
class_size |
Size of available space in the bucket for the storage class. |
SizeByClass
A resource for size of used space in a bucket for a storage class.
|
Field |
Description |
|
storage_class |
string Storage class. Supported classes are standard storage ( |
|
class_size |
int64 Size of used space in the bucket for the storage class. |
CountersByClass
A resource for object-related statistics for a storage class by type of upload (simple vs. multipart).
|
Field |
Description |
|
storage_class |
string Storage class. Supported classes are standard storage ( |
|
counters |
Object-related statistics for the storage class by type of upload. |
Counters
|
Field |
Description |
|
simple_object_size |
int64 Total size of objects uploaded in single operation, in bytes. |
|
simple_object_count |
int64 Number of objects uploaded in single operation. |
|
objects_parts_size |
int64 Total size of uploaded parts in incomplete multipart uploads, in bytes. |
|
objects_parts_count |
int64 Number of uploaded parts in incomplete multipart uploads. |
|
multipart_objects_size |
int64 Total size of objects uploaded in multiple parts, in bytes. |
|
multipart_objects_count |
int64 Number of objects uploaded in multiple parts. |
|
active_multipart_count |
int64 Number of incomplete multipart uploads. |
AnonymousAccessFlags
|
Field |
Description |
|
read |
Specifies whether public (anonymous) access to read objects in the bucket is enabled. |
|
list |
Specifies whether public (anonymous) access to the list of objects in the bucket is enabled. |
|
config_read |
Specifies whether public (anonymous) access to read CORS, |