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",
"maxSize": "google.protobuf.Int64Value",
"usedSize": "int64",
"storageClassMaxSizes": [
{
"storageClass": "string",
"classSize": "google.protobuf.Int64Value"
}
],
"storageClassUsedSizes": [
{
"storageClass": "string",
"classSize": "int64"
}
],
"storageClassCounters": [
{
"storageClass": "string",
"counters": {
"simpleObjectSize": "int64",
"simpleObjectCount": "int64",
"objectsPartsSize": "int64",
"objectsPartsCount": "int64",
"multipartObjectsSize": "int64",
"multipartObjectsCount": "int64",
"activeMultipartCount": "int64"
}
}
],
"defaultStorageClass": "google.protobuf.StringValue",
"anonymousAccessFlags": {
"read": "google.protobuf.BoolValue",
"list": "google.protobuf.BoolValue",
"configRead": "google.protobuf.BoolValue"
},
"createdAt": "google.protobuf.Timestamp",
"updatedAt": "google.protobuf.Timestamp"
}
A bucket statistics resource.
|
Field |
Description |
|
name |
string Name of the bucket. |
|
maxSize |
Maximum size of the bucket, in bytes. |
|
usedSize |
int64 Size of used space in the bucket, in bytes. |
|
storageClassMaxSizes[] |
Size of available space in the bucket by storage class, in bytes. |
|
storageClassUsedSizes[] |
Size of used space in the bucket by storage class, in bytes. |
|
storageClassCounters[] |
Object-related statistics by storage class and type of upload (simple vs. multipart), in bytes. |
|
defaultStorageClass |
Default storage class for objects in the bucket. Supported classes are standard storage ( |
|
anonymousAccessFlags |
Flags for configuring public (anonymous) access to the bucket's content and settings. |
|
createdAt |
Bucket creation timestamp. |
|
updatedAt |
Bucket latest update timestamp. |
OptionalSizeByClass
A resource for size of available space in a bucket for a storage class.
|
Field |
Description |
|
storageClass |
string Storage class. Supported classes are standard storage ( |
|
classSize |
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 |
|
storageClass |
string Storage class. Supported classes are standard storage ( |
|
classSize |
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 |
|
storageClass |
string Storage class. Supported classes are standard storage ( |
|
counters |
Object-related statistics for the storage class by type of upload. |
Counters
|
Field |
Description |
|
simpleObjectSize |
int64 Total size of objects uploaded in single operation, in bytes. |
|
simpleObjectCount |
int64 Number of objects uploaded in single operation. |
|
objectsPartsSize |
int64 Total size of uploaded parts in incomplete multipart uploads, in bytes. |
|
objectsPartsCount |
int64 Number of uploaded parts in incomplete multipart uploads. |
|
multipartObjectsSize |
int64 Total size of objects uploaded in multiple parts, in bytes. |
|
multipartObjectsCount |
int64 Number of objects uploaded in multiple parts. |
|
activeMultipartCount |
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. |
|
configRead |
Specifies whether public (anonymous) access to read CORS, |