Billing Statistics API (v1.0.0)

Consumption and expense statistics for cloud servers, Managed Databases, Managed Kubernetes, Object Storage, Container Registry, CDN, Cloud powered by VMware. It is not yet possible to view consumption and expense statistics via API for dedicated servers, colocation, and firewalls.

Get statistics

Receiving statistic

Get billing statistics for projects

Get billing statistics for projects by provider keys

Authorizations:

X-TokenX-Auth-Token

query Parameters

provider_keys

required

Array of strings

Items Enum: "vpc" "serverless" "mks" "dbaas" "storage" "cdn" "vmware" "craas" "ones" "mobfarm" "ses"

Provider keys to filter statistics by

Responses

Response samples

200

Content type

application/json

{"status": "success",
"data": [{"id": "8c37009d-99b2-4f94-adda-7c6e7e0c2b69",
"name": "name_project"
}
]
}

Get billing statistics for objects

Get billing statistics for objects by provider keys

Authorizations:

X-TokenX-Auth-Token

query Parameters

provider_keys required	Array of strings Items Enum: "vpc" "serverless" "mks" "dbaas" "storage" "cdn" "vmware" "craas" "ones" "mobfarm" "ses" Provider keys to filter statistics by
locale	string Enum: "ru" "en" Locale for returned data

Responses

Response samples

200

Content type

application/json

{"status": "success",
"data": [{"id": "0cebfc0e-9400-4ac4-987c-368e4af12619",
"name": null,
"parent_id": null,
"project_id": "cab8c287-fbf3-4285-abcb-58f439ef5984",
"type": "cloud_vm",
"type_name": "Сервер"
}
]
}

Get summary statistics

Get summary billing statistics by provider keys, date range and grouping parameters

Authorizations:

X-TokenX-Auth-Token

query Parameters

provider_keys required	Array of strings Items Enum: "vpc" "serverless" "mks" "dbaas" "storage" "cdn" "vmware" "craas" "ones" "mobfarm" "ses" Service Provider Key
start required	string <date-time> Start date for statistics range
end required	string <date-time> End date for statistics range
group_type required	string Enum: "project" "object" "metric" "project_metric" "region_metric" Grouping type for returned data
period_group_type required	string Enum: "hour" "day" "week" "month" "year" "all" Period grouping type for returned data
items_count_period_group_type required	string Enum: "hour" "day" "week" "month" "year" "all" Items count period grouping type for returned data

Responses

Response samples

200

Content type

application/json

{"status": "success",
"data": [{"account_id": "5633235",
"period_start": "2023-01-01T00:00:00",
"period_end": "2023-01-31T23:59:59",
"value": 29055134,
"items_count": 1097
}
]
}

Getting service consumption statistics

Getting statistics on the consumption of services on the Selectel cloud for a certain period of time

Authorizations:

X-TokenX-Auth-Token

query Parameters

provider_keys required	Array of strings Items Enum: "vpc" "serverless" "mks" "dbaas" "storage" "cdn" "vmware" "craas" "ones" "mobfarm" "ses" Service provider keys
start required	string <date-time> Start of statistics period
end required	string <date-time> End of statistics period
locale required	string Enum: "ru" "en" Localization language
group_type required	string Enum: "project" "object" "metric" "project_metric" "region_metric" Statistics grouping type
period_group_type required	string Enum: "hour" "day" "week" "month" "year" "all" Statistics period grouping type

Responses

Response samples

200

Content type

application/json

{"status": "success",
"data": [{"account_id": "5633235",
"metric": {"id": "volume_gigabytes_local",
"locale": "ru",
"name": "Local NVMe SSDs",
"quantity": 672,
"unit": "GB"
},
"period": "2023-06-01T00:00:00",
"provider_key": "vpc",
"value": 1231
},
{"account_id": "5633235",
"metric": {"id": "mks_cluster_regional",
"locale": "ru",
"name": "Failover Managed Kubernetes Cluster",
"quantity": 24,
"unit": "item"
},
"period": "2023-06-01T00:00:00",
"provider_key": "mks",
"value": 31525
}
]
}