Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Tencentcloud Provider
  4. API Docs
  5. getTeoBillingData
Viewing docs for tencentcloud 1.83.33
published on Monday, Sep 21, 2026 by tencentcloudstack
Schema (JSON)
tencentcloudstack/terraform-provider-tencentcloud

tencentcloud.getTeoBillingData

Viewing docs for tencentcloud 1.83.33
published on Monday, Sep 21, 2026 by tencentcloudstack
Schema (JSON)
tencentcloudstack/terraform-provider-tencentcloud

    Use this data source to query TEO billing data, such as traffic, bandwidth, and request metrics.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as tencentcloud from "@pulumi/tencentcloud";

const example = tencentcloud.getTeoBillingData({
    startTime: "2025-01-01T00:00:00+08:00",
    endTime: "2025-01-02T00:00:00+08:00",
    zoneIds: ["zone-2qtuhspy7cr6"],
    metricName: "acc_flux",
    interval: "hour",
    filters: [{
        type: "host",
        value: "test.example.com",
    }],
    groupBies: [
        "zone-id",
        "host",
    ],
});

    import pulumi
import pulumi_tencentcloud as tencentcloud

example = tencentcloud.get_teo_billing_data(start_time="2025-01-01T00:00:00+08:00",
    end_time="2025-01-02T00:00:00+08:00",
    zone_ids=["zone-2qtuhspy7cr6"],
    metric_name="acc_flux",
    interval="hour",
    filters=[{
        "type": "host",
        "value": "test.example.com",
    }],
    group_bies=[
        "zone-id",
        "host",
    ])

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/tencentcloud/tencentcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := tencentcloud.GetTeoBillingData(ctx, &tencentcloud.GetTeoBillingDataArgs{
			StartTime: "2025-01-01T00:00:00+08:00",
			EndTime:   "2025-01-02T00:00:00+08:00",
			ZoneIds: []string{
				"zone-2qtuhspy7cr6",
			},
			MetricName: "acc_flux",
			Interval:   pulumi.StringRef("hour"),
			Filters: []tencentcloud.GetTeoBillingDataFilter{
				{
					Type:  "host",
					Value: "test.example.com",
				},
			},
			GroupBies: []string{
				"zone-id",
				"host",
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Tencentcloud = Pulumi.Tencentcloud;

return await Deployment.RunAsync(() => 
{
    var example = Tencentcloud.GetTeoBillingData.Invoke(new()
    {
        StartTime = "2025-01-01T00:00:00+08:00",
        EndTime = "2025-01-02T00:00:00+08:00",
        ZoneIds = new[]
        {
            "zone-2qtuhspy7cr6",
        },
        MetricName = "acc_flux",
        Interval = "hour",
        Filters = new[]
        {
            new Tencentcloud.Inputs.GetTeoBillingDataFilterInputArgs
            {
                Type = "host",
                Value = "test.example.com",
            },
        },
        GroupBies = new[]
        {
            "zone-id",
            "host",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.tencentcloud.TencentcloudFunctions;
import com.pulumi.tencentcloud.inputs.GetTeoBillingDataArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = TencentcloudFunctions.getTeoBillingData(GetTeoBillingDataArgs.builder()
            .startTime("2025-01-01T00:00:00+08:00")
            .endTime("2025-01-02T00:00:00+08:00")
            .zoneIds("zone-2qtuhspy7cr6")
            .metricName("acc_flux")
            .interval("hour")
            .filters(GetTeoBillingDataFilterArgs.builder()
                .type("host")
                .value("test.example.com")
                .build())
            .groupBies(            
                "zone-id",
                "host")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: tencentcloud:getTeoBillingData
      arguments:
        startTime: 2025-01-01T00:00:00+08:00
        endTime: 2025-01-02T00:00:00+08:00
        zoneIds:
          - zone-2qtuhspy7cr6
        metricName: acc_flux
        interval: hour
        filters:
          - type: host
            value: test.example.com
        groupBies:
          - zone-id
          - host

    Example coming soon!

    Using getTeoBillingData

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getTeoBillingData(args: GetTeoBillingDataArgs, opts?: InvokeOptions): Promise<GetTeoBillingDataResult>
function getTeoBillingDataOutput(args: GetTeoBillingDataOutputArgs, opts?: InvokeOutputOptions): Output<GetTeoBillingDataResult>
    def get_teo_billing_data(end_time: Optional[str] = None,
                         filters: Optional[Sequence[GetTeoBillingDataFilter]] = None,
                         group_bies: Optional[Sequence[str]] = None,
                         id: Optional[str] = None,
                         interval: Optional[str] = None,
                         metric_name: Optional[str] = None,
                         result_output_file: Optional[str] = None,
                         start_time: Optional[str] = None,
                         zone_ids: Optional[Sequence[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> GetTeoBillingDataResult
def get_teo_billing_data_output(end_time: pulumi.Input[Optional[str]] = None,
                         filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetTeoBillingDataFilterArgs]]]] = None,
                         group_bies: pulumi.Input[Optional[Sequence[pulumi.Input[str]]]] = None,
                         id: pulumi.Input[Optional[str]] = None,
                         interval: pulumi.Input[Optional[str]] = None,
                         metric_name: pulumi.Input[Optional[str]] = None,
                         result_output_file: pulumi.Input[Optional[str]] = None,
                         start_time: pulumi.Input[Optional[str]] = None,
                         zone_ids: pulumi.Input[Optional[Sequence[pulumi.Input[str]]]] = None,
                         opts: Optional[InvokeOutputOptions] = None) -> Output[GetTeoBillingDataResult]
    func GetTeoBillingData(ctx *Context, args *GetTeoBillingDataArgs, opts ...InvokeOption) (*GetTeoBillingDataResult, error)
func GetTeoBillingDataOutput(ctx *Context, args *GetTeoBillingDataOutputArgs, opts ...InvokeOption) GetTeoBillingDataResultOutput

    > Note: This function is named GetTeoBillingData in the Go SDK.

    public static class GetTeoBillingData 
{
    public static Task<GetTeoBillingDataResult> InvokeAsync(GetTeoBillingDataArgs args, InvokeOptions? opts = null)
    public static Output<GetTeoBillingDataResult> Invoke(GetTeoBillingDataInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetTeoBillingDataResult> Invoke(GetTeoBillingDataInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetTeoBillingDataResult> getTeoBillingData(GetTeoBillingDataArgs args, InvokeOptions options)
public static Output<GetTeoBillingDataResult> getTeoBillingData(GetTeoBillingDataArgs args, InvokeOptions options)
public static Output<GetTeoBillingDataResult> getTeoBillingData(GetTeoBillingDataArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: tencentcloud:index/getTeoBillingData:getTeoBillingData
  arguments:
    # arguments dictionary
    data "tencentcloud_get_teo_billing_data" "name" {
    # arguments
}

    The following arguments are supported:

    EndTime string
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    MetricName string
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    StartTime string
    Start time.
    ZoneIds List<string>
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    Filters List<GetTeoBillingDataFilter>
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    GroupBies List<string>
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    Id string
    Interval string
    Query time granularity. Valid values: 5min, hour, day.
    ResultOutputFile string
    Used to save results.
    EndTime string
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    MetricName string
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    StartTime string
    Start time.
    ZoneIds []string
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    Filters []GetTeoBillingDataFilter
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    GroupBies []string
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    Id string
    Interval string
    Query time granularity. Valid values: 5min, hour, day.
    ResultOutputFile string
    Used to save results.
    end_time string
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    metric_name string
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    start_time string
    Start time.
    zone_ids list(string)
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    filters list(object)
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    group_bies list(string)
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    id string
    interval string
    Query time granularity. Valid values: 5min, hour, day.
    result_output_file string
    Used to save results.
    endTime String
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    metricName String
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    startTime String
    Start time.
    zoneIds List<String>
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    filters List<GetTeoBillingDataFilter>
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    groupBies List<String>
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    id String
    interval String
    Query time granularity. Valid values: 5min, hour, day.
    resultOutputFile String
    Used to save results.
    endTime string
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    metricName string
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    startTime string
    Start time.
    zoneIds string[]
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    filters GetTeoBillingDataFilter[]
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    groupBies string[]
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    id string
    interval string
    Query time granularity. Valid values: 5min, hour, day.
    resultOutputFile string
    Used to save results.
    end_time str
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    metric_name str
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    start_time str
    Start time.
    zone_ids Sequence[str]
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    filters Sequence[GetTeoBillingDataFilter]
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    group_bies Sequence[str]
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    id str
    interval str
    Query time granularity. Valid values: 5min, hour, day.
    result_output_file str
    Used to save results.
    endTime String
    End time. The query time range (EndTime - StartTime) must be less than or equal to 31 days.
    metricName String
    Billing metric name, such as acc_flux, acc_bandwidth, etc.
    startTime String
    Start time.
    zoneIds List<String>
    Site ID collection, up to 100 site IDs. Use * to query account-level data of all sites under the current TencentCloud main account.
    filters List<Property Map>
    Filter conditions. Each item contains type and value. Valid type values: host, proxy-id, region-id.
    groupBies List<String>
    Grouping and aggregation dimensions, up to two dimensions. Valid values: zone-id, host, proxy-id, region-id.
    id String
    interval String
    Query time granularity. Valid values: 5min, hour, day.
    resultOutputFile String
    Used to save results.

    getTeoBillingData Result

    The following output properties are available:

    Datas List<GetTeoBillingDataData>
    Billing data point list.
    EndTime string
    Id string
    MetricName string
    StartTime string
    ZoneIds List<string>
    Filters List<GetTeoBillingDataFilter>
    GroupBies List<string>
    Interval string
    ResultOutputFile string
    Datas []GetTeoBillingDataData
    Billing data point list.
    EndTime string
    Id string
    MetricName string
    StartTime string
    ZoneIds []string
    Filters []GetTeoBillingDataFilter
    GroupBies []string
    Interval string
    ResultOutputFile string
    datas list(object)
    Billing data point list.
    end_time string
    id string
    metric_name string
    start_time string
    zone_ids list(string)
    filters list(object)
    group_bies list(string)
    interval string
    result_output_file string
    datas List<GetTeoBillingDataData>
    Billing data point list.
    endTime String
    id String
    metricName String
    startTime String
    zoneIds List<String>
    filters List<GetTeoBillingDataFilter>
    groupBies List<String>
    interval String
    resultOutputFile String
    datas GetTeoBillingDataData[]
    Billing data point list.
    endTime string
    id string
    metricName string
    startTime string
    zoneIds string[]
    filters GetTeoBillingDataFilter[]
    groupBies string[]
    interval string
    resultOutputFile string
    datas List<Property Map>
    Billing data point list.
    endTime String
    id String
    metricName String
    startTime String
    zoneIds List<String>
    filters List<Property Map>
    groupBies List<String>
    interval String
    resultOutputFile String

    Supporting Types

    GetTeoBillingDataData

    Host string
    Domain name to which the data point belongs.
    ProxyId string
    Layer 4 proxy instance ID to which the data point belongs.
    RegionId string
    Billing region ID to which the data point belongs.
    Time string
    Data timestamp.
    Value double
    Numeric value.
    ZoneId string
    Site ID to which the data point belongs.
    Host string
    Domain name to which the data point belongs.
    ProxyId string
    Layer 4 proxy instance ID to which the data point belongs.
    RegionId string
    Billing region ID to which the data point belongs.
    Time string
    Data timestamp.
    Value float64
    Numeric value.
    ZoneId string
    Site ID to which the data point belongs.
    host string
    Domain name to which the data point belongs.
    proxy_id string
    Layer 4 proxy instance ID to which the data point belongs.
    region_id string
    Billing region ID to which the data point belongs.
    time string
    Data timestamp.
    value number
    Numeric value.
    zone_id string
    Site ID to which the data point belongs.
    host String
    Domain name to which the data point belongs.
    proxyId String
    Layer 4 proxy instance ID to which the data point belongs.
    regionId String
    Billing region ID to which the data point belongs.
    time String
    Data timestamp.
    value Double
    Numeric value.
    zoneId String
    Site ID to which the data point belongs.
    host string
    Domain name to which the data point belongs.
    proxyId string
    Layer 4 proxy instance ID to which the data point belongs.
    regionId string
    Billing region ID to which the data point belongs.
    time string
    Data timestamp.
    value number
    Numeric value.
    zoneId string
    Site ID to which the data point belongs.
    host str
    Domain name to which the data point belongs.
    proxy_id str
    Layer 4 proxy instance ID to which the data point belongs.
    region_id str
    Billing region ID to which the data point belongs.
    time str
    Data timestamp.
    value float
    Numeric value.
    zone_id str
    Site ID to which the data point belongs.
    host String
    Domain name to which the data point belongs.
    proxyId String
    Layer 4 proxy instance ID to which the data point belongs.
    regionId String
    Billing region ID to which the data point belongs.
    time String
    Data timestamp.
    value Number
    Numeric value.
    zoneId String
    Site ID to which the data point belongs.

    GetTeoBillingDataFilter

    Type string
    Parameter name. Valid values: host, proxy-id, region-id.
    Value string
    Parameter value.
    Type string
    Parameter name. Valid values: host, proxy-id, region-id.
    Value string
    Parameter value.
    type string
    Parameter name. Valid values: host, proxy-id, region-id.
    value string
    Parameter value.
    type String
    Parameter name. Valid values: host, proxy-id, region-id.
    value String
    Parameter value.
    type string
    Parameter name. Valid values: host, proxy-id, region-id.
    value string
    Parameter value.
    type str
    Parameter name. Valid values: host, proxy-id, region-id.
    value str
    Parameter value.
    type String
    Parameter name. Valid values: host, proxy-id, region-id.
    value String
    Parameter value.

    Package Details

    Repository
    tencentcloud tencentcloudstack/terraform-provider-tencentcloud
    License
    Notes
    This Pulumi package is based on the tencentcloud Terraform Provider.
    Viewing docs for tencentcloud 1.83.33
    published on Monday, Sep 21, 2026 by tencentcloudstack
    Schema (JSON)
    tencentcloudstack/terraform-provider-tencentcloud

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial