pulumi-oci 1.17.0a1702406535__py3-none-any.whl → 1.18.0a1702447417__py3-none-any.whl

pulumi_oci/meteringcomputation/usage_carbon_emission.py

@@ -0,0 +1,597 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+from .. import _utilities
+from . import outputs
+from ._inputs import *
+
+__all__ = ['UsageCarbonEmissionArgs', 'UsageCarbonEmission']
+
+@pulumi.input_type
+class UsageCarbonEmissionArgs:
+    def __init__(__self__, *,
+                 tenant_id: pulumi.Input[str],
+                 time_usage_ended: pulumi.Input[str],
+                 time_usage_started: pulumi.Input[str],
+                 compartment_depth: Optional[pulumi.Input[int]] = None,
+                 group_bies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 group_by_tags: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]] = None,
+                 is_aggregate_by_time: Optional[pulumi.Input[bool]] = None,
+                 usage_carbon_emission_filter: Optional[pulumi.Input[str]] = None):
+        """
+        The set of arguments for constructing a UsageCarbonEmission resource.
+        :param pulumi.Input[str] tenant_id: Tenant ID.
+        :param pulumi.Input[str] time_usage_ended: The usage end time.
+        :param pulumi.Input[str] time_usage_started: The usage start time.
+        :param pulumi.Input[int] compartment_depth: The compartment depth level.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] group_bies: Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        :param pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]] group_by_tags: GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        :param pulumi.Input[bool] is_aggregate_by_time: Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        :param pulumi.Input[str] usage_carbon_emission_filter: The filter object for query usage.
+               
+               
+               ** IMPORTANT **
+               Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        pulumi.set(__self__, "tenant_id", tenant_id)
+        pulumi.set(__self__, "time_usage_ended", time_usage_ended)
+        pulumi.set(__self__, "time_usage_started", time_usage_started)
+        if compartment_depth is not None:
+            pulumi.set(__self__, "compartment_depth", compartment_depth)
+        if group_bies is not None:
+            pulumi.set(__self__, "group_bies", group_bies)
+        if group_by_tags is not None:
+            pulumi.set(__self__, "group_by_tags", group_by_tags)
+        if is_aggregate_by_time is not None:
+            pulumi.set(__self__, "is_aggregate_by_time", is_aggregate_by_time)
+        if usage_carbon_emission_filter is not None:
+            pulumi.set(__self__, "usage_carbon_emission_filter", usage_carbon_emission_filter)
+
+    @property
+    @pulumi.getter(name="tenantId")
+    def tenant_id(self) -> pulumi.Input[str]:
+        """
+        Tenant ID.
+        """
+        return pulumi.get(self, "tenant_id")
+
+    @tenant_id.setter
+    def tenant_id(self, value: pulumi.Input[str]):
+        pulumi.set(self, "tenant_id", value)
+
+    @property
+    @pulumi.getter(name="timeUsageEnded")
+    def time_usage_ended(self) -> pulumi.Input[str]:
+        """
+        The usage end time.
+        """
+        return pulumi.get(self, "time_usage_ended")
+
+    @time_usage_ended.setter
+    def time_usage_ended(self, value: pulumi.Input[str]):
+        pulumi.set(self, "time_usage_ended", value)
+
+    @property
+    @pulumi.getter(name="timeUsageStarted")
+    def time_usage_started(self) -> pulumi.Input[str]:
+        """
+        The usage start time.
+        """
+        return pulumi.get(self, "time_usage_started")
+
+    @time_usage_started.setter
+    def time_usage_started(self, value: pulumi.Input[str]):
+        pulumi.set(self, "time_usage_started", value)
+
+    @property
+    @pulumi.getter(name="compartmentDepth")
+    def compartment_depth(self) -> Optional[pulumi.Input[int]]:
+        """
+        The compartment depth level.
+        """
+        return pulumi.get(self, "compartment_depth")
+
+    @compartment_depth.setter
+    def compartment_depth(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "compartment_depth", value)
+
+    @property
+    @pulumi.getter(name="groupBies")
+    def group_bies(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+        """
+        Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        """
+        return pulumi.get(self, "group_bies")
+
+    @group_bies.setter
+    def group_bies(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+        pulumi.set(self, "group_bies", value)
+
+    @property
+    @pulumi.getter(name="groupByTags")
+    def group_by_tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]]:
+        """
+        GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        """
+        return pulumi.get(self, "group_by_tags")
+
+    @group_by_tags.setter
+    def group_by_tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]]):
+        pulumi.set(self, "group_by_tags", value)
+
+    @property
+    @pulumi.getter(name="isAggregateByTime")
+    def is_aggregate_by_time(self) -> Optional[pulumi.Input[bool]]:
+        """
+        Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        """
+        return pulumi.get(self, "is_aggregate_by_time")
+
+    @is_aggregate_by_time.setter
+    def is_aggregate_by_time(self, value: Optional[pulumi.Input[bool]]):
+        pulumi.set(self, "is_aggregate_by_time", value)
+
+    @property
+    @pulumi.getter(name="usageCarbonEmissionFilter")
+    def usage_carbon_emission_filter(self) -> Optional[pulumi.Input[str]]:
+        """
+        The filter object for query usage.
+
+
+        ** IMPORTANT **
+        Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        return pulumi.get(self, "usage_carbon_emission_filter")
+
+    @usage_carbon_emission_filter.setter
+    def usage_carbon_emission_filter(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "usage_carbon_emission_filter", value)
+
+
+@pulumi.input_type
+class _UsageCarbonEmissionState:
+    def __init__(__self__, *,
+                 compartment_depth: Optional[pulumi.Input[int]] = None,
+                 group_bies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 group_by_tags: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]] = None,
+                 is_aggregate_by_time: Optional[pulumi.Input[bool]] = None,
+                 items: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionItemArgs']]]] = None,
+                 tenant_id: Optional[pulumi.Input[str]] = None,
+                 time_usage_ended: Optional[pulumi.Input[str]] = None,
+                 time_usage_started: Optional[pulumi.Input[str]] = None,
+                 usage_carbon_emission_filter: Optional[pulumi.Input[str]] = None):
+        """
+        Input properties used for looking up and filtering UsageCarbonEmission resources.
+        :param pulumi.Input[int] compartment_depth: The compartment depth level.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] group_bies: Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        :param pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]] group_by_tags: GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        :param pulumi.Input[bool] is_aggregate_by_time: Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        :param pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionItemArgs']]] items: A list of usage carbon emission items.
+        :param pulumi.Input[str] tenant_id: Tenant ID.
+        :param pulumi.Input[str] time_usage_ended: The usage end time.
+        :param pulumi.Input[str] time_usage_started: The usage start time.
+        :param pulumi.Input[str] usage_carbon_emission_filter: The filter object for query usage.
+               
+               
+               ** IMPORTANT **
+               Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        if compartment_depth is not None:
+            pulumi.set(__self__, "compartment_depth", compartment_depth)
+        if group_bies is not None:
+            pulumi.set(__self__, "group_bies", group_bies)
+        if group_by_tags is not None:
+            pulumi.set(__self__, "group_by_tags", group_by_tags)
+        if is_aggregate_by_time is not None:
+            pulumi.set(__self__, "is_aggregate_by_time", is_aggregate_by_time)
+        if items is not None:
+            pulumi.set(__self__, "items", items)
+        if tenant_id is not None:
+            pulumi.set(__self__, "tenant_id", tenant_id)
+        if time_usage_ended is not None:
+            pulumi.set(__self__, "time_usage_ended", time_usage_ended)
+        if time_usage_started is not None:
+            pulumi.set(__self__, "time_usage_started", time_usage_started)
+        if usage_carbon_emission_filter is not None:
+            pulumi.set(__self__, "usage_carbon_emission_filter", usage_carbon_emission_filter)
+
+    @property
+    @pulumi.getter(name="compartmentDepth")
+    def compartment_depth(self) -> Optional[pulumi.Input[int]]:
+        """
+        The compartment depth level.
+        """
+        return pulumi.get(self, "compartment_depth")
+
+    @compartment_depth.setter
+    def compartment_depth(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "compartment_depth", value)
+
+    @property
+    @pulumi.getter(name="groupBies")
+    def group_bies(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+        """
+        Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        """
+        return pulumi.get(self, "group_bies")
+
+    @group_bies.setter
+    def group_bies(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+        pulumi.set(self, "group_bies", value)
+
+    @property
+    @pulumi.getter(name="groupByTags")
+    def group_by_tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]]:
+        """
+        GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        """
+        return pulumi.get(self, "group_by_tags")
+
+    @group_by_tags.setter
+    def group_by_tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionGroupByTagArgs']]]]):
+        pulumi.set(self, "group_by_tags", value)
+
+    @property
+    @pulumi.getter(name="isAggregateByTime")
+    def is_aggregate_by_time(self) -> Optional[pulumi.Input[bool]]:
+        """
+        Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        """
+        return pulumi.get(self, "is_aggregate_by_time")
+
+    @is_aggregate_by_time.setter
+    def is_aggregate_by_time(self, value: Optional[pulumi.Input[bool]]):
+        pulumi.set(self, "is_aggregate_by_time", value)
+
+    @property
+    @pulumi.getter
+    def items(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionItemArgs']]]]:
+        """
+        A list of usage carbon emission items.
+        """
+        return pulumi.get(self, "items")
+
+    @items.setter
+    def items(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['UsageCarbonEmissionItemArgs']]]]):
+        pulumi.set(self, "items", value)
+
+    @property
+    @pulumi.getter(name="tenantId")
+    def tenant_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        Tenant ID.
+        """
+        return pulumi.get(self, "tenant_id")
+
+    @tenant_id.setter
+    def tenant_id(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "tenant_id", value)
+
+    @property
+    @pulumi.getter(name="timeUsageEnded")
+    def time_usage_ended(self) -> Optional[pulumi.Input[str]]:
+        """
+        The usage end time.
+        """
+        return pulumi.get(self, "time_usage_ended")
+
+    @time_usage_ended.setter
+    def time_usage_ended(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "time_usage_ended", value)
+
+    @property
+    @pulumi.getter(name="timeUsageStarted")
+    def time_usage_started(self) -> Optional[pulumi.Input[str]]:
+        """
+        The usage start time.
+        """
+        return pulumi.get(self, "time_usage_started")
+
+    @time_usage_started.setter
+    def time_usage_started(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "time_usage_started", value)
+
+    @property
+    @pulumi.getter(name="usageCarbonEmissionFilter")
+    def usage_carbon_emission_filter(self) -> Optional[pulumi.Input[str]]:
+        """
+        The filter object for query usage.
+
+
+        ** IMPORTANT **
+        Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        return pulumi.get(self, "usage_carbon_emission_filter")
+
+    @usage_carbon_emission_filter.setter
+    def usage_carbon_emission_filter(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "usage_carbon_emission_filter", value)
+
+
+class UsageCarbonEmission(pulumi.CustomResource):
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 compartment_depth: Optional[pulumi.Input[int]] = None,
+                 group_bies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 group_by_tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionGroupByTagArgs']]]]] = None,
+                 is_aggregate_by_time: Optional[pulumi.Input[bool]] = None,
+                 tenant_id: Optional[pulumi.Input[str]] = None,
+                 time_usage_ended: Optional[pulumi.Input[str]] = None,
+                 time_usage_started: Optional[pulumi.Input[str]] = None,
+                 usage_carbon_emission_filter: Optional[pulumi.Input[str]] = None,
+                 __props__=None):
+        """
+        This resource provides the Usage Carbon Emission resource in Oracle Cloud Infrastructure Metering Computation service.
+
+        Returns usage carbon emission for the given account.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_oci as oci
+
+        test_usage_carbon_emission = oci.metering_computation.UsageCarbonEmission("testUsageCarbonEmission",
+            tenant_id=oci_metering_computation_tenant["test_tenant"]["id"],
+            time_usage_ended=var["usage_carbon_emission_time_usage_ended"],
+            time_usage_started=var["usage_carbon_emission_time_usage_started"],
+            compartment_depth=var["usage_carbon_emission_compartment_depth"],
+            group_bies=var["usage_carbon_emission_group_by"],
+            group_by_tags=[oci.metering_computation.UsageCarbonEmissionGroupByTagArgs(
+                key=var["usage_carbon_emission_group_by_tag_key"],
+                namespace=var["usage_carbon_emission_group_by_tag_namespace"],
+                value=var["usage_carbon_emission_group_by_tag_value"],
+            )],
+            is_aggregate_by_time=var["usage_carbon_emission_is_aggregate_by_time"],
+            usage_carbon_emission_filter=var["usage_carbon_emission_usage_carbon_emission_filter"])
+        ```
+
+        ## Import
+
+        UsageCarbonEmissions can be imported using the `id`, e.g.
+
+        ```sh
+         $ pulumi import oci:MeteringComputation/usageCarbonEmission:UsageCarbonEmission test_usage_carbon_emission "id"
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[int] compartment_depth: The compartment depth level.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] group_bies: Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionGroupByTagArgs']]]] group_by_tags: GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        :param pulumi.Input[bool] is_aggregate_by_time: Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        :param pulumi.Input[str] tenant_id: Tenant ID.
+        :param pulumi.Input[str] time_usage_ended: The usage end time.
+        :param pulumi.Input[str] time_usage_started: The usage start time.
+        :param pulumi.Input[str] usage_carbon_emission_filter: The filter object for query usage.
+               
+               
+               ** IMPORTANT **
+               Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        ...
+    @overload
+    def __init__(__self__,
+                 resource_name: str,
+                 args: UsageCarbonEmissionArgs,
+                 opts: Optional[pulumi.ResourceOptions] = None):
+        """
+        This resource provides the Usage Carbon Emission resource in Oracle Cloud Infrastructure Metering Computation service.
+
+        Returns usage carbon emission for the given account.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_oci as oci
+
+        test_usage_carbon_emission = oci.metering_computation.UsageCarbonEmission("testUsageCarbonEmission",
+            tenant_id=oci_metering_computation_tenant["test_tenant"]["id"],
+            time_usage_ended=var["usage_carbon_emission_time_usage_ended"],
+            time_usage_started=var["usage_carbon_emission_time_usage_started"],
+            compartment_depth=var["usage_carbon_emission_compartment_depth"],
+            group_bies=var["usage_carbon_emission_group_by"],
+            group_by_tags=[oci.metering_computation.UsageCarbonEmissionGroupByTagArgs(
+                key=var["usage_carbon_emission_group_by_tag_key"],
+                namespace=var["usage_carbon_emission_group_by_tag_namespace"],
+                value=var["usage_carbon_emission_group_by_tag_value"],
+            )],
+            is_aggregate_by_time=var["usage_carbon_emission_is_aggregate_by_time"],
+            usage_carbon_emission_filter=var["usage_carbon_emission_usage_carbon_emission_filter"])
+        ```
+
+        ## Import
+
+        UsageCarbonEmissions can be imported using the `id`, e.g.
+
+        ```sh
+         $ pulumi import oci:MeteringComputation/usageCarbonEmission:UsageCarbonEmission test_usage_carbon_emission "id"
+        ```
+
+        :param str resource_name: The name of the resource.
+        :param UsageCarbonEmissionArgs args: The arguments to use to populate this resource's properties.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        """
+        ...
+    def __init__(__self__, resource_name: str, *args, **kwargs):
+        resource_args, opts = _utilities.get_resource_args_opts(UsageCarbonEmissionArgs, pulumi.ResourceOptions, *args, **kwargs)
+        if resource_args is not None:
+            __self__._internal_init(resource_name, opts, **resource_args.__dict__)
+        else:
+            __self__._internal_init(resource_name, *args, **kwargs)
+
+    def _internal_init(__self__,
+                 resource_name: str,
+                 opts: Optional[pulumi.ResourceOptions] = None,
+                 compartment_depth: Optional[pulumi.Input[int]] = None,
+                 group_bies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+                 group_by_tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionGroupByTagArgs']]]]] = None,
+                 is_aggregate_by_time: Optional[pulumi.Input[bool]] = None,
+                 tenant_id: Optional[pulumi.Input[str]] = None,
+                 time_usage_ended: Optional[pulumi.Input[str]] = None,
+                 time_usage_started: Optional[pulumi.Input[str]] = None,
+                 usage_carbon_emission_filter: Optional[pulumi.Input[str]] = None,
+                 __props__=None):
+        opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
+        if not isinstance(opts, pulumi.ResourceOptions):
+            raise TypeError('Expected resource options to be a ResourceOptions instance')
+        if opts.id is None:
+            if __props__ is not None:
+                raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
+            __props__ = UsageCarbonEmissionArgs.__new__(UsageCarbonEmissionArgs)
+
+            __props__.__dict__["compartment_depth"] = compartment_depth
+            __props__.__dict__["group_bies"] = group_bies
+            __props__.__dict__["group_by_tags"] = group_by_tags
+            __props__.__dict__["is_aggregate_by_time"] = is_aggregate_by_time
+            if tenant_id is None and not opts.urn:
+                raise TypeError("Missing required property 'tenant_id'")
+            __props__.__dict__["tenant_id"] = tenant_id
+            if time_usage_ended is None and not opts.urn:
+                raise TypeError("Missing required property 'time_usage_ended'")
+            __props__.__dict__["time_usage_ended"] = time_usage_ended
+            if time_usage_started is None and not opts.urn:
+                raise TypeError("Missing required property 'time_usage_started'")
+            __props__.__dict__["time_usage_started"] = time_usage_started
+            __props__.__dict__["usage_carbon_emission_filter"] = usage_carbon_emission_filter
+            __props__.__dict__["items"] = None
+        super(UsageCarbonEmission, __self__).__init__(
+            'oci:MeteringComputation/usageCarbonEmission:UsageCarbonEmission',
+            resource_name,
+            __props__,
+            opts)
+
+    @staticmethod
+    def get(resource_name: str,
+            id: pulumi.Input[str],
+            opts: Optional[pulumi.ResourceOptions] = None,
+            compartment_depth: Optional[pulumi.Input[int]] = None,
+            group_bies: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
+            group_by_tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionGroupByTagArgs']]]]] = None,
+            is_aggregate_by_time: Optional[pulumi.Input[bool]] = None,
+            items: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionItemArgs']]]]] = None,
+            tenant_id: Optional[pulumi.Input[str]] = None,
+            time_usage_ended: Optional[pulumi.Input[str]] = None,
+            time_usage_started: Optional[pulumi.Input[str]] = None,
+            usage_carbon_emission_filter: Optional[pulumi.Input[str]] = None) -> 'UsageCarbonEmission':
+        """
+        Get an existing UsageCarbonEmission resource's state with the given name, id, and optional extra
+        properties used to qualify the lookup.
+
+        :param str resource_name: The unique name of the resulting resource.
+        :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
+        :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[int] compartment_depth: The compartment depth level.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] group_bies: Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionGroupByTagArgs']]]] group_by_tags: GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        :param pulumi.Input[bool] is_aggregate_by_time: Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['UsageCarbonEmissionItemArgs']]]] items: A list of usage carbon emission items.
+        :param pulumi.Input[str] tenant_id: Tenant ID.
+        :param pulumi.Input[str] time_usage_ended: The usage end time.
+        :param pulumi.Input[str] time_usage_started: The usage start time.
+        :param pulumi.Input[str] usage_carbon_emission_filter: The filter object for query usage.
+               
+               
+               ** IMPORTANT **
+               Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
+
+        __props__ = _UsageCarbonEmissionState.__new__(_UsageCarbonEmissionState)
+
+        __props__.__dict__["compartment_depth"] = compartment_depth
+        __props__.__dict__["group_bies"] = group_bies
+        __props__.__dict__["group_by_tags"] = group_by_tags
+        __props__.__dict__["is_aggregate_by_time"] = is_aggregate_by_time
+        __props__.__dict__["items"] = items
+        __props__.__dict__["tenant_id"] = tenant_id
+        __props__.__dict__["time_usage_ended"] = time_usage_ended
+        __props__.__dict__["time_usage_started"] = time_usage_started
+        __props__.__dict__["usage_carbon_emission_filter"] = usage_carbon_emission_filter
+        return UsageCarbonEmission(resource_name, opts=opts, __props__=__props__)
+
+    @property
+    @pulumi.getter(name="compartmentDepth")
+    def compartment_depth(self) -> pulumi.Output[int]:
+        """
+        The compartment depth level.
+        """
+        return pulumi.get(self, "compartment_depth")
+
+    @property
+    @pulumi.getter(name="groupBies")
+    def group_bies(self) -> pulumi.Output[Sequence[str]]:
+        """
+        Aggregate the result by. For example: `["tagNamespace", "tagKey", "tagValue", "service", "skuName", "skuPartNumber", "unit", "compartmentName", "compartmentPath", "compartmentId", "platform", "region", "logicalAd", "resourceId", "resourceName", "tenantId", "tenantName", "subscriptionId"]`
+        """
+        return pulumi.get(self, "group_bies")
+
+    @property
+    @pulumi.getter(name="groupByTags")
+    def group_by_tags(self) -> pulumi.Output[Sequence['outputs.UsageCarbonEmissionGroupByTag']]:
+        """
+        GroupBy a specific tagKey. Provide the tagNamespace and tagKey in the tag object. Only supports one tag in the list. For example: `[{"namespace":"oracle", "key":"createdBy"]`
+        """
+        return pulumi.get(self, "group_by_tags")
+
+    @property
+    @pulumi.getter(name="isAggregateByTime")
+    def is_aggregate_by_time(self) -> pulumi.Output[bool]:
+        """
+        Specifies whether aggregated by time. If isAggregateByTime is true, all usage carbon emissions over the query time period will be added up.
+        """
+        return pulumi.get(self, "is_aggregate_by_time")
+
+    @property
+    @pulumi.getter
+    def items(self) -> pulumi.Output[Sequence['outputs.UsageCarbonEmissionItem']]:
+        """
+        A list of usage carbon emission items.
+        """
+        return pulumi.get(self, "items")
+
+    @property
+    @pulumi.getter(name="tenantId")
+    def tenant_id(self) -> pulumi.Output[str]:
+        """
+        Tenant ID.
+        """
+        return pulumi.get(self, "tenant_id")
+
+    @property
+    @pulumi.getter(name="timeUsageEnded")
+    def time_usage_ended(self) -> pulumi.Output[str]:
+        """
+        The usage end time.
+        """
+        return pulumi.get(self, "time_usage_ended")
+
+    @property
+    @pulumi.getter(name="timeUsageStarted")
+    def time_usage_started(self) -> pulumi.Output[str]:
+        """
+        The usage start time.
+        """
+        return pulumi.get(self, "time_usage_started")
+
+    @property
+    @pulumi.getter(name="usageCarbonEmissionFilter")
+    def usage_carbon_emission_filter(self) -> pulumi.Output[str]:
+        """
+        The filter object for query usage.
+
+
+        ** IMPORTANT **
+        Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
+        """
+        return pulumi.get(self, "usage_carbon_emission_filter")
+