# Get account usage

This endpoint retrieves the usage data of a given account that cannot be attached to a user.

Method Path Operation*
GET /usage get_account_usage

*

In order for a user to perform the "get_account_usage" operation, the "get_account_usage" permission must be included in the list of allowed actions in the statement of the user's role.

# Request

No parameters.

# Response

# Usage items

Item Category Description
db_read_cost database ODB read operations abstract cost.
db_write_cost database ODB write operations abstract cost.
hist_db_read_cost database Number of rows read from History database.
hist_db_write_cost database Number of rows modified in History database.
ts_db_read_cost database Number of rows read from Timeseries database.
ts_db_write_cost database Number of rows modified in Timeseries database.
ix_db_read_cost database Number of rows read from Indexes database.
ix_db_write_cost database Number of rows modified in Indexes database.
stickers_db_read_cost database number of rows read from the Stickers database.
stickers_db_write_cost database Number of rows modified in the Stickers database.
rest_count requests Number of REST requests processed.
request_count requests Number of task requests processed.
task_publish_topic_count requests Number of publishes to subscription topics.
task_{name}_count* tasks Number of specified task requests processed.
doc_size_delta storage Doc storage space used delta (based on the actual file sizes).
access_optimized_doc_size_delta storage Doc storage space used delta for access_optimized storage.
cost_optimized_doc_size_delta storage Doc storage space used delta for cost_optimized storage.
database_size_delta storage Database volume size delta in bytes (used for advanced database services).
ledger_size_delta storage Ledgers size delta in bytes.
twins_created objects Number of created Twins.
twins_terminated objects Number of terminated Twins.
identities_added objects Number of Identities added.
identities_deleted objects Number of Identities deleted.
ledgers_added objects Number of Ledgers added.
ledgers_deleted objects Number of deleted Ledgers.
task_queue_count system Number of queue requests processed.
doc_queue_count system Doc processing service messages send counter.
database_queue_count system Number of handled advanced database messages.
result_io_count system Task result cache I/O operations count.
log_io_count system Log cache I/O operations count.
dead_service_count system Number of updates to Ledger entries with Timeseries configuration, when service was not enabled for account.
l1_hit_count cache DB L1 cache hit counter.
l2_hit_count cache DB L2 cache hit counter.
l2_miss_count cache DB L2 cache miss counter.
ts_conn_pool_hit_count cache Number of times when Timeseries database connection was already available in the pool.
ts_conn_pool_miss_count cache Number of times when Timeseries database connection was not available in the pool.
ts_conn_pool_broken_count cache Number of times when connections to Timeseries database failed verification.
ts_conn_pool_new_count cache Number of successful new connections to Timeseries database.
ts_conn_pool_fail_count cache Number of unsuccessful connections tries to Timeseries database.
ix_conn_pool_hit_count cache Number of times when Indexes database connection was already available in the pool.
ix_conn_pool_miss_count cache Number of times when Indexes database connection was not available in the pool.
ix_conn_pool_broken_count cache Number of times when connections to Indexes database failed verification.
ix_conn_pool_new_count cache Number of successful new connections to Indexes database.
ix_conn_pool_fail_count cache Number of unsuccessful connections tries to Indexes database.
db_io_time time ODB operations I/O time.
l2_io_time time DB L2 cache I/O time.
result_io_time time Task result cache I/O operations time.
log_io_time time Log cache I/O operations time.
lambda_time time Time spent in the request handler lambda.
doc_outbound_traffic_delta transfer Size of downloaded files in bytes.
database_outbound_traffic_delta transfer Database outbound traffic in bytes.
rest_outbound_traffic_delta transfer REST API requests outbound traffic in bytes.

*

Please see list of tasks for description of a given task.

# Tasks

Task Category Description
create_twin Twin create_twin
get_twin Twin get_twin
scan_twins Twin scan_twins
update_twin Twin update_twin
delete_twin Twin delete_twin
create_twin_identity Identity create_twin_identity
get_twin_identity Identity get_twin_identity
get_twin_identities Identity get_twin_identities
update_twin_identity Identity update_twin_identity
delete_twin_identity Identity delete_twin_identity
resolve_twin_identity Identity resolve_twin_identity.md
add_twin_ledger_entry Ledger add_twin_ledger_entry
get_twin_ledger_entry Ledger get_twin_ledger_entry
update_twin_ledger_entry_value Ledger update_twin_ledger_entry_value
update_twin_ledger_entry Ledger update_twin_ledger_entry
delete_twin_ledger_entry Ledger delete_twin_ledger_entry
add_ledger_entry_ref Ledger Adds a Ledger Entry reference.
update_ledger_entry_ref Ledger Updates a Ledger Entry reference.
delete_ledger_entry_ref Ledger Deletes a Ledger Entry reference.
create_upload_url Doc create_upload_url
invalidate_upload_url Doc invalidate_upload_url
attach_twin_doc Doc attach_twin_doc
get_twin_doc Doc get_twin_doc
get_twin_docs Doc get_twin_docs
update_twin_doc Doc update_twin_doc
update_twin_doc_status Doc Updates the status of Doc.
delete_twin_doc Doc delete_twin_doc
download_doc Doc download_twin_doc
get_twin_ledger_entry_history History get_twin_ledger_entry_history
history_append History Appends a History record.
history_delete History Deletes a History record.
update_timeseries_access Timeseries update_timeseries_access
create_timeseries_table Timeseries create_timeseries_table
get_timeseries_table Timeseries get_timeseries_table
get_timeseries_tables Timeseries get_timeseries_tables
update_timeseries_table Timeseries update_timeseries_table
truncate_timeseries_table Timeseries truncate_timeseries_table
delete_timeseries_table Timeseries delete_timeseries_table
update_indexes_access Indexes update_indexes_access
create_indexes_table Indexes create_indexes_table
get_indexes_table Indexes get_indexes_table
get_indexes_tables Indexes get_indexes_tables
update_indexes_table Indexes update_timeseries_table
truncate_indexes_table Indexes truncate_indexes_table
delete_indexes_table Indexes delete_indexes_table
enable_service Timeseries/Indexes Enables database service for an account.
update_service Timeseries/Indexes Updates database service for the account.
disable_service Timeseries/Indexes Disables database service for the account.
add_services_database Timeseries/Indexes Adds services database to an account.
remove_services_database Timeseries/Indexes Removes services database from an account.
update_services_database Timeseries/Indexes Updates services database for an account.
webhook_subscribe Notifications webhook_subscribe
webhook_confirm_subscription Notifications webhook_confirm_subscription
webhook_refresh_subscription Notifications webhook_refresh_subscription
webhook_unsubscribe Notifications webhook_unsubscribe
put_sticker Stickers put_sticker
get_sticker Stickers get_sticker
get_stickers Stickers get_stickers
list_stickers Stickers list_stickers
remove_sticker Stickers remove_sticker
create_user_role role create_user_role
get_user_role role get_user_role
update_user_role role update_user_role
delete_user_role role delete_user_role
create_user user create_user
get_user user get_user
update_user user update_user
delete_user user delete_user
create_user_secret_pin User Secret create_user_secret_pin
create_user_secret User Secret create_user_secret
get_user_secret User Secret get_user_secret
update_user_secret User Secret update_user_secret
delete_user_secret User Secret delete_a_user_secret
create_user_token User Token create_user_token
refresh_user_token User Token refresh_user_token
who_am_i Who am I who am I
trace Trace trace
trace_system Trace Task triggered by a trace request.
get_account_usage Usage get_account_usage
get_user_usage Usage get_user_usage
get_log Log get_log

# Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.

Was this article helpful?