Getting Information About Your Resource Consumption

You can get information about your resource consumption. Note however that the details about your resources are provided for information purposes only. Only invoices are considered binding.

In terms of governance, it can be a best practice to delegate the reading of your consumption to an EIM user. For more information, see Tutorial: Getting Your Consumption Using an EIM User.

Getting Information About Your Resource Consumption Using Cockpit v2

  1. In the top right corner, click the IconProfil icon.
    A drop-down menu appears.

  2. Click IconMySpace Personal Space.
    Your account information appears.

  3. Click the IconSignal My Consumption tab.
    Your consumption since the first day of the current month appears.

    • Click IconFilter and IconSearch in the headers to filter consumed resources.

    • Use the search bar to filter consumed resources based on specific keywords.

  4. (optional) To specify:

    • A predefined date range, click Yesterday, This Month, or Last Month.

    • A custom date range, select the start date and the end date.

      The date range can be up to 62 days.

    Your consumption for the specified date range appears.

  5. (optional) Switch on or off the Overall button depending on the consumption you want to display:

    • If off, the table displays only the consumption of the currently logged-in account.

    • If on and you are logged in from a paying account, the table displays the overall consumption of the paying account and all linked accounts.

    • If on and you are logged in from a linked account, the table displays nothing.

    For more information about paying accounts, see About Your Account.

To download the details of your consumption in a .csv or .json file based on the selected date range, click the button corresponding to the desired format.

Getting Information About Your Resource Consumption Using OSC CLI

The ReadConsumptionAccount command gets information about the consumption of your account for each billable resource within the specified time period.

Request sample
$ osc-cli api ReadConsumptionAccount --profile "default" \
    --FromDate "2023-06-01" \
    --ToDate "2023-07-01" \
    --ShowPrice True

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • FromDate: The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14). The date-time format is also accepted, but only with a time set to midnight (for example, 2020-06-14T00:00:00.000Z). This value is included in the time period.

  • Overall: (optional) By default or if false, returns only the consumption of the specific account that sends this request. If true, returns either the overall consumption of your paying account and all linked accounts (if the account that sends this request is a paying account) or returns nothing (if the account that sends this request is a linked account).

  • ShowPrice: (optional) If true, the response also includes the unit price of the consumed resource (UnitPrice) and the total price of the consumed resource during the specified time period (Price), in the currency of your account.

  • ToDate: The end of the time period, in ISO 8601 date format (for example, 2020-06-30). The date-time format is also accepted, but only with a time set to midnight (for example, 2020-06-30T00:00:00.000Z). This value is excluded from the time period, and must be set to a later date than FromDate.

The ReadConsumptionAccount command returns the following elements:

  • ConsumptionEntries: Information about the resources consumed during the specified time period.

    • AccountId: The ID of your TINA account.

    • Category: The category of the resource (for example, network).

    • FromDate: The beginning of the time period (UTC).

    • Operation: The API call that triggered the resource consumption (for example, RunInstances or CreateVolume).

    • PayingAccountId: The ID of the TINA account which is billed for your consumption. It can be different from your account in the AccountId parameter.

    • Price: The total price of the consumed resource during the specified time period, in the currency of the Region’s catalog.

    • Service: The service of the API call (TinaOS-FCU, TinaOS-LBU, TinaOS-DirectLink, TinaOS-OOS, or TinaOS-OSU).

    • SubregionName: The name of the Subregion.

    • Title: A description of the consumed resource.

    • ToDate: The end of the time period (UTC).

    • Type: The type of resource, depending on the API call.

    • UnitPrice: The unit price of the consumed resource in the currency of your account, in the ISO-4217 format (for example, EUR).

    • Value: The consumed amount for the resource. The unit depends on the resource type. For more information, see the Title element.

  • Currency: The currency of your account for the UnitPrice and Price parameters, in the ISO-4217 format (for example, EUR).

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "ConsumptionEntries": [
    {
      "UnitPrice": 0.044,
      "Type": "BoxUsage:tinav4.c1r1p2",
      "Operation": "RunInstances-OD",
      "SubregionName": "eu-west-2a",
      "Value": 1392,
      "Title": "Instance - On demand - tinav4.c1r1 high performance - par heure",
      "Category": "compute",
      "ToDate": "2023-06-30T00:00:00.000+0000",
      "Service": "TinaOS-FCU",
      "AccountId": "123456789012",
      "PayingAccountId": "123456789012",
      "FromDate": "2023-06-01T00:00:00.000+0000",
      "Price": 61.248
    }
  ],
  "Currency": "EUR"
}

Getting Information About Your Resource Consumption Using oapi-cli

The ReadConsumptionAccount command gets information about the consumption of your account for each billable resource within the specified time period.

Request sample
$ oapi-cli --profile "default" ReadConsumptionAccount \
    --FromDate "2023-06-01" \
    --ToDate "2023-07-01" \
    --ShowPrice True

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • FromDate: The beginning of the time period, in ISO 8601 date format (for example, 2020-06-14). The date-time format is also accepted, but only with a time set to midnight (for example, 2020-06-14T00:00:00.000Z). This value is included in the time period.

  • Overall: (optional) By default or if false, returns only the consumption of the specific account that sends this request. If true, returns either the overall consumption of your paying account and all linked accounts (if the account that sends this request is a paying account) or returns nothing (if the account that sends this request is a linked account).

  • ShowPrice: (optional) If true, the response also includes the unit price of the consumed resource (UnitPrice) and the total price of the consumed resource during the specified time period (Price), in the currency of your account.

  • ToDate: The end of the time period, in ISO 8601 date format (for example, 2020-06-30). The date-time format is also accepted, but only with a time set to midnight (for example, 2020-06-30T00:00:00.000Z). This value is excluded from the time period, and must be set to a later date than FromDate.

The ReadConsumptionAccount command returns the following elements:

  • ConsumptionEntries: Information about the resources consumed during the specified time period.

    • AccountId: The ID of your TINA account.

    • Category: The category of the resource (for example, network).

    • FromDate: The beginning of the time period (UTC).

    • Operation: The API call that triggered the resource consumption (for example, RunInstances or CreateVolume).

    • PayingAccountId: The ID of the TINA account which is billed for your consumption. It can be different from your account in the AccountId parameter.

    • Price: The total price of the consumed resource during the specified time period, in the currency of the Region’s catalog.

    • Service: The service of the API call (TinaOS-FCU, TinaOS-LBU, TinaOS-DirectLink, TinaOS-OOS, or TinaOS-OSU).

    • SubregionName: The name of the Subregion.

    • Title: A description of the consumed resource.

    • ToDate: The end of the time period (UTC).

    • Type: The type of resource, depending on the API call.

    • UnitPrice: The unit price of the consumed resource in the currency of your account, in the ISO-4217 format (for example, EUR).

    • Value: The consumed amount for the resource. The unit depends on the resource type. For more information, see the Title element.

  • Currency: The currency of your account for the UnitPrice and Price parameters, in the ISO-4217 format (for example, EUR).

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "ConsumptionEntries": [
    {
      "UnitPrice": 0.044,
      "Type": "BoxUsage:tinav4.c1r1p2",
      "Operation": "RunInstances-OD",
      "SubregionName": "eu-west-2a",
      "Value": 1392,
      "Title": "Instance - On demand - tinav4.c1r1 high performance - par heure",
      "Category": "compute",
      "ToDate": "2023-06-30T00:00:00.000+0000",
      "Service": "TinaOS-FCU",
      "AccountId": "123456789012",
      "PayingAccountId": "123456789012",
      "FromDate": "2023-06-01T00:00:00.000+0000",
      "Price": 61.248
    }
  ],
  "Currency": "EUR"
}

Related Pages

Corresponding API Methods

Export to PDF