G-g-core
Cost Reports

Get usage statistics report

Changed on

Data from the past hour may not reflect the full set of statistics. For the most complete and accurate results, we recommend accessing the data at least one hour after the relevant time period. Updates are generally available within a 24-hour window, though timing can vary. Scheduled maintenance or other exceptions may occasionally cause delays beyond 24 hours.

post/cloud/v1/usage_report

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v1/usage_report
  • Auth
    HTTP apikey

Request body

enable_last_dayboolean

Expenses for the last specified day are taken into account. As the default, False.

limitinteger

The response resources limit. Defaults to 10.

offsetinteger

The response resources offset.

order_byCostReportOrderByChoices[]

List of sorting criteria in 'field.direction' format.

projectsinteger[] nullable

List of project IDs

regionsinteger[]

List of region IDs.

time_fromstring date-time required

The start date of the report period (ISO 8601). The report starts from the beginning of this day in UTC.

time_tostring date-time required

The end date of the report period (ISO 8601). The report ends just before the beginning of this day in UTC.

typesPrebillingResourceTypes[]

List of resource types to be filtered in the report.

Example request

{
  "limit": 10,
  "order_by": [
    "project.asc",
    "region.desc"
  ],
  "projects": [
    16,
    17,
    18,
    19,
    20
  ],
  "regions": [
    1,
    2,
    3
  ],
  "schema_filter": {
    "values": [
      "10"
    ]
  },
  "tags": {
    "conditions": [
      {
        "key": "os_version",
        "strict": true,
        "value": "22.04"
      }
    ]
  },
  "time_from": "2023-01-01T00:00:00Z",
  "time_to": "2023-02-01T00:00:00Z",
  "types": [
    "egress_traffic",
    "instance"
  ]
}

Response

OK

countinteger required

Total count of the resources

Example response

{
  "count": 1,
  "resources": [
    {
      "billing_metric_name": "bm3-ai-1xlarge-h100-80-8_min",
      "billing_value": 1000,
      "billing_value_unit": "minutes",
      "first_seen": "2024-07-01T00:00:30Z",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "last_name": "ai_cluster_name",
      "last_seen": "2024-07-30T23:59:30Z",
      "project_id": 10,
      "region": 76,
      "region_id": 76,
      "tags": [
        {
          "os_distro": "ubuntu"
        },
        {
          "os_version": "22.04"
        }
      ]
    }
  ],
  "totals": [
    {
      "billing_metric_name": "bm3-ai-1xlarge-h100-80-8_min",
      "billing_value": 1000,
      "billing_value_unit": "minutes",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "region": 76,
      "region_id": 76
    }
  ]
}

Changes

  • a2b772345f3aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 96897b4b3d4cRevision changes
    • info

      added the new inference_public_models enum value to the request property /