Object Storage API, REST: Bucket.getStats
Returns the statistics for the specified bucket.
HTTP request
GET https://storage.api.cloud.yandex.net/storage/v1/buckets/{name}:getStats
Path parameters
Parameter | Description |
---|---|
name | Required. Name of the bucket to return the statistics for. |
Response
HTTP Code: 200 - OK
{
"name": "string",
"maxSize": "integer",
"usedSize": "string",
"storageClassMaxSizes": [
{
"storageClass": "string",
"classSize": "integer"
}
],
"storageClassUsedSizes": [
{
"storageClass": "string",
"classSize": "string"
}
],
"storageClassCounters": [
{
"storageClass": "string",
"counters": {
"simpleObjectSize": "string",
"simpleObjectCount": "string",
"objectsPartsSize": "string",
"objectsPartsCount": "string",
"multipartObjectsSize": "string",
"multipartObjectsCount": "string",
"activeMultipartCount": "string"
}
}
],
"defaultStorageClass": "string",
"anonymousAccessFlags": {
"read": true,
"list": true,
"configRead": true
},
"createdAt": "string",
"updatedAt": "string"
}
A bucket statistics resource.
Field | Description |
---|---|
name | string Name of the bucket. |
maxSize | integer (int64) Maximum size of the bucket, in bytes. |
usedSize | string (int64) Size of used space in the bucket, in bytes. |
storageClassMaxSizes[] | object Size of available space in the bucket by storage class, in bytes. |
storageClassMaxSizes[]. storageClass |
string Storage class. Supported classes are standard storage ( |
storageClassMaxSizes[]. classSize |
integer (int64) Size of available space in the bucket for the storage class. |
storageClassUsedSizes[] | object Size of used space in the bucket by storage class, in bytes. |
storageClassUsedSizes[]. storageClass |
string Storage class. Supported classes are standard storage ( |
storageClassUsedSizes[]. classSize |
string (int64) Size of used space in the bucket for the storage class. |
storageClassCounters[] | object Object-related statistics by storage class and type of upload (simple vs. multipart), in bytes. |
storageClassCounters[]. storageClass |
string Storage class. Supported classes are standard storage ( |
storageClassCounters[]. counters |
object Object-related statistics for the storage class by type of upload. |
storageClassCounters[]. counters. simpleObjectSize |
string (int64) Total size of objects uploaded in single operation, in bytes. |
storageClassCounters[]. counters. simpleObjectCount |
string (int64) Number of objects uploaded in single operation. |
storageClassCounters[]. counters. objectsPartsSize |
string (int64) Total size of uploaded parts in incomplete multipart uploads, in bytes. |
storageClassCounters[]. counters. objectsPartsCount |
string (int64) Number of uploaded parts in incomplete multipart uploads. |
storageClassCounters[]. counters. multipartObjectsSize |
string (int64) Total size of objects uploaded in multiple parts, in bytes. |
storageClassCounters[]. counters. multipartObjectsCount |
string (int64) Number of objects uploaded in multiple parts. |
storageClassCounters[]. counters. activeMultipartCount |
string (int64) Number of incomplete multipart uploads. |
defaultStorageClass | string Default storage class for objects in the bucket. Supported classes are standard storage ( |
anonymousAccessFlags | object Flags for configuring public (anonymous) access to the bucket's content and settings. For details, see documentation. |
anonymousAccessFlags. read |
boolean (boolean) Specifies whether public (anonymous) access to read objects in the bucket is enabled. |
anonymousAccessFlags. list |
boolean (boolean) Specifies whether public (anonymous) access to the list of objects in the bucket is enabled. |
anonymousAccessFlags. configRead |
boolean (boolean) Specifies whether public (anonymous) access to read CORS, static website hosting, and object lifecycles settings of the bucket is enabled. |
createdAt | string (date-time) Bucket creation timestamp. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
updatedAt | string (date-time) Bucket latest update timestamp. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |