Monitoring S3 usage
You can monitor usage at different levels depending on what you need to troubleshoot or report:
- Domain usage summary
- Per-project usage
- Per-user usage
- Per-bucket usage
To view S3 usage for all projects in a domain
Use the following command:
vinfra service s3 domain usage list --domain <domain> [--count <count>] [--marker <marker>] [--unit <unit>]
--domain <domain>- Domain name or ID
--count <count>- Maximum number of entries to return
--marker <marker>- Pagination marker
--unit <unit>- Size unit
For example, to check the S3 usage summary in GB for the domain mydomain, run:
# vinfra service s3 domain usage list --domain mydomain --unit gb +----------------------------------+----------------+ | OrganizationId | SpaceStat | +----------------------------------+----------------+ | 653c050730f24cf585cb175bc0557e86 | LastTs: 492545 | | | SizeCurr: 6.0 | | | SizeHInt: 36.0 | | | SizeHMax: 6.0 | +----------------------------------+----------------+
To view S3 usage for a particular project
Use the following command:
vinfra service s3 project usage show --project <project> --domain <domain> [--count <count>] [--marker <marker>] [--unit <unit>]
--project <project>- Project name or ID
--domain <domain>- Domain name or ID
--count <count>- Maximum number of entries to return
--marker <marker>- Pagination marker
--unit <unit>- Size unit
For example, to check the S3 usage summary in GB for the project myproject within the domain mydomain, run:
# vinfra service s3 project usage show --project myproject --domain mydomain --unit gb +-------------+----------------------------------------------------+ | Field | Value | +-------------+----------------------------------------------------+ | count | 1 | | data | - OrganizationId: 653c050730f24cf585cb175bc0557e86 | | | SpaceStat: | | | LastTs: 492545 | | | SizeCurr: 6.0 | | | SizeHInt: 36.0 | | | SizeHMax: 6.0 | | marker | | | next_marker | | +-------------+----------------------------------------------------+
To view S3 usage for all users in a project
Use the following command:
vinfra service s3 project usage users list --project <project> --domain <domain> [--count <count>] [--marker <marker>]
[--unit <unit>] [--s3-user <s3_user>] [--email <email>]
--project <project>- Project name or ID
--domain <domain>- Domain name or ID
--count <count>- Maximum number of entries to return
--marker <marker>- Pagination marker
--unit <unit>- Size unit
--s3-user <s3_user>- S3 user ID
--email <email>- S3 user email
For example, to check the S3 usage summary in GB for all users in the project myproject, run:
# vinfra service s3 project usage users list --project myproject --domain mydomain --unit gb +------------------+-----------------------------+------------------+ | UserId | UserEmail | UsedSpace | +------------------+-----------------------------+------------------+ | e14bbf0baae895ca | e14bbf0baae895ca@s3.acronis | current: 6.0 | | | | h_integral: 36.0 | | | | hmax: 6.0 | | | | last_ts: 492545 | +------------------+-----------------------------+------------------+
To view S3 usage for a particular S3 user
Use the following command:
vinfra service s3 project usage user show --project <project> --domain <domain> --s3-user <s3_user> [--unit <unit>]
--project <project>- Project name or ID
--domain <domain>- Domain name or ID
--s3-user <s3_user>- S3 user ID
--unit <unit>- Size unit
For example, to check the S3 usage summary in GB for the user with the ID 1 in the project myproject, run:
# vinfra service s3 project usage user show --project myproject --domain mydomain --s3-user 1 --unit gb +-------------+-----------------------------------------------------+ | Field | Value | +-------------+-----------------------------------------------------+ | count | 1 | | data | - ExtendedOwnerId: 653c050730f24cf585cb175bc0557e86 | | | Flags: [] | | | OwnerId: 653c050730f24cf5 | | | State: enabled | | | UsedSpace: | | | current: 6.0 | | | h_integral: 36.0 | | | hmax: 6.0 | | | last_ts: 492545 | | | UserEmail: e14bbf0baae895ca@s3.acronis | | | UserId: e14bbf0baae895ca | | marker | | | next_marker | | +-------------+-----------------------------------------------------+
To view S3 usage for all buckets in a project
Use the following command:
vinfra service s3 project usage buckets list --project <project> --domain <domain> [--count <count>] [--marker <marker>]
[--unit <unit>] [--bucket <bucket>]
--project <project>- Project name or ID
--domain <domain>- Domain name or ID
--count <count>- Maximum number of entries to return
--marker <marker>- Pagination marker
--unit <unit>- Size unit
--bucket <bucket>- Bucket name
For example, to check the S3 usage summary in GB for all buckets in the project myproject, run:
# vinfra service s3 project usage buckets list --project myproject --domain mydomain --unit gb +----------+------------------+------------------+ | name | owner_id | size | +----------+------------------+------------------+ | mybucket | e14bbf0baae895ca | current: 6.0 | | | | h_integral: 36.0 | | | | hmax: 6.0 | | | | last_ts: 492545 | +----------+------------------+------------------+
To view S3 usage for a particular S3 bucket
Use the following command:
vinfra service s3 project usage bucket show --project <project> --domain <domain> --bucket <bucket> [--unit <unit>]
--project <project>- Project name or ID
--domain <domain>- Domain name or ID
--bucket <bucket>- Bucket name
--unit <unit>- Size unit
For example, to check the S3 usage summary in GB for the bucket mybucket in the project myproject, run:
# vinfra service s3 project usage bucket show --project myproject --domain mydomain --bucket mybucket --unit gb +-------------+---------------------------------------------+ | Field | Value | +-------------+---------------------------------------------+ | count | 1 | | data | - creation_date: '2026-03-10T16:58:55.000Z' | | | epoch: 16186335692480939358 | | | name: mybucket | | | owner_id: e14bbf0baae895ca | | | size: | | | current: 6.0 | | | h_integral: 36.0 | | | hmax: 6.0 | | | last_ts: 492545 | | marker | | | next_marker | | +-------------+---------------------------------------------+
See also