Getting Information About Your Resource Consumption

You can get information about your resource consumption.

The details about your resources are provided for information purposes only. Only invoices are considered binding.

Getting Information About Your Resource Consumption Using Cockpit v1

  1. Hover over your name.
    A drop-down menu appears.

  2. Click My Consumption .
    Your consumption since the first day of the current month appears.

    • You can filter your consumption by category of resources. To do so, click and select or deselect the category you want to display or hide.

    • You can also use the search bar to find resources with specific attributes or values.

  3. (optional) To modify the date range, click the Date Range box and do one of the following actions:

    • To select a predefined date range, click Yesterday, This Month, or Last Month.

    • To specify a custom date range, click Custom Range:

      1. Select your dates.

        The date range can be up to two months.

      2. Click Apply to validate.

        Your consumption for the specified date range appears.

You can download the details of your consumption in a .csv or .json file based on the selected date range.
To do so, click Export and select the format.

Getting Information About Your Resource Consumption Using Cockpit v2-beta

  1. In the top right corner, click your initials.
    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

Before you begin: See Installing and Configuring OSC CLI to set up OSC CLI.

To get information about your resource consumption, use the ReadConsumptionAccount command following this syntax:

Request sample
$ osc-cli api ReadConsumptionAccount --profile "default" \
  --FromDate "2022-06-01" \
  --ToDate "2022-07-01" \
  --Overall False

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

  • FromDate: The start date of the time period (included), in ISO 8601 date format.

  • ToDate: The end date of the time period (excluded), in ISO 8601 date format.

  • Overall: Whether to return an overall consumption:

    • If False, returns only the consumption of the account that sends this command.

    • If True and this command is sent from a paying account, returns the overall consumption of the paying account and all linked accounts.

    • If True and this command is sent from a linked account, returns nothing.

The ReadConsumptionAccount command returns the following elements:

  • ConsumptionEntries: Information about the resources consumed during the specified time period. This element contains the following information:

    • AccountId: The ID of your TINA account.

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

    • FromDate: The beginning of the time period.

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

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

    • 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.

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

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

  • ResponseContext: Information about the context of the response. This element contains the following information:

    • RequestId: The ID of the request.

Result sample
{
    "ConsumptionEntries": [
        {
            "AccountId": "123456789012",
            "Category": "compute",
            "FromDate": "2022-06-24T00:00:00.000+0000",
            "SubregionName": "eu-west-2a",
            "Value": 168.0,
            "Title": "Instance - On demand - tinav5.c4r16 high performance (m5.xlarge) - par heure",
            "Service": "TinaOS-FCU",
            "ToDate": "2022-07-01T00:00:00.000+0000",
            "PayingAccountId": "987654321098",
            "Operation": "RunInstances-OD",
            "Type": "BoxUsage:m5.xlarge"
        }
    ],
    "ResponseContext": {
        "RequestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
}

Related Pages

Corresponding API Methods